Commande ADT package

La commande -package doit être exécutée à partir du répertoire principal de l’application. Elle gère les syntaxes suivantes :

Création d’un package AIR à partir des fichiers d’application du composant :

adt -package 
    AIR_SIGNING_OPTIONS 
    -target packageType 
    -sampler 
    ‑hideAneLibSymbols 
    NATIVE_SIGNING_OPTIONS 
    output 
    app_descriptor 
    FILE_OPTIONS 

Création d’un package natif à partir des fichiers d’application du composant :

adt -package 
    AIR_SIGNING_OPTIONS 
    -target packageType 
    DEBUGGER_CONNECTION_OPTIONS 
    -airDownloadURL URL 
    NATIVE_SIGNING_OPTIONS 
    output 
    app_descriptor 
    -platformsdk path 
    FILE_OPTIONS 

Création d’un package natif qui inclut une extension native à partir des fichiers d’application du composant :

adt -package 
    AIR_SIGNING_OPTIONS 
    -migrate MIGRATION_SIGNING_OPTIONS 
    -target packageType 
    DEBUGGER_CONNECTION_OPTIONS 
    -airDownloadURL URL 
    NATIVE_SIGNING_OPTIONS 
    output 
    app_descriptor 
    -platformsdk path 
    FILE_OPTIONS 

Création d’un package natif à partir d’un fichier AIR ou AIRI :

adt -package 
    -target packageType 
    NATIVE_SIGNING_OPTIONS 
    output 
    input_package

Création d’un package d’extensions natives à partir des fichiers d’extension native du composant :

adt -package 
    AIR_SIGNING_OPTIONS     
    -target ane 
    output 
    ANE_OPTIONS

AIR_SIGNING_OPTIONS Les options de signature AIR identifient le certificat utilisé pour signer un fichier d’installation AIR. Les options de signature font l’objet d’une description détaillée à la section Options de signature du code de l’outil ADT .

-migrate Cet indicateur spécifie que l’application est signée avec un certificat de migration en plus du certificat spécifié par les paramètres AIR_SIGNING_OPTIONS . Cet indicateur n’est valide que si vous mettez en package une application de bureau sous la forme d’un programme d’installation natif et que l’application utilise une extension native. Dans les autres cas, une erreur survient. Les options de signature du certificat de migration sont spécifiées dans les paramètres MIGRATION_SIGNING_OPTIONS . Elles font l’objet d’une description détaillée à la section Options de signature du code de l’outil ADT . L’utilisation de l’indicateur -migrate permet de créer une mise à jour d’une application de bureau à programme d’installation natif qui utilise une extension native et de modifier le certificat de signature du code de l’application lors de l’expiration du certificat d’origine, par exemple. Pour plus d’informations, voir Signature d’une version mise à jour d’une application AIR .

L’indicateur -migrate de la commande -package est disponible dans AIR 3.6 et ultérieur.

-sampler (iOS uniquement, AIR 3.4 et ultérieur) Active l’échantillonneur ActionScript basé sur la télémétrie dans les applications iOS. Cet indicateur permet de profiler l’application avec Adobe Scout. Bien que Scout puisse profiler le contenu de n’importe quelle plate-forme Flash, l’activation de la télémétrie détaillée vous permet de mieux connaître la durée des fonctions ActionScript, les rendus DisplayList et Stage3D, etc. Notez que l’utilisation de cet indicateur peut avoir une incidence sur les performances ; par conséquent, ne l’utilisez pas pour les applications de production.

-hideAneLibSymbols (iOS uniquement, AIR 3.4 et les versions ultérieures) Les développeurs d’applications peuvent utiliser plusieurs extensions natives provenant de sources diverses, et si les fichiers ANE partagent un nom de symbole commun, l’outil ADT génère une erreur de type « symbole dupliqué dans le fichier d’objet ». Dans certains cas, cette erreur peut même se manifester sous forme de blocage au moment de l’exécution. Vous pouvez utiliser l’option hideAneLibSymbols pour indiquer si vous souhaitez rendre visibles les symboles de la bibliothèque ANE uniquement aux sources de cette bibliothèque (yes) ou à toutes les sources (no) :

• yes : les symboles ANE sont masqués, ce qui résout tous les conflits de symboles indésirables.

• no : (valeur par défaut) les symboles ANE ne sont pas masqués. Ce comportement est celui des versions antérieures à AIR 3.4.

-embedBitcode (iOS uniquement, AIR 25 et versions ultérieures) Les développeurs d’application peuvent utiliser l’option embedBitcode pour indiquer s’il faut inclure le bitcode dans leur application iOS en spécifiant oui ou non. La valeur par défaut de cette option est non.

DEBUGGER_CONNECTION_OPTIONS Les options de connexion au débogueur indiquent si un package à déboguer doit tenter de se connecter à un débogueur distant qui s’exécute sur un autre ordinateur ou écouter une connexion issue d’un débogueur distant. Cet ensemble d’options est réservé aux packages mobiles à déboguer (cibles apk-debug et ipa-debug). Il est décrit à la section Options de connexion au débogueur .

-airDownloadURL Spécifie une autre URL de téléchargement et d’installation du moteur d’exécution d’AIR sur un périphérique Android. Si vous ne spécifiez pas d’autre URL, une application AIR redirige l’utilisateur vers le moteur d’exécution d’AIR dans Android Market, le cas échéant.

Si l’application est distribuée via un site autre qu’Android Market géré par Google, il peut s’avérer nécessaire de spécifier l’URL de téléchargement du moteur d’exécution d’AIR à partir de ce site. Certains autres sites n’autorisent pas les applications à demander un téléchargement externe. Cette option est réservée aux packages Android.

NATIVE_SIGNING_OPTIONS Les options de signature natives identifient le certificat requis pour signer un fichier de package natif. Ces options de signature permettent d’appliquer une signature utilisée par le système d’exploitation natif, plutôt que le moteur d’exécution d’AIR. Les options sont sinon identiques à AIR_SIGNING_OPTIONS et font l’objet d’une description détaillée à la section Options de signature du code de l’outil ADT .

Les signatures natives sont prises en charge sous Windows et Android. Sous Windows, vous devez spécifier à la fois les options de signature AIR et les options de signature natives. Sous Android, vous ne pouvez spécifier que les options de signature natives.

Dans la plupart des cas, un même certificat de signature du code peut appliquer à la fois une signature AIR et une signature native. Certains cas de figure font toutefois exception à la règle. Google stipule, par exemple, que toutes les applications destinées à Android Market doivent impérativement être signées à l’aide d’un certificat valide jusqu’à l’année 2033 au moins. Cela signifie qu’un certificat délivré par une autorité de certification reconnue, recommandée lors de l’application d’une signature AIR, ne doit pas être utilisé pour signer une application Android. (Aucune autorité de certification ne délivre de certificat de signature du code dont la période de validité est aussi longue.)

output Nom du fichier de package à créer. La définition de l’extension du fichier est facultative. Si vous ne l’indiquez pas, une extension adaptée à la valeur -target et au système d’exploitation en cours est ajoutée.

app_descriptor Chemin d’accès au fichier descripteur de l’application. Il est possible de spécifier un chemin relatif (défini par rapport au répertoire actif) ou un chemin absolu. (Le fichier descripteur de l’application est renommé application.xml dans le fichier AIR.)

Les développeurs d’applications -arch peuvent utiliser cet argument pour créer un package APK pour les plates-formes x86, qui prend les valeurs suivantes :

armv7 est la valeur par défaut lorsqu’aucune valeur n’est spécifiée

FILE_OPTIONS Identifie les fichiers d’application à inclure dans le package. Les options de fichier font l’objet d’une description détaillée à la section Options associées aux fichiers et chemins . Ne spécifiez pas d’options de fichier si vous créez un package natif à partir d’un fichier AIR ou AIRI.

input_airi A spécifier lors de la création d’un package natif à partir d’un fichier AIRI. Les options AIR_SIGNING_OPTIONS sont obligatoires si la cible correspond à air (ou qu’aucune cible n’est spécifiée).

input_air A spécifier lors de la création d’un package natif à partir d’un fichier AIR. Ne spécifiez pas d’option AIR_SIGNING_OPTIONS.

ANE_OPTIONS Identifie les options et les fichiers permettant de créer un package d’extensions natives. Les options du package d’extensions sont décrites de façon exhaustive dans Options d’extension native .

Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.