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).
Nota: a partir de AIR 1.5.3, un ID de editor no se vuelve a calcular ni a asignar automáticamente a una aplicación de AIR. Se puede especificar un ID de editor al crear una actualización en una aplicación de AIR existente, pero las nuevas aplicaciones no necesitan ni deben especificar un ID de editor.
-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:
Tipo de pantalla
|
Normal (anchura x altura)
|
Pantalla completa (anchura x altura)
|
480
|
720 x 480
|
720 x 480
|
720
|
1280 x 720
|
1280 x 720
|
1080
|
1920 x 1080
|
1920 x 1080
|
Droid
|
480 x 816
|
480 x 854
|
FWQVGA
|
240 x 432
|
240 x 432
|
FWVGA
|
480 x 854
|
480 x 854
|
HVGA
|
320 x 480
|
320 x 480
|
iPad
|
768 x 1004
|
768 x 1024
|
iPadRetina
|
1536 x 2008
|
1536 x 2048
|
iPhone
|
320 x 460
|
320 x 480
|
iPhoneRetina
|
640 x 920
|
640 x 960
|
iPhone5Retina
|
640 x 1096
|
640 x 1136
|
iPhone6
|
750 x 1294
|
750 x 1334
|
iPhone6Plus
|
1242 x 2148
|
1242 x 2208
|
iPod
|
320 x 460
|
320 x 480
|
iPodRetina
|
640 x 920
|
640 x 960
|
iPod5Retina
|
640 x 1096
|
640 x 1136
|
NexusOne
|
480 x 762
|
480 x 800
|
QVGA
|
240 x 320
|
240 x 320
|
SamsungGalaxyS
|
480 x 762
|
480 x 800
|
SamsungGalaxyTab
|
600 x 986
|
600 x 1024
|
WQVGA
|
240 x 400
|
240 x 400
|
WVGA
|
480 x 800
|
480 x 800
|
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:
El comando ADL requiere que cada uno de los directorios especificados tenga la extensión de nombre de archivo .ane. No obstante, la parte del nombre de archivo previa al sufijo “.ane” puede ser cualquier nombre de archivo válido. No tiene que coincidir con el valor del elemento extensionID del archivo descriptor de la aplicación.
Puede especificar el parámetro -extdir más de una vez.
El uso del parámetro -extdir es diferente para la herramienta ADT y la herramienta ADL. En ADT, el parámetro especifica un directorio que contiene archivos ANE.
También se puede utilizar la variable de entorno AIR_EXTENSION_PATH para especificar los directorios de extensiones. Consulte Variables del entorno de ADT.
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.
Nota: cuando se intenta iniciar una aplicación de AIR que ya está ejecutándose, no se inicia una nueva instancia de la aplicación, sino que se distribuye un evento invoke a la instancia que está en ejecución.