AIR Debug Launcher (ADL)

Använd följande mönster när du kör ett program med ADL:

adl application.xml

Här är application.xml programbeskrivningsfilen för det aktuella programmet.

Den fullständiga syntaxen för ADL är:

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

(Objekt inom hakparenteser, [], är valfria.)

-runtime körningsbibliotek Anger katalogen som innehåller den körningsmiljö som ska användas. Om ingen anges används körningskatalogen som finns i samma SDK som ADL-programmet. Du måste ange körningskatalogen om du flyttar ADL bort från dess SDK-mapp. I Windows och Linux anger du katalogen som innehåller Adobe AIR -katalogen. I Mac OS X anger du katalogen som innehåller Adobe AIR.framework .

-pubid publisher-id Tilldelar det angivna värdet som utgivar-ID för AIR-programmet för den här körningen. Om du anger ett tillfälligt utgivar-ID kan du testa funktionerna i ett AIR-program, till exempel kommunicera via en lokal anslutning, som använder utgivar-ID:t för att unikt identifiera ett program. Från och med AIR 1.5.3 kan du även ange utgivar-ID i programbeskrivningsfilen (och bör inte använda den här parametern).

-nodebug Stänger av felsökningsstödet. Om detta används kan programprocessen inte ansluta till Flash-felsökaren och dialogrutor för ohanterade undantag undertrycks. (Trace-programsatserna skrivs emellertid fortfarande till konsolfönstret.) Om du stänger av felsökningen kan programmet köra lite snabbare och också bättre emulera körningsläget för ett installerat program.

- atlogin Simulerar programstart vid inloggning. Med den här flaggan kan du testa programlogik som bara körs när ett program är inställt på att startas när användaren loggar in. När du använder -atlogin kommer den reason -egenskap för InvokeEvent-objektet som skickas till programmet att vara login i stället för standard (om inte programmet redan är igång).

-profile profileName Den angivna profilen används i ADL för att felsöka programmet. profileName kan vara något av följande värden:

• desktop

• extendedDesktop

• mobileDevice

Om programbeskrivningen innehåller ett supportedProfiles -element måste den profil du anger med -profile vara medlem i den lista som stöds. Om du inte använder flaggan -profile används den första profilen i programbeskrivningsfilen som aktiv profil. Om programbeskrivningen inte innehåller supportedProfiles -elementet, och du inte använder flaggan -profile , används profilen desktop .

Du hittar mer information i avsnitten supportedProfiles och Enhetsprofiler .

-screensize värde Den simulerade skärmstorlek som ska användas när program körs i profilen mobileDevice på skrivbordet. Ange skärmstorleken som en fördefinierad skärmtyp eller som den normala breddens och höjdens pixelmått för stående layout, plus helskärmsbildens bredd och höjd. Använd en av följande fördefinierade skärmtyper för att ange värdet efter typ:

Använd följande format om du vill ange skärmens pixelmått direkt:

widthXheight:fullscreenWidthXfullscreenHeight

Ange alltid pixeldimensioner för stående layout, d.v.s. ange bredden som ett värde som är mindre än höjden. Du kan till exempel ange NexusOne-skärmen med:

-screensize 480x762:480x800

-extdir extension-directory Den katalog i vilken körningsmiljön ska söka efter ANE-tillägg. Katalogen innehåller en underkatalog för varje ANE-tillägg som används i programmet. Var och en av dessa underkataloger innehåller den opaketerade ANE-filen för ett tillägg. Till exempel:

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 
    

Tänk på följande när du använder parametern -extdir:

application.xml Programbeskrivningsfilen. Läs mer i AIR-programbeskrivningsfiler . Programbeskrivningsfilen är den enda parametern som krävs för ADL och i de flesta fall även den enda parametern som krävs.

root-directory Anger rotkatalogen för programmet som ska köras. Om ingen anges används katalogen som innehåller programbeskrivningsfilen.

-- arguments Den teckensträng som visas efter "--" skickas till programmet som kommandoradsargument.

Köra ett program i aktuell katalog:

adl myApp-app.xml

Köra ett program i en underkatalog till den aktuella katalogen:

adl source/myApp-app.xml release

Kör ett program och skicka två kommandoradsargument, "tick" och "tock":

adl myApp-app.xml -- tick tock

Köra ett program med hjälp av en viss körningsversion:

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

Köra ett program utan felsökningsstöd:

adl -nodebug myApp-app.xml

Köra ett program med profilen för mobilenheter och simulera NexusOne-skärmstorlek:

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

Köra ett program med Apache Ant (sökvägarna i exemplet gäller 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>

I tabellen nedan beskrivs de avslutningskoder som skrivs ut av ADL: