AIR Debug Launcher (ADL)

Para executar um aplicativo com o ADL, use o seguinte padrão:

adl application.xml

Em que application.xml é o arquivo do descritor do aplicativo para o aplicativo.

A sintaxe completa para o ADL é:

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

(Itens entre colchetes, [], são opcionais.)

-runtime runtime-directory Especifica o diretório que contém o runtime a ser usado. Se não especificado, o diretório do runtime no mesmo SDK do programa ADL é usado. Se você mover o ADL para fora da pasta SDK, especifique o diretório de runtime. No Windows e no Linux, especifique o diretório que contém o diretório do Adobe AIR . No Mac OS X, especifique o diretório que contém a estrutura do Adobe AIR.

-pubid publisher-id Atribui o valor especificado como o ID do editor do aplicativo do AIR para essa execução. Especificar um ID de editor temporária permite que você teste recursos de um aplicativo do AIR, como comunicação por uma conexão local, que usa o ID do editor para ajudar a identificar unicamente um aplicativo. A partir do AIR 1.5.3, você também pode especificar o ID do editor no arquivo descritor do aplicativo (e não deve utilizar este parâmetro).

-nodebug Desativa o suporte para depuração. Se usado, o processo de aplicativo não poderá se conectar ao depurador do Flash e as caixas de diálogo para exceções não manipuladas são suprimidas. (No entanto, instruções de rastreamento ainda serão impressas na janela do console.) Desativar a depuração permite que o seu aplicativo seja executado um pouco mais rapidamente e também emula mais rigorosamente o modo de execução de um aplicativo instalado.

-atlogin Simula a execução do aplicativo no login. Esta flag permite testar a lógica do aplicativo executada somente quando o aplicativo está configurado para iniciar no login do usuário. Quando -atlogin é utilizado, a propriedade reason do objeto InvokeEvent enviado para o aplicativo será login, em vez de standard (a não ser que o aplicativo já esteja sendo executado).

-profile profileName O ADL depura o aplicativo utilizando o perfil especificado. O profileName pode ser um dos seguintes valores:

• desktop

• extendedDesktop

• mobileDevice

Se o descritor do aplicativo inclui um elemento supportedProfiles, o perfil que você especificar com -profile deve ser um membro da lista de suporte. Se o indicador -profile não for usado, o primeiro perfil no descritor do aplicativo é usado como o perfil ativo. Se o descritor do aplicativo não inclui o elemento supportedProfiles e você não usar o indicador -profile, o perfil desktop é usado.

Para obter mais informações, consulte os perfis supportedProfiles e Perfis de dispositivo.

Valor -screensize O tamanho da tela simulada a ser usada quando aplicativos estiverem rodando no perfil MobileDevice no desktop. Especifique o tamanho da tela como um tipo de tela predefinido ou conforme as dimensões em pixels da largura e altura normais e da largura e da altura do layout retrato, além da largura e da altura da tela cheia. Para especificar o valor por tipo, use um dos seguintes tipos de tela predefinidos:

Para especificar as dimensões de pixels da tela diretamente, utilize o seguinte formato:

widthXheight:fullscreenWidthXfullscreenHeight

Sempre especifique as dimensões de pixel para o layout retrato, o que significa especificar a largura como um valor menor do que o valor da altura. Por exemplo, a tela NexusOne pode ser especificada com:

-screensize 480x762:480x800

-extdir extension-directory O diretório no qual o runtime deve buscar extensões nativas. O diretório contém um subdiretório para cada extensão nativa que o aplicativo utilizar. Cada um desses subdiretórios contém o arquivo ANE desempacotado de uma extensão. Por exemplo:

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 
    

Ao utilizar o parâmetro -extdir, considere o seguinte:

application.xml O arquivo do descritor do aplicativo. Consulte Arquivos descritores do aplicativo do AIR. O descritor do aplicativo é o único parâmetro exigido pelo ADL e, na maioria dos casos, o único parâmetro necessário.

root-directory Especifica o diretório raiz do aplicativo a ser executado. Se não especificado, o diretório que contém o arquivo do descritor do aplicativo será usado.

-- arguments Qualquer sequência de caracteres que apareça após "--" é transmitida ao aplicativo como argumentos de linha de comando.

Execute um aplicativo no diretório atual:

adl myApp-app.xml

Execute um aplicativo em um subdiretório do diretório atual:

adl source/myApp-app.xml release

Execute um aplicativo e transmita dois argumentos de linha de comando, "tick" e "tock":

adl myApp-app.xml -- tick tock

Execute um aplicativo usando um runtime específico:

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

Execute um aplicativo sem o suporte de depuração:

adl -nodebug myApp-app.xml

Execute um aplicativo no perfil do dispositivo móvel e simular o tamanho da tela do Nexus One:

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

Execute um aplicativo usando Apache Ant para executar o aplicativo (os caminhos mostrados no exemplo são para 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>

A tabela a seguir descreve os códigos de saída impressos pelo ADL: