Application de débogage du lanceur AIR (ADL)

Pour exécuter une application à l’aide d’ADL, utilisez la syntaxe suivante :

adl application.xml

où application.xml est le fichier descripteur de l’application.

La syntaxe complète d’ADL est la suivante :

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

(Les éléments entre crochets, [], sont facultatifs.)

-runtime RépertoireMoteurExécution Indique le répertoire contenant le moteur d’exécution à utiliser. Si vous ne le précisez pas, le répertoire du moteur d’exécution situé dans le même kit SDK que le programme ADL est utilisé. Si vous déplacez ADL hors de son dossier SDK, spécifiez le répertoire du moteur d’exécution. Sous Windows et Linux, indiquez le répertoire contenant le dossier Adobe AIR. Sous Mac OS X, spécifiez le répertoire contenant Adobe AIR.framework.

-pubid IdentifiantEditeur Affecte la valeur indiquée comme identifiant d’éditeur de l’application AIR pour cette exécution. L’utilisation d’un ID d’éditeur temporaire vous permet de tester les fonctions d’une application AIR (telles que la communication via une connexion locale) nécessitant ce type d’identifiant afin d’identifier une application de manière unique. Depuis la version 1.5.3 d’AIR, vous pouvez également stipuler l’identifiant d’éditeur dans le fichier descripteur de l’application (n’utilisez donc pas ce paramètre).

-nodebug Désactive la prise en charge du débogage. Si cette option est utilisée, le processus de l’application ne peut pas se connecter au programme Flash Debugger et les boîtes de dialogue relatives aux exceptions non gérées sont masquées. (Toutefois, les instructions trace sont toujours imprimées dans la fenêtre de la console.) La désactivation de la fonction de débogage permet d’accélérer l’exécution de votre application et d’émuler plus étroitement le mode d’exécution d’une application installée.

-atlogin Simule le lancement de l’application lors de la connexion. Cet indicateur permet de tester la logique applicative qui s’exécute uniquement lorsqu’une application est configurée de sorte à démarrer lorsque l’utilisateur se connecte. Lors de l’utilisation de -atlogin, la propriété reason de l’objet InvokeEvent envoyée à l’application correspond à login, et non à standard (à moins que l’application soit déjà en cours d’exécution).

-profile NomProfil L’application ADL débogue l’application avec le profil indiqué. La valeur NomProfil gère l’une des valeurs suivantes :

• desktop

• extendedDesktop

• mobileDevice

Si le descripteur de l’application comprend un élément supportedProfiles, le profil spécifié avec l’indicateur -profile doit figurer dans la liste prise en charge. Si vous n’utilisez pas l’indicateur -profile, le premier profil du descripteur de l’application fait office de profil actif. Si le descripteur de l’application ne comprend pas d’élément supportedProfiles et que vous n’utilisez pas l’indicateur -profile, le profil desktop est utilisé.

Pour plus d’informations, voir supportedProfiles et Profils de périphérique.

-screensize valeur Taille de l’écran simulée à utiliser lors de l’exécution d’une application associée au profil mobileDevice sur le bureau. Indiquez la taille de l’écran en sélectionnant le type d’écran prédéfini ou saisissez les dimensions (en pixels) de la largeur et de la hauteur standard correspondant au mode Portrait, plus la largeur et la hauteur en plein écran. Pour spécifier la valeur par type, utilisez l’un des types d’écran prédéfinis suivants :

Pour spécifier directement les dimensions de l’écran en pixels, utilisez le format suivant :

widthXheight:fullscreenWidthXfullscreenHeight

Veillez à toujours spécifier les dimensions (en pixels) correspondant au format Portrait, c’est-à-dire de spécifier une valeur de largeur inférieure à la valeur de hauteur. Spécifiez par exemple comme suit l’écran NexusOne :

-screensize 480x762:480x800

-extdir extension-directory Répertoire dans lequel le moteur d’exécution doit rechercher les extensions natives. Ce répertoire contient un sous-répertoire pour chaque extension native qu’utilise l’application. Chacun de ces sous-répertoires contient le fichier ANE extrait du package d’une extension. Exemple :

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 
    

Lors de l’utilisation du paramètre -extdir, tenez compte des points suivants :

application.xml Fichier descripteur d’application. Voir Fichiers descripteurs d’applications AIR. Le descripteur d’application est l’unique paramètre requis par ADL et, dans la plupart des cas, l’unique paramètre nécessaire.

RépertoireRacine Indique le répertoire racine de l’application à exécuter. S’il n’est pas spécifié, c’est le répertoire contenant le fichier descripteur d’application qui est utilisé.

-- arguments Toutes les chaînes de caractères figurant après « -- » sont transmises à l’application sous forme d’arguments de ligne de commande.

Exécutez une application dans le répertoire actif :

adl myApp-app.xml

Exécutez une application dans un sous-répertoire du répertoire actif :

adl source/myApp-app.xml release

Exécutez une application et transmettez deux arguments de ligne de commande, « tick » et « tock » :

adl myApp-app.xml -- tick tock

Exécutez une application à l’aide d’un moteur d’exécution spécifique :

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

Exécutez une application sans prise en charge du débogage :

adl -nodebug myApp-app.xml

Exécutez une application du profil de périphérique mobile et simulez la taille de l’écran Nexus One :

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

Exécutez une application par le biais d’Apache Ant (les chemins illustrés dans l’exemple se réfèrent à 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>

Le tableau suivant décrit les codes de sortie imprimés par ADL :