ADL (AIR Debug Launcher)

Per eseguire un'applicazione mediante ADL, utilizzate lo schema seguente:

adl application.xml

application.xml è il file descrittore dell'applicazione per questa applicazione.

La sintassi completa di ADL è la seguente:

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

(Le voci in parentesi quadre, [], sono opzionali.)

-runtime runtime-directory Specifica la directory contenente il runtime da utilizzare. Se non è specificata, viene utilizzata la directory di runtime nello stesso SDK in cui viene utilizzato il programma ADL. Se spostate ADL fuori dalla relativa cartella SDK, dovete specificare la directory di runtime. In Windows e Linux, specificate la directory contenente la directory Adobe AIR . In Mac OS X, specificate la directory contenente Adobe AIR.framework .

-pubid publisher-id Assegna il valore specificato come ID editore dell'applicazione AIR per questa esecuzione. Specificando un ID editore temporaneo è possibile testare le funzionalità di un'applicazione AIR, ad esempio la comunicazione su una connessione locale, che utilizzano l'ID editore per l'identificazione univoca dell'applicazione. A partire da AIR 1.5.3, potete anche specificare l'ID editore nel file descrittore dell'applicazione (senza usare questo parametro).

-nodebug Disattiva il supporto per il debug. Se utilizzata, il processo dell'applicazione non consente la connessione al debugger Flash e le finestre di dialogo per le eccezioni non gestite vengono eliminate. (Le istruzioni trace vengono comunque stampate nella finestra della console.) La disattivazione del debug consente di eseguire l'applicazione più rapidamente e di emulare più fedelmente la modalità di esecuzione di un'applicazione installata.

- atlogin Simula l'avvio dell'applicazione al login. Questo flag consente di provare la logica dell'applicazione che viene eseguita solo quando un'applicazione è impostata per avviarsi quando l'utente effettua il login. Quando si utilizza -atlogin , la proprietà reason dell'oggetto InvokeEvent inviato all'applicazione sarà login anziché standard (a meno che l'applicazione non sia già in esecuzione).

-profile profileName ADL esegue il debug dell'applicazione utilizzando il profilo specificato. Il dato profileName può essere uno dei seguenti valori:

• desktop

• extendedDesktop

• mobileDevice

Se il descrittore dell'applicazione include un elemento supportedProfiles , il profilo che specificate con -profile deve essere membro dell'elenco di profili supportati. Se il flag -profile non viene utilizzato, il primo profilo nel descrittore dell'applicazione viene utilizzato come profilo attivo. Se il descrittore dell'applicazione non include l'elemento supportedProfiles e non utilizzate il flag -profile , viene usato il profilo desktop .

Per ulteriori informazioni, vedete supportedProfiles e Profili dispositivo .

-screensize valore Il formato schermo simulato da utilizzare per l'esecuzione di applicazioni nel profilo mobileDevice sul desktop. Specificate il formato dello schermo come tipo di schermo predefinito oppure immettendo le dimensioni in pixel della larghezza e altezza normali per il layout verticale, più la larghezza e altezza a schermo intero. Per specificare il valore in base al tipo, utilizzate uno dei seguenti tipi di schermo predefiniti:

Per specificare le dimensioni in pixel dello schermo, utilizzate il formato seguente:

widthXheight:fullscreenWidthXfullscreenHeight

Specificate sempre le dimensioni in pixel per il layout verticale, ovvero specificate una larghezza di valore inferiore a quello dell'altezza. Ad esempio, lo schermo di NexusOne può essere specificato con:

-screensize 480x762:480x800

-extdir extension-directory La directory in cui il runtime deve cercare le estensioni native. La directory contiene una sottodirectory per ciascuna estensione nativa utilizzata dall'applicazione. Ognuna di queste sottodirectory contiene il file ANE spacchettato di un'estensione. Ad esempio:

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 
    

Quando usate il parametro -extdir, prendete in considerazione quanto segue:

application.xml Il file descrittore dell'applicazione. Vedete File descrittori delle applicazioni AIR . Il descrittore dell'applicazione è l'unico parametro richiesto da ADL e, nella maggior parte dei casi, l'unico necessario.

root-directory Specifica la directory principale dell'applicazione da eseguire. Se il valore non viene specificato, si utilizza la directory contenente il file descrittore dell'applicazione.

-- arguments Qualsiasi stringa di caratteri che appare dopo "--" viene trasmessa all'applicazione come argomento della riga di comando.

Eseguire un'applicazione nella directory corrente:

adl myApp-app.xml

Eseguire un'applicazione nella sottodirectory della directory corrente:

adl source/myApp-app.xml release

Eseguire un'applicazione e passare due argomenti della riga di comando, "tick" e "tock":

adl myApp-app.xml -- tick tock

Eseguire un'applicazione utilizzando un runtime specifico:

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

Eseguire un'applicazione senza il supporto del debug:

adl -nodebug myApp-app.xml

Eseguire un'applicazione nel profilo dispositivo mobile e simulare il formato schermo NexusOne:

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

Eseguire un'applicazione utilizzando Apache Ant per l'esecuzione (i percorsi mostrati nell'esempio sono per 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>

Nella tabella seguente vengono descritti i codici di uscita stampati da ADL: