Отладка приложения AIR для настольной системы

Если приложение создается в интегрированной среде разработки, например Flash Builder, Flash Professional или Dreamweaver, инструменты отладки обычно встроены в среду. Для выполнения отладки достаточно запустить приложение в режиме отладки. Если используется ИСР, которая не поддерживает отладку, можно использовать AIR Debug Launcher (ADL) и Flash Debugger (FDB).

Запуск приложения с помощью ADL

С помощью ADL приложение AIR можно запустить без упаковки и установки. Передайте файл дескриптора приложения в ADL в качестве параметра, как показано в следующем примере (необходимо сначала скомпилировать код ActionScript в приложении):

adl myApplication-app.xml

ADL выводит трассировочные инструкции, исключения среды выполнения и ошибки анализа HTML на экран терминала. Если процесс FDB ожидает входящего подключения, ADL установит соединение с отладчиком.

Для отладки приложения AIR, в котором используются собственные расширения, можно также использовать инструмент ADL. Например:

adl -extdir extensionDirs myApplication-app.xml

Печать трассировочных инструкций

Для печати трассировочных инструкций в консоли, используемой для запуска ADL, добавьте трассировочные инструкции в код с помощью функции trace .

Примечание. Если инструкции trace() не отображаются на консоли, убедитесь, что в файле mm.cfg не задано ErrorReportingEnable или TraceOutputFileEnable . Дополнительные сведения о том, где находится этот файл в зависимости от платформы, см. в документе Редактирование файла mm.cfg .

Пример ActionScript:

//ActionScript 
trace("debug message"); 

Пример JavaScript:

//JavaScript 
air.trace("debug message");
В коде JavaScript можно использовать функции alert() и confirm() для отображения сообщений отладки из своего приложения. Кроме того, в консоль печатаются номера строк с синтаксическими ошибками и все необработанные исключения JavaScript.
Примечание. Чтобы применить префикс air, показанный в примере JavaScript, необходимо импортировать на страницу файл AIRAliases.js. Это файл находится внутри каталога frameworks в пакете AIR SDK.

Подключение к отладчику Flash Debugger (FDB)

Для отладки приложений AIR с помощью Flash Debugger запустите сеанс FDB и затем запустите приложение, используя ADL.

Примечание. В приложениях AIR на основе SWF исходные файлы ActionScript должны быть скомпилированы с флагом -debug . (Во Flash Professional, установите флажок «Разрешить отладку» в диалоговом окне «Параметры публикации».)
  1. Запустите FDB. Программу FDB можно найти в каталоге bin пакета Flex SDK.

    В консоли выводится запрос FDB: <fdb>

  2. Выполните команду run : <fdb>run [Enter]

  3. Запустите отладочную версию приложения в другой командной строке или оболочке:

    adl myApp.xml
  4. С помощью команд FDB задайте контрольные точки.

  5. Введите: continue [Enter]

Если приложение AIR выполнено в виде SWF-файла, то отладчик управляет только выполнением кода ActionScript. Если приложение AIR выполнено в виде HTML-файла, то отладчик управляет только выполнением кода JavaScript.

Чтобы выполнить ADL без подключения к отладчику, включите параметр -nodebug :

adl myApp.xml -nodebug

Чтобы получить краткие сведения о командах FDB, выполните команду help :

<fdb>help [Enter]

Дополнительные сведения о командах FDB см. на странице Использование команд отладчика из командной строки в документации по Adobe Flex.