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 指定包含要使用的运行时的目录。如果未指定，则使用 ADL 程序所在的相同 SDK 中的运行时目录。如果将 ADL 移到其 SDK 文件夹以外，则必须指定运行时目录。在 Windows 和 Linux 中，指定包含 Adobe AIR 目录的目录。在 Mac OS X 中，指定包含 Adobe AIR.framework 的目录。

-pubid publisher-id 分配指定值作为 AIR 应用程序的发行商 ID，以便完成此运行。通过指定临时的发行商 ID，您可以使用该发行商 ID 帮助唯一标识 AIR 应用程序，进而测试该应用程序的功能，例如通过本地连接进行通信。从 AIR 1.5.3 开始，还可以在应用程序描述符文件中指定发行商 ID（不应使用此参数）。

-nodebug 关闭调试支持。如果使用此参数，应用程序进程则无法连接到 Flash Debugger，并禁止显示未处理异常对话框。（但是，trace 语句仍将输出到控制台窗口。）关闭调试可以使应用程序的运行速度略有提高，并可以更准确地模拟已安装的应用程序的执行模式。

- atlogin 在登录时模拟启动应用程序。此标志允许您测试应用程序逻辑是否仅在将应用程序设置为在用户登录时启动才可执行。使用 -atlogin 时，调度到应用程序的 InvokeEvent 对象的 reason 属性将是 login ，而非 standard （除非应用程序正在运行）。

-profile profileName ADL 使用指定的配置文件对应用程序进行调试。 profileName 可以是以下值之一：

• 桌面

• extendedDesktop

• mobileDevice

如果应用程序描述符包括 supportedProfiles 元素，则使用 -profile 指定的配置文件必须是受支持列表的成员。如果未使用 -profile 标记，则应用程序描述符中的第一个配置文件将用作活动配置文件。如果应用程序描述符不包括 supportedProfiles 元素，并且您未使用 -profile 标记，则会使用 桌面 配置文件。

有关详细信息，请参阅 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 输出的退出代码：