Работа с отладочными версиями сред выполнения Flash

Flash Player 9 и более поздних версий, Adobe AIR 1.0 и более поздних версий

Компания Adobe обеспечивает разработчиков специальными версиями сред выполнения Flash, которые имеют расширенные функции отладки. Копию отладочной версии Flash Player можно получить при установке Adobe Flash Professional или Adobe Flash Builder. Кроме того, можно получить утилиту для отладки приложений Adobe AIR, которая называется ADL, при установке любого из этих инструментов или в составе пакета Adobe AIR SDK.

Существуют существенные различия в сообщениях об ошибках между отладочными и обычными версиями Flash Player и Adobe AIR. Отладочные версии сообщают тип ошибки (Error, IOError или EOFError), номер ошибки и отображают текстовое сообщение для пользователя. Обычные версии сообщают только тип ошибки и номер ошибки. Например, рассмотрим следующий код:

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

Если в отладочной версии Flash Player метод readBoolean() генерирует ошибку EOFError, в текстовом поле tf отображается следующее сообщение: «EOFError: Error #2030: End of file was encountered.» (Обнаружен конец файла).

Тот же самый код в обычной версии Flash Player или Adobe AIR покажет следующее сообщение: «EOFError: Error #2030.»
Примечание. Проигрыватели отладчика транслируют событие allComplete; избегайте создания пользовательских событий с именем allComplete. В противном случай при отладке может возникать непредсказуемое поведение.

Чтобы сократить ресурсы и размеры обычных версий, текстовые строки в сообщениях об ошибках не отображаются. Используя номер ошибки, в документации можно найти соответствующее сообщение об ошибке (см. cправочник ActionScript® 3.0 для платформы Adobe® Flash® Platform ). Альтернативно можно воспроизвести ошибку, используя отладочные версии Flash Player и AIR, и просмотреть полное сообщение об ошибке.