AIR Debug Launcher (ADL)

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

adl application.xml

где application.xml — это файл дескриптора приложения.

Полный синтаксис для ADL имеет следующий вид:

adl     [-runtime runtime-directory] 
    [-pubid publisher-id] 
    [-nodebug] 
    [-atlogin] 
    [-profile profileName] 
    [-screensize value] 
    [-extdir extension-directory] 
    application.xml 
    [root-directory] 
    [-- arguments]

(элементы в квадратных скобках «[ ]» являются необязательными)

-runtime runtime-directory задает каталог, содержащий используемую среду выполнения. Если каталог среды выполнения не указан отдельно, используется каталог из того же комплекта SDK, что и для ADL. Если переместить утилиту ADL из папки ее SDK, необходимо будет задать каталог среды выполнения. В Windows и Linux необходимо задать каталог, содержащий каталог Adobe AIR . В Mac OS X задайте каталог, содержащий Adobe AIR.framework .

-pubid publisher-id присваивает определенное значение в качестве ID издателя приложения AIR для данного запуска. Указание временного ID издателя позволяет протестировать функции приложения AIR (такие как связь по локальной сети), использующие ID издателя для уникального определения приложения. Начиная с версии AIR 1.5.3, можно также указать идентификатор издателя в файле дескриптора приложения (и не использовать этот параметр).

-nodebug отключает поддержку отладки. В этом случае процесс приложения не сможет подключиться к программе отладки Flash, а диалоги, связанные с необработанными исключениями, будут заблокированы. (Несмотря на это трассировочные инструкции по-прежнему печатаются в окне консоли.) Отключение отладки ускоряет работу приложения и более точно эмулирует режим работы установленного приложения.

- atlogin симулирует запуск приложения при входе в систему. Этот флаг позволяет проверять логику приложения, которая выполняется, только когда приложение запускается при входе пользователя в систему. Когда используется -atlogin , свойство reason объекта InvokeEvent, отправляемое приложению, будет иметь значение login вместо standard (если приложение еще не запущено).

-profile profileName — ADL выполняет отладку приложения с помощью указанного профиля. profileName может принимать одно из следующих значений:

• desktop

• extendedDesktop

• mobileDevice

Если в дескриптор приложения включен элемент supportedProfiles , профиль, заданный с помощью аргумента -profile , должен входить в список поддерживаемых элементов. Если аргумент -profile не используется, в качестве активного профиля используется первый профиль из дескриптора приложения. Если элемент supportedProfiles не включен в дескриптор приложения и аргумент -profile не задан, будет использоваться профиль desktop .

Дополнительные сведения см. в разделах « supportedProfiles » и « Профили устройств ».

-screensize value — размер симулированного экрана, используемый при запуске приложений с профилем mobileDevice в настольных системах. Задайте размер экрана как предустановленный тип или укажите обычную ширину и высоту в пикселях для портретной ориентации, а также ширину и высоту для полноэкранного режима. Чтобы указать в виде типа, используйте один из следующих предопределенных типов экрана:

Чтобы задать размер экрана в пикселях, используйте следующий формат:

widthXheight:fullscreenWidthXfullscreenHeight

Всегда указывайте для портретной ориентации размеры в пикселях, задавая для ширины меньшее значение, чем для высоты. Например, размеры экрана для NexusOne можно задать следующим образом:

-screensize 480x762:480x800

-extdir extension-directory Каталог, в котором среда выполнения осуществляет поиск собственных расширений. В каталоге содержится подкаталог для каждого собственного расширения, используемого в приложении. В каждом из этих подкаталогов содержится распакованный ANE-файл расширения. Например:

C:\extensionDirs\ 
    extension1.ane\ 
        META-INF\ 
            ANE\ 
                Android-ARM\ 
                    library.swf 
                    extension1.jar 
                extension.xml 
            signatures.xml 
        catalog.xml 
        library.swf 
        mimetype 
    extension2.ane\ 
        META-INF\ 
            ANE\ 
                Android-ARM\ 
                    library.swf 
                    extension2.jar 
                extension.xml 
            signatures.xml 
        catalog.xml 
        library.swf 
        mimetype 
    

При использовании параметра -extdir учитывайте следующее:

application.xml — это файл дескриптора приложения. См. раздел « Файлы дескриптора приложения AIR ». Дескриптор приложения — это единственный параметр, необходимый ADL и, в большинстве случаев, единственный требуемый параметр.

root-directory задает корневой каталог запускаемого приложения. Если он не задан, используется каталог, в котором находится файл дескриптора.

-- arguments Любые строки символов, стоящие после «--», передаются приложению в качестве аргументов командной строки.

Запуск приложения в текущем каталоге:

adl myApp-app.xml

Запуск приложения в подкаталоге текущего каталога:

adl source/myApp-app.xml release

Запуск приложения и передача двух аргументов командной строки: «tick» и «tock»:

adl myApp-app.xml -- tick tock

Запуск приложения в определенной среде выполнения:

adl -runtime /AIRSDK/runtime myApp-app.xml

Запуск приложения без поддержки отладки:

adl -nodebug myApp-app.xml

Запустите приложение с использованием профиля мобильного устройства и симулируйте размер экрана Nexus One:

adl -profile mobileDevice -screensize NexusOne myMobileApp-app.xml

Запустите приложение с помощью Apache Ant (в примере приведены пути для Windows):

<property name="SDK_HOME" value="C:/AIRSDK"/> 
<property name="ADL" value="${SDK_HOME}/bin/adl.exe"/> 
<property name="APP_ROOT" value="c:/dev/MyApp/bin-debug"/> 
<property name="APP_DESCRIPTOR" value="${APP_ROOT}/myApp-app.xml"/> 
 
<target name="test"> 
    <exec executable="${ADL}"> 
        <arg value="${APP_DESCRIPTOR}"/> 
        <arg value="${APP_ROOT}"/> 
    </exec>  
</target>

Ниже перечислены коды выхода, выводимые ADL.