Praca z wersjami środowisk wykonawczych Flash wyposażonych w debuger

Flash Player 9 i nowsze wersje, Adobe AIR 1.0 i nowsze wersje

Firma Adobe zapewnia programistom specjalne wersje środowisk wykonawczych ułatwiające czynności związane z debugowaniem. Kopię programu Flash Player w wersji z debugerem można uzyskać podczas instalacji aplikacji Adobe Flash Professional lub Adobe Flash Builder. Narzędzie do debugowania aplikacji środowiska Adobe AIR, która nosi również nazwę ADL, można uzyskać podczas instalowania dowolnego z tych narzędzi lub jako część pakietu Adobe AIR SDK.

Istnieje zauważalna różnica w sposobie wskazywania błędów między wersjami z debugerem a standardowymi wersjami programu Flash Player i środowiska Adobe AIR. W wersjach z debugerem wyświetlane są typy błędów (np. ogólny Error, IOError lub EOFError), numer błędu oraz komunikat o błędzie, który w łatwy sposób możne zostać odczytany i zrozumiany przez człowieka. W wersjach sztandarowych wyświetlany jest tylko typ błędu i jego numer. Weźmy na przykład pod uwagę następujący kod:

try 
{ 
    tf.text = myByteArray.readBoolean(); 
} 
catch (error:EOFError) 
{ 
    tf.text = error.toString(); 
}

Jeśli metoda readBoolean() wygeneruje błąd typu EOFError w programie Flash Player w wersji z debugerem, w polu tekstowym tf zostanie wyświetlony następujący komunikat: „EOFError: Error #2030: Napotkano koniec pliku.”

Ten sam kod w standardowej wersji programu Flash Player lub środowiska Adobe AIR wyświetli następujący tekst: „EOFError: Error #2030.”

Uwaga: Odtwarzacze debugera rozgłaszają zdarzenie o nazwie „allComplete”; należy unikać tworzenia niestandardowych zdarzeń o nazwie „allComplete”. W przeciwnym wypadku można napotkać na nieprzewidziane działanie podczas debugowania.

Aby zachować zasoby i zminimalizować rozmiar w wersjach standardowych, ciągi komunikatów o błędach nie są wyświetlane. Numer błędu można odszukać w dokumentacji (w dodatkach do Skorowidza języka ActionScript 3.0 dla platformy Adobe Flash) w celu skorelowania z komunikatem o błędzie. Można również odtworzyć błąd za pomocą programem Flash Player i środowiskiem AIR w wersji debugera, aby zobaczyć pełny komunikat.