AIR Debug Launcher (ADL)

Verwenden Sie das folgende Muster zum Ausführen einer Anwendung mit ADL:

adl application.xml

Dabei ist application.xml die Anwendungsdeskriptordatei für die Anwendung.

Die vollständige ADL-Syntax lautet:

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

(Elemente in eckigen Klammern, [], sind optional.)

-runtime runtime-directory Gibt das Verzeichnis mit der zu verwendenden Laufzeitumgebung an. Wenn nicht anders angegeben, wird das Laufzeitverzeichnis im selben SDK wie die ADL verwendet. Wenn Sie ADL aus dem SDK-Ordner verschieben, müssen Sie das Laufzeitverzeichnis angeben. Geben Sie unter Windows und Linux das Verzeichnis an, das das Verzeichnis Adobe AIR enthält. Geben Sie unter Mac OS X das Verzeichnis an, das das Verzeichnis Adobe AIR.framework enthält.

-pubid publisher-id Weist für diese Ausführung den angegebenen Wert als Herausgeber-ID der AIR-Anwendung zu. Durch die Angabe einer temporären Herausgeber-ID können Sie die Funktionen einer AIR-Anwendung testen, zum Beispiel die Kommunikation über eine lokale Verbindung, die die Herausgeber-ID verwendet, um die Anwendung eindeutig zu identifizieren. Ab der Version AIR 1.5.3 können Sie die Herausgeber-ID auch in der Anwendungsdeskriptordatei angeben (und sollten diesen Parameter dann nicht verwenden).

-nodebug Schaltet die Debugging-Unterstützung aus. Der Anwendungsprozess kann keine Verbindung zum Flash Debugger herstellen und die Dialoge für nicht verarbeitete Ausnahmen werden unterdrückt. (Die trace-Anweisungen werden jedoch immer noch im Konsolenfenster ausgegeben.) Durch das Ausschalten der Debugging-Funktion läuft Ihre Anwendung etwas schneller und ahmt den Ausführungsmodus einer installierten Anwendung genauer nach.

- atlogin Simuliert das Starten der Anwendung beim Anmelden. Dieser Kennzeichner ermöglicht Ihnen das Testen von Anwendungslogiken, die nur ausgeführt werden, wenn die Anwendung so konfiguriert ist, dass sie beim Anmelden des Benutzers gestartet wird. Wenn Sie -atlogin verwenden, hat die reason -Eigenschaft des InvokeEvent-Objekts, das an die Anwendung abgesetzt wird, den Wert login anstatt standard (sofern die Anwendung nicht bereits ausgeführt wird).

-profile profileName ADL verwendet zum Debuggen der Anwendung das angegebene Profil. profileName kann einen der folgenden Werte annehmen:

• desktop

• extendedDesktop

• mobileDevice

Wenn der Anwendungsdeskriptor ein supportedProfiles -Element enthält, muss das Profil, das Sie mit -profile angegeben, ein Mitglied der unterstützten Liste sein. Wenn der -profile -Kennzeichner nicht verwendet wird, wird das erste Profil im Anwendungsdeskriptor als aktives Profil verwendet. Wenn der Anwendungsdeskriptor das supportedProfiles -Element nicht enthält und Sie nicht den -profile -Kennzeichner verwenden, wird das desktop -Profil verwendet.

Weitere Informationen finden Sie unter supportedProfiles und Geräteprofile .

-screensize Wert Die simulierte Bildschirmgröße, die verwendet wird, wenn Anwendungen im mobileDevice-Profil auf dem Desktop ausgeführt werden. Geben Sie die Bildschirmgröße als vordefinierten Bildschirmtyp an oder als die Pixelabmessungen der normalen Breite und Höhe des Hochformatlayouts plus Breite und Höhe des Vollbilds. Um den Wert durch den Typ anzugben, verwenden Sie einen der folgenden vordefinierten Bildschirmtypen:

Um die Pixelabmessungen des Bildschirms direkt anzugeben, verwenden Sie das folgende Format:

widthXheight:fullscreenWidthXfullscreenHeight

Geben Sie immer die Pixelabmessungen für das Hochformatlayout an, d. h. geben Sie für die Breite einen kleineren Wert als für die Höhe ein. Der NexusOne-Bildschirm kann zum Beispiel folgendermaßen angegeben werden:

-screensize 480x762:480x800

-extdir extension-directory Das Verzeichnis, in dem die Laufzeitumgebung nach nativen Erweiterungen suchen soll. Der Ordner enthält einen Unterordner für jede native Erweiterung, die die Anwendung verwendet. Jeder dieser Unterordner enthält die unverpackte ANE-Datei einer Erweiterung. Zum Beispiel:

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 
    

Wenn Sie den -extdir-Parameter verwenden, bedenken Sie Folgendes:

application.xml Die Anwendungsdeskriptordatei. Siehe AIR-Anwendungsdeskriptordateien . Der Anwendungsdeskriptor ist der einzige Parameter, der von ADL benötigt wird, und in den meisten Fällen der einzige erforderliche Parameter.

root-directory Gibt das Stammverzeichnis der auszuführenden Anwendung an. Wird das Stammverzeichnis nicht angegeben, wird das Verzeichnis verwendet, in dem sich die Anwendungsdeskriptordatei befindet.

-- arguments Alle Zeichenketten nach „--“ werden als Befehlszeilenargumente an die Anwendung übergeben.

Ausführung einer Anwendung im aktuellen Verzeichnis:

adl myApp-app.xml

Ausführung einer Anwendung in einem Unterverzeichnis des aktuellen Verzeichnisses:

adl source/myApp-app.xml release

Ausführung einer Anwendung und Übergabe der Befehlszeilenargumente „tick“ und „tock“:

adl myApp-app.xml -- tick tock

Ausführung einer Anwendung mit einer bestimmten Laufzeit:

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

Ausführen einer Anwendung ohne Debugging-Unterstützung:

adl -nodebug myApp-app.xml

Führen Sie eine Anwendung im mobilen Geräteprofil aus und simulieren Sie die Bildschirmgröße des Nexus One:

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

Führen Sie eine Anwendung unter Verwendung von Apache Ant aus (die im Beispiel verwendeten Pfade sind für 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>

Die folgende Tabelle enthält die von ADL ausgegebenen Exit-Codes: