AIR Debug Launcher (ADL)

Para ejecutar una aplicación con ADL, utilice el siguiente patrón:

adl application.xml

application.xml es el archivo descriptor de la aplicación para esta.

La sintaxis completa para ADL es la siguiente:

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

(Los elementos entre paréntesis, [], son opcionales.)

-runtime runtime-directory Especifica el directorio que contiene el motor de ejecución a utilizar. Si no se especifica, se utiliza el directorio del motor de ejecución del mismo SDK que el programa ADL. Si ADL se mueve fuera su carpeta en SDK, especifique el directorio del motor de ejecución. En Windows y Linux, especifique el directorio que contiene el directorio Adobe AIR. En Mac OS X, especifique el directorio que contiene Adobe AIR.framework.

-pubid publisher-id Asigna el valor especificado como ID del editor de la aplicación de AIR para esta ejecución. La especificación de un ID de editor temporal permite ensayar las funciones de una aplicación de AIR, como la comunicación a través de una conexión local, que utilizan el ID del editor para ayudar a identificar una aplicación con exclusividad. A partir de AIR 1.5.3, también se puede especificar el ID de editor en el archivo descriptor de la aplicación (y no se debe utilizar este parámetro).

-nodebug Desactiva la compatibilidad con la depuración. Si se utiliza, el proceso de la aplicación no podrá conectar con el depurador de Flash y se suprimen los cuadros de diálogo para excepciones no controladas. (Sin embargo, las sentencias trace continúan imprimiéndose en la ventana de la consola.) Si desactivamos la depuración, el funcionamiento de la aplicación se agilizará y el modo de ejecución será más similar al de una aplicación instalada.

-atlogin Simula el inicio de la aplicación al iniciar la sesión. Este indicador permite probar la lógica de la aplicación que solo se ejecuta cuando una aplicación se establece para iniciarse cuando el usuario inicia la sesión. Cuando se utiliza -atlogin, la propiedad reason del objeto InvokeEvent distribuido en la aplicación será login en lugar de standard (a menos que la aplicación ya se esté ejecutando).

-profile profileName ADL depura la aplicación utilizando el perfil especificado. profileName puede ser cualquiera de los valores siguientes:

• desktop

• extendedDesktop

• mobileDevice

Si el descriptor de la aplicación incluye un elemento supportedProfiles, el perfil especificado con -profile debe ser un miembro de la lista admitida. Si no se utiliza el indicador -profile, el primer perfil del descriptor de la aplicación se utiliza como el perfil activo. Si el descriptor de la aplicación no incluye el elemento supportedProfiles y no se utiliza el indicador -profile, se utiliza el perfil desktop.

Para obtener más información, consulte supportedProfiles y Perfiles de dispositivo.

Valor -screensize Tamaño de la pantalla simulado para utilizar cuando se ejecutan aplicaciones en el perfil mobileDevice en el escritorio. Especifique el tamaño de la pantalla como tipo predefinido de pantalla o como las dimensiones de píxel de la anchura y altura normal de la visualización horizontal, más la anchura y altura de la pantalla completa. Para especificar el valor por tipo, utilice uno de los siguientes tipos de pantalla predefinidos:

Para especificar las dimensiones de píxel de la pantalla directamente, utilice el siguiente formato:

widthXheight:fullscreenWidthXfullscreenHeight

Especifique siempre las dimensiones de píxel de la visualización horizontal, esto es, especifique la anchura como un valor más pequeño que el valor de la altura. Por ejemplo, la pantalla NexusOne se puede especificar con:

-screensize 480x762:480x800

-extdir extension-directory Directorio en el que el motor de ejecución debe buscar extensiones nativas. El directorio contiene un subdirectorio para cada extensión nativa que utiliza la aplicación. Cada uno de estos subdirectorios contienen el archivo ANE unpackaged de una extensión. Por ejemplo:

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 
    

Cuando utilice el parámetro -extdir, tenga en cuenta lo siguiente:

application.xml Archivo descriptor de la aplicación. Consulte Archivos descriptores de las aplicaciones de AIR. El descriptor de la aplicación es el único parámetro que requiere ADL y, en la mayoría de los casos, el único parámetro necesario.

root-directory Especifica el directorio raíz de la aplicación a ejecutar. Si no se especifica, se utilizará el directorio que contiene el archivo descriptor de la aplicación.

-- arguments Las cadenas de caracteres que aparezcan después de "--" se pasan a la aplicación como argumentos de la línea de comandos.

Ejecute una aplicación del directorio actual:

adl myApp-app.xml

Ejecute una aplicación de un subdirectorio del directorio actual:

adl source/myApp-app.xml release

Ejecute una aplicación y pase dos argumentos de la línea de comandos, "tick" y "tock":

adl myApp-app.xml -- tick tock

Ejecute una aplicación con un motor de ejecución específico:

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

Ejecute una aplicación sin compatibilidad de depuración:

adl -nodebug myApp-app.xml

Ejecute una aplicación en el perfil de dispositivo móvil y simule el tamaño de pantalla Nexus One:

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

Ejecute una aplicación utilizando Apache Ant para ejecutar la aplicación (las rutas mostradas en el ejemplo son 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>

En el cuadro siguiente se describen los códigos de error o de salida que imprime ADL: