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 可以讓您測試 AIR 應用程式的功能 (例如經由本機連線來通訊)，這些功能會使用發行者 ID 協助唯一識別應用程式。至於 AIR 1.5.3，您也可以在應用程式描述器檔案中指定發行者 ID (而且不應該使用這個參數)。

-nodebug ：關閉除錯支援功能。如果有使用這項功能，應用程式程序便無法連接至 Flash 除錯程式，而且未處理例外的對話方塊便不會顯示 (不過，追蹤陳述式還是會列印至主控台視窗)。關閉除錯功能可以稍微提高應用程式的執行速度，也能更準確地模擬所安裝應用程式的執行模式。

- atlogin ：模擬登入時啟動應用程式。此旗標可讓您測試應用程式邏輯，查看此邏輯是否只有在將應用程式設為在使用者登入時啟動才會執行。使用 -atlogin 時，傳送到應用程式之 InvokeEvent 物件的 reason 屬性將為 login ，而非 standard (除非應用程式已在執行中)。

-profile profileName ：ADL 會使用指定的描述檔對應用程式進行除錯。 profileName 可以是下列其中一個值：

• desktop

• extendedDesktop

• mobileDevice

如果應用程式描述器包含 supportedProfiles 元素，則使用 -profile 指定的描述檔必須是支援清單的成員。如果未使用 -profile 旗標，將使用應用程式描述器中第一個描述檔做為作用中描述檔。如果應用程式描述器未包含 supportedProfiles 元素且未使用 -profile 旗標，則使用 desktop 描述檔。

如需詳細資訊，請參閱 supportedProfiles 和 裝置描述檔 。

-screensize 值 在桌上型中以 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 列印的結束代碼：