Éléments du fichier descripteur d’application AIR

Permet à l’API intégrée au navigateur AIR de détecter et lancer l’application.

Si vous définissez cette valeur sur true , tenez compte des implications au niveau de la sécurité. Ces implications sont décrites dans Appel d’une application AIR à partir du navigateur (développeurs ActionScript) et Appel d’une application AIR à partir du navigateur (développeurs HTML).

Pour plus d’informations, voir Lancement d’une application AIR installée à partir du navigateur .

Élément parent : application

Éléments enfants : aucun

<allowBrowserInvocation>true</allowBrowserInvocation>

Permet d’ajouter des éléments au fichier manifeste Android. AIR crée un fichier AndroidManifest.xml par package APK. L’élément android du fichier descripteur d’application AIR permet de lui ajouter d’autres éléments. Cet élément est ignoré sur toutes les plates-formes, à l’exception d’Android.

Élément parent : application

Éléments enfants :

• colorDepth

• manifestAdditions

<android> 
    <manifestAdditions> 
        ... 
    </manifestAdditions> 
</android>

Élément racine d’un document descripteur d’application AIR.

Élément parent : aucun

Éléments enfants :

• allowBrowserInvocation

• android

• copyright

• customUpdateUI

• description

• extensions

• filename

• fileTypes

• icon

• id

• initialWindow

• installFolder

• iPhone

• name

• programMenuFolder

• publisherID

• supportedLanguages

• supportedProfiles

• version

• versionLabel

• versionNumber

xmlns="http://ns.adobe.com/air/application/1.0" 
xmlns="http://ns.adobe.com/air/application/1.1" 
xmlns="http://ns.adobe.com/air/application/1.5" 
xmlns="http://ns.adobe.com/air/application/1.5.2" 
xmlns="http://ns.adobe.com/air/application/1.5.3" 
xmlns="http://ns.adobe.com/air/application/2.0" 
xmlns="http://ns.adobe.com/air/application/2.5" 
xmlns="http://ns.adobe.com/air/application/2.6" 
xmlns="http://ns.adobe.com/air/application/2.7" 
xmlns="http://ns.adobe.com/air/application/3.0" 
xmlns="http://ns.adobe.com/air/application/3.1" 
xmlns="http://ns.adobe.com/air/application/3.2" 
xmlns="http://ns.adobe.com/air/application/3,3" 
xmlns="http://ns.adobe.com/air/application/3.4" 
xmlns="http://ns.adobe.com/air/application/3.5" 
xmlns="http://ns.adobe.com/air/application/3.6" 
xmlns="http://ns.adobe.com/air/application/3.7"

<?xml version="1.0" encoding="utf-8" ?> 
<application xmlns="http://ns.adobe.com/air/application/3.0"> 
    <id>HelloWorld</id> 
    <version>2.0</version> 
    <filename>Hello World</filename> 
    <name>Example Co. AIR Hello World</name> 
     <description> 
        <text xml:lang="en">This is an example.</text> 
        <text xml:lang="fr">C'est un exemple.</text> 
        <text xml:lang="es">Esto es un ejemplo.</text> 
    </description> 
    <copyright>Copyright (c) 2010 Example Co.</copyright> 
    <initialWindow> 
        <title>Hello World</title> 
        <content> 
            HelloWorld.swf 
        </content> 
        <systemChrome>none</systemChrome> 
        <transparent>true</transparent> 
        <visible>true</visible> 
        <minSize>320 240</minSize> 
    </initialWindow>  
    <installFolder>Example Co/Hello World</installFolder> 
    <programMenuFolder>Example Co</programMenuFolder> 
    <icon> 
        <image16x16>icons/smallIcon.png</image16x16> 
        <image32x32>icons/mediumIcon.png</image32x32> 
        <image48x48>icons/bigIcon.png</image48x48> 
        <image128x128>icons/biggestIcon.png</image128x128>  
    </icon> 
    <customUpdateUI>true</customUpdateUI> 
    <allowBrowserInvocation>false</allowBrowserInvocation> 
    <fileTypes> 
        <fileType> 
            <name>adobe.VideoFile</name> 
            <extension>avf</extension> 
            <description>Adobe Video File</description> 
            <contentType>application/vnd.adobe.video-file</contentType> 
            <icon> 
                <image16x16>icons/avfIcon_16.png</image16x16> 
                <image32x32>icons/avfIcon_32.png</image32x32> 
                <image48x48>icons/avfIcon_48.png</image48x48> 
                <image128x128>icons/avfIcon_128.png</image128x128> 
            </icon> 
        </fileType> 
    </fileTypes> 
</application>

Définit le format de l’application.

Si le format n’est pas spécifié, l’application s’ouvre dans le format et l’orientation « naturels » du périphérique. L’orientation naturelle varie selon le périphérique. En règle générale, il s’agit du format portrait sur les périphériques équipés d’un écran de petite taille, tels que les téléphones. Sur certains périphériques, tels que la tablette iPad, l’application s’ouvre dans l’orientation active. Dans AIR 3.3 et les versions ultérieures, cela s’applique à la totalité de l’application et pas simplement à l’affichage initial.

Élément parent : initialWindow

Éléments enfants : aucun

<aspectRatio>landscape</aspectRatio>

Indique si l’orientation du contenu de l’application est automatiquement modifiée lorsque le périphérique pivote. Pour plus d’informations, voir Orientation de la scène .

Si vous utilisez l’orientation automatique, envisagez de définir les propriétés align et scaleMode de l’objet Stage sur les valeurs suivantes :

stage.align = StageAlign.TOP_LEFT; 
stage.scaleMode = StageScaleMode.NO_SCALE;

Ces paramètres permettent à l’application de pivoter autour de l’angle supérieur gauche et interdisent la mise à l’échelle automatique de son contenu. Bien que les autres modes de mise à l’échelle ajustent le contenu en fonction des dimensions de la scène au terme de sa rotation, ils entraînent également un découpage, une distorsion ou une réduction excessive du contenu. Il est quasiment toujours préférable de redessiner le contenu ou d’en modifier à nouveau la disposition manuellement.

Élément parent : initialWindow

Éléments enfants : aucun

<autoOrients>true</autoOrients>

Indique quand utiliser la couleur 16 bits ou la couleur 32 bits.

L’utilisation de la couleur 16 bits peut augmenter les performances de rendu, au détriment de la fidélité des couleurs. Dans les versions antérieures à AIR 3, la couleur 16 bits est toujours utilisée sur Android. Dans AIR 3, la couleur 32 bits est utilisée par défaut.

Élément parent : android

Éléments enfants : aucun

<android> 
    <colorDepth>16bit</colorDepth> 
    <manifestAdditions>...</manifestAdditions> 
</android>

Indique si l’application contiendra ou non tout contenu vidéo.

Élément parent : android

Éléments enfants : aucun

<android> 
    <containsVideo>true</containsVideo> 
    <manifestAdditions>...</manifestAdditions> 
</android>

La valeur indiquée de l’élément content correspond à l’URL du fichier de contenu principal de l’application. Il s’agit soit d’un fichier SWF, soit d’un fichier HTML. L’URL est définie relativement à la racine du dossier d’installation de l’application. (Si une application AIR est exécutée avec ADL, l’URL est relative au dossier contenant le fichier descripteur d’application. Vous disposez du paramètre root-dir d’ADL pour indiquer un autre répertoire racine.)

Élément parent : initialWindow

Éléments enfants : aucun

<content>TravelPlanner.swf</content>

contentType est obligatoire depuis AIR 1.5 (il était facultatif dans AIR 1.0 et 1.1). Cette propriété aide certains systèmes d’exploitation à trouver l’application la plus adaptée pour ouvrir un fichier. Sa valeur doit correspondre au type MIME du contenu du fichier. Notez que la valeur est ignorée sous Linux si le type de fichier est déjà enregistré et a un type MIME attribué.

Élément parent : fileType

Éléments enfants : aucun

<contentType>text/plain</contentType>

Informations de copyright relatives à l’application AIR. Sous Mac OS, le texte de copyright s’affiche dans la boîte de dialogue A propos de de l’application installée. Sous Mac OS, les informations de copyright sont également utilisées dans le champ NSHumanReadableCopyright du fichier Info.plist de l’application.

Élément parent : application

Éléments enfants : aucun

<copyright>© 2010, Examples, Inc.All rights reserved.</copyright>

Indique si une application fournit ses propres boîtes de dialogue de mise à jour. Si l’élément est défini sur false , AIR propose des boîtes de dialogue de mise à jour standard à l’utilisateur. Seules les applications distribuées en tant que fichiers AIR disposent du système de mise à jour intégré d’AIR.

Si l’élément customUpdateUI est défini sur true dans la version installée de l’application et que l’utilisateur double-clique sur le fichier AIR pour installer une nouvelle version ou procéder à la mise à jour de l’application par le biais de la fonction d’installation transparente, le moteur d’exécution ouvre la version installée de l’application. Le moteur d’exécution n’ouvre pas le programme d’installation de l’application AIR par défaut. La logique de l’application peut alors déterminer la marche à suivre pour l’opération de mise à jour. (L’ID d’application et l’ID d’éditeur stockés dans le fichier AIR doivent être identiques aux valeurs de l’application installée pour que la mise à jour aboutisse.)

Pour plus d’informations, voir Mise à jour des applications AIR .

Élément parent : application

Éléments enfants : aucun

<customUpdateUI>true</customUpdateUI>

Indique que l’application requiert l’utilisation du tampon de profondeur ou du tampon de modèle. Ces tampons s’utilisent normalement avec du contenu 3D. Par défaut, la valeur de cet élément est false en vue de désactiver les tampons de profondeur et de modèle. Cet élément est nécessaire, car les tampons doivent être alloués au démarrage de l’application, c’est-à-dire avant le chargement de contenu.

Le paramètre de cet élément doit correspondre à la valeur transmise pour l’argument enableDepthAndStencil à la méthode Context3D.configureBackBuffer() . Si les valeurs ne correspondent pas, AIR renvoie une erreur.

Cet élément est applicable uniquement lorsque renderMode = direct . Si renderMode n’est pas égal à direct , ADT renvoie l’erreur 118 :

<depthAndStencil> element unexpected for render mode cpu.  It requires "direct" render mode.

Élément parent : initialWindow

Éléments enfants : aucun

<depthAndStencil>true</depthAndStencil>

Description de l’application, affichée dans le programme d’installation d’une application AIR.

Si vous indiquez un nœud texte unique (au lieu de plusieurs éléments text), le programme d’installation de l’application AIR utilise cette description, quelle que soit la langue système activée. Dans le cas contraire, le programme d’installation d’une application AIR utilise la description la plus proche de la langue de l’interface utilisateur du système d’exploitation de l’utilisateur. Prenons l’exemple d’une installation dans laquelle l’élément description du fichier descripteur d’application comprend une valeur pour le jeu de paramètres régionaux en (anglais). Le programme d’installation d’une application AIR utilise la description en si le système de l’utilisateur identifie en (anglais) en tant que langue de l’interface utilisateur. Il utilise également la description en si la langue de l’interface utilisateur système correspond à en-US (anglais américain). Toutefois, si la langue de l’interface utilisateur système correspond à en-US et que le fichier descripteur d’application définit à la fois les noms en-US et en-GB, le programme d’installation d’AIR utilise la valeur en-US. Si l’application ne définit pas de description qui corresponde à la langue de l’interface utilisateur système, le programme d’installation d’une application AIR utilise la première valeur description stipulée dans le fichier descripteur de l’application.

Pour plus d’informations sur le développement d’applications multilingues, voir Localisation d’applications AIR .

Élément parent : application

Éléments enfants : text

<description>This is a sample AIR application.</description> 

<description> 
    <text xml:lang="en">This is an example.</text> 
    <text xml:lang="fr">C'est un exemple.</text> 
    <text xml:lang="es">Esto es un ejemplo.</text> 
</description> 

Description du type de fichier affichée à l’intention de l’utilisateur par le système d’exploitation. Il est impossible de la localiser.

Voir aussi : description en tant qu’enfant de l’élément application

Élément parent : fileType

Éléments enfants : aucun

<description>PNG image</description>

Vous permet d’utiliser des polices personnalisées sur StageText dans l’application AIR. Cet élément est facultatif.

Élément parent : application

Éléments enfants : font

<embedFonts> 
   <font> 
      <fontPath>ttf/space age.ttf</fontPath>
      <fontName>space age</fontName> 
   </font>
   <font> 
      <fontPath>ttf/xminus.ttf</fontPath>
      <fontName>xminus</fontName> 
   </font>
</embedFonts>

iOS utilise des propriétés appelées entitlements pour que l’application puisse accéder à des ressources et fonctionnalités supplémentaires. Utilisez l’élément Entitlements pour spécifier ces informations sur une application iOS mobile.

Élément parent : iPhone

Éléments enfants : éléments Entitlements.plist iOS

<iphone> 
... 
   <Entitlements> 
      <![CDATA[ 
         <key>aps-environment</key> 
         <string>development</string> 
      ]]> 
   </Entitlements> 
</iphone>

Chaîne correspondant à l’extension d’un type de fichier.

Élément parent : fileType

Éléments enfants : aucun

<extension>png</extension>

Indique l’ID d’une extension ActionScript utilisée par l’application. L’ID est défini dans le document descripteur de l’extension.

Élément parent : extensions

Éléments enfants : aucun

<extensionID>com.example.extendedFeature</extensionID>

Identifie les extensions ActionScript utilisées par une application.

Élément parent : application

Éléments enfants : extensionID

<extensions> 
    <extensionID>extension.first</extensionID> 
    <extensionID>extension.next</extensionID> 
    <extensionID>extension.last</extensionID> 
</extensions>

Indique le nom d’un fichier texte contenant une liste de fichiers SWF à configurer par ADT pour l’hébergement à distance. Vous pouvez réduire la taille de téléchargement initiale de l’application en compressant un sous-ensemble des fichiers SWF utilisées par votre application et en chargeant les fichiers SWF externes restants (actif uniquement) lors de l’exécution à l’aide de la méthode Loader.load() . Pour utiliser cette fonction, vous devez compresser l’application de telle sorte qu’ADT déplace tout le pseudo-code ActionScript (ABC) depuis les fichiers SWF chargés en externe vers le fichier SWF principal de l’application, laissant un fichier SWF qui contient uniquement des actifs. Cela est nécessaire pour respecter la règle de l’Apple Store qui interdit le téléchargement tout code une fois qu’une application est installée.

Pour plus d’informations, reportez-vous à Réduire la taille des téléchargements en chargeant des fichiers SWF externes d’actifs uniquement .

Élément parent : iPhone , initialWindow

Éléments enfants : aucun

<iPhone> 
    <externalSwfs>FileContainingListofSWFs.txt</externalSwfs> 
</iPhone>

Chaîne à utiliser en tant que nom de fichier de l’application (sans extension) lors de l’installation de cette dernière. Le fichier d’application démarre l’application AIR dans le moteur d’exécution. Si aucune valeur name n’est définie, l’élément filename fait également office de nom du dossier d’installation.

Élément parent : application

Éléments enfants : aucun

<filename>MyApplication</filename>

Décrit un type de fichier unique auquel peut être associée l’application.

Élément parent : fileTypes

Éléments enfants :

• contentType

• description

• extension

• icon

• name

<fileType> 
    <name>foo.example</name> 
    <extension>foo</extension> 
    <description>Example file type</description> 
    <contentType>text/plain</contentType> 
    <icon> 
        <image16x16>icons/fooIcon16.png</image16x16> 
        <image48x48>icons/fooIcon48.png</imge48x48> 
    <icon> 
</fileType>

L’élément fileTypes permet de déclarer les types de fichiers auxquels peut être associée une application AIR.

Lors de l’installation d’une application AIR, tout type de fichier déclaré est enregistré dans le système d’exploitation. Si ces types de fichiers ne sont pas encore associés à une autre application, ils sont associés à l’application AIR. Pour remplacer une association existante entre un type de fichier et une autre application, utilisez la méthode NativeApplication.setAsDefaultApplication() à l’exécution (de préférence avec l’accord de l’utilisateur).

L’élément fileTypes est facultatif.

Élément parent : application

Éléments enfants : fileType

<fileTypes> 
    <fileType> 
        <name>adobe.VideoFile</name> 
        <extension>avf</extension> 
        <description>Adobe Video File</description> 
        <contentType>application/vnd.adobe.video-file</contentType> 
        <icon> 
            <image16x16>icons/AIRApp_16.png</image16x16>       
            <image32x32>icons/AIRApp_32.png</image32x32>       
            <image48x48>icons/AIRApp_48.png</image48x48>      
            <image128x128>icons/AIRApp_128.png</image128x128> 
        </icon> 
    </fileType> 
</fileTypes>

Décrit une police personnalisée unique pouvant être utilisée dans l’application AIR.

Élément parent : embedFonts

Éléments enfants : fontName , fontPath

<font> 
   <fontPath>ttf/space age.ttf</fontPath>
   <fontName>space age</fontName> 
</font>

Spécifie le nom de la police personnalisée.

Élément parent : font

Éléments enfants : aucun

<fontName>space age</fontName> 

Indique l’emplacement du fichier de police personnalisée.

Élément parent : font

Éléments enfants : aucun

<fontPath>ttf/space age.ttf</fontPath> 

Forcer le mode de rendu UC pour un ensemble spécifié de périphériques. Cette fonction vous permet d’activer de manière sélective le mode de rendu GPU pour les périphériques iOS restants.

Vous ajoutez cette balise comme enfant de la balise iPhone et spécifiez une liste de noms de modèles séparés par des espaces. Voici des noms de modèle de périphérique valides :

Élément parent : iPhone , initialWindow

Éléments enfants : aucun

... 
<renderMode>GPU</renderMode> 
... 
<iPhone> 
... 
   <forceCPURenderModeForDevices>iPad1,1 iPhone1,1 iPhone1,2 iPod1,1 
   </forceCPURenderModeForDevices> 
</iPhone>

Indique si l’application démarre en mode Plein écran.

Élément parent : initialWindow

Éléments enfants : aucun

<fullscreen>true</fullscreen>

Hauteur initiale de la fenêtre principale de l’application.

Si vous ne définissez pas de hauteur, elle est déterminée par les paramètres figurant dans le fichier SWF racine ou, dans le cas d’une application AIR de type HTML, par le système d’exploitation.

La hauteur maximale d’une fenêtre est passée de 2 048 à 4 096 pixels dans AIR 2.

Élément parent : initialWindow

Éléments enfants : aucun

<height>4095</height>

La propriété icon définit un ou plusieurs fichiers d’icône à utiliser pour l’application. L’inclusion d’une icône est facultative. Si vous ne définissez pas la propriété icon , le système d’exploitation affiche une icône par défaut.

Le chemin défini est relatif au répertoire racine de l’application. Les fichiers d’icône doivent être au format PNG. Vous pouvez indiquer les tailles d’icône suivantes :

S’il existe un élément de taille donnée, l’image du fichier doit posséder exactement la taille définie. Si toutes les tailles ne sont pas disponibles, la taille la plus proche est mise à l’échelle en fonction de l’utilisation requise de l’icône par le système d’exploitation.

Pour obtenir de meilleurs résultats, fournissez une image dans chacune des tailles disponibles. Assurez-vous en outre que l’apparence des icônes est appropriée en mode de couleur 16 et 32 bits.

Élément parent : application

Éléments enfants : imageNxN

<icon> 
    <image16x16>icons/smallIcon.png</image16x16> 
    <image32x32>icons/mediumIcon.png</image32x32> 
    <image48x48>icons/bigIcon.png</image48x48> 
    <image128x128>icons/biggestIcon.png</image128x128>  
</icon>

Chaîne d’identifiant de l’application, appelée ID d’application. Un identifiant de type DNS inverse est souvent utilisé, mais ce type n’est pas obligatoire.

Élément parent : application

Éléments enfants : aucun

<id>org.example.application</id>

Définit le chemin d’accès d’icône par rapport au répertoire de l’application.

Vous pouvez utiliser les images d’icône suivantes, chacune stipulant une taille d’icône distincte :

• image16x16

• image29x29 (AIR 2+)

• image32x32

• image36x36 (AIR 2.5+)

• image48x48

• image50x50 (AIR 3.4+)

• image57x57 (AIR 2+)

• image58x58 (AIR 3.4+)

• image72x72 (AIR 2+)

• image100x100 (AIR 3.4+)

• image114x114 (AIR 2.6+)

• image128x128

• image144x144 (AIR 3.4+)

• image512x512 (AIR 2+)

• image1024x1024 (AIR 3.4+)

L’icône doit être un fichier graphique PNG dont la taille correspond exactement à la valeur indiquée par l’élément image. Les fichiers d’icône doivent être inclus dans le package de l’application. Les icônes auxquelles fait référence le document descripteur de l’application ne sont pas automatiquement intégrées.

Élément parent : application

Éléments enfants : aucun

<image32x32>icons/icon32.png</image32x32>

Permet de spécifier des propriétés supplémentaires d’une application iOS.

Élément parent : iPhone

Éléments enfants : éléments Info.plist iOS

<InfoAdditions> 
    <![CDATA[ 
        <key>UIStatusBarStyle</key> 
        <string>UIStatusBarStyleBlackOpaque</string> 
        <key>UIRequiresPersistentWiFi</key> 
        <string>NO</string> 
    ]]> 
</InfoAdditions>

Définit le principal fichier de contenu et l’aspect initial de l’application.

Élément parent : application

<initialWindow> 
    <title>Hello World</title> 
    <content> 
        HelloWorld.swf 
    </content> 
    <depthAndStencil>true</depthAndStencil> 
    <systemChrome>none</systemChrome> 
    <transparent>true</transparent> 
    <visible>true</visible> 
    <maxSize>1024 800</maxSize> 
    <minSize>320 240</minSize> 
    <maximizable>false</maximizable> 
    <minimizable>false</minimizable> 
    <resizable>true</resizable> 
    <x>20</x> 
    <y>20</y> 
    <height>600</height> 
    <width>800</width> 
    <aspectRatio>landscape</aspectRatio> 
    <autoOrients>true</autoOrients> 
    <fullScreen>false</fullScreen> 
    <renderMode>direct</renderMode> 
</initialWindow>

Identifie le sous-répertoire du répertoire d’installation par défaut.

Sous Windows, le sous-répertoire d’installation par défaut est le répertoire Program Files. Sous Mac OS, il s’agit du répertoire /Applications. Sous Linux, il s’agit du répertoire /opt/. Par exemple, si la propriété installFolder est définie sur « Acme » et qu’une application s’appelle « ExempleApp » , l’application est installée dans C:\Program Files\Acme\ExempleApp sous Windows, dans /Applications/Acme/Exemple.app sous Mac OS et dans /opt/Acme/ExampleApp sous Linux.

La propriété installFolder est facultative. Si vous ne spécifiez pas la propriété installFolder , l’application est installée dans un sous-répertoire du répertoire d’installation par défaut, basé sur la propriété name .

Élément parent : application

Éléments enfants : aucun

<installFolder>utilities/toolA</installFolder>

Définit les propriétés d’une application propres à iOS.

Élément parent : application

Spécifie les informations à ajouter au fichier manifeste Android associé à l’application.

Élément parent : manifestAdditions

Éléments enfants : définis par le kit SDK d’Android.

<![CDATA[      
    <manifest android:sharedUserID="1001"> 
        <uses-permission android:name="android.permission.CAMERA"/> 
        <uses-feature android:required="false" android:name="android.hardware.camera"/> 
        <application     android:allowClearUserData="true" 
                    android:enabled="true" 
                    android:persistent="true"/> 
    </manifest> 
]]>

Spécifie les informations à ajouter au fichier manifeste Android.

Chaque application Android comprend un fichier manifeste qui définit les propriétés de base de l’application. En tant que concept, le fichier manifeste Android est similaire au fichier descripteur d’application AIR. Une application AIR for Android comprend à la fois un fichier descripteur d’application et un fichier manifeste Android généré automatiquement. Lorsqu’une application AIR for Android est mise en package, les informations que contient l’élément manifestAdditions sont ajoutées aux parties correspondantes du document manifeste Android.

Élément parent : android

Éléments enfants : manifest

<manifestAdditions> 
    <![CDATA[      
        <manifest android:installLocation="preferExternal"> 
            <uses-permission android:name="android.permission.INTERNET"/> 
            <application     android:allowClearUserData="true" 
                        android:enabled="true" 
                        android:persistent="true"/> 
        </manifest> 
    ]]> 
</manifestAdditions>

Spécifie si la fenêtre peut être agrandie.

Élément parent : initialWindow

Éléments enfants : aucun

<maximizable>false</maximizable>

Tailles maximales de la fenêtre. Si vous ne définissez pas de taille maximale, elle est déterminée par le système d’exploitation.

Élément parent : initialWindow

Éléments enfants : aucun

<maxSize>1024 360</maxSize>

Spécifie si la fenêtre peut être réduite.

Élément parent : initialWindow

Éléments enfants : aucun

<minimizable>false</minimizable>

Spécifie la taille minimale autorisée de la fenêtre.

Élément parent : initialWindow

Éléments enfants : aucun

<minSize>120 60</minSize>

Titre de l’application affiché par le programme d’installation d’une application AIR.

Si aucun élément name n’est indiqué, le programme d’installation d’une application AIR utilise l’élément filename à titre de nom d’application.

Élément parent : application

Éléments enfants : text

<name>Test Application</name> 

<name> 
    <text xml:lang="en">Hello AIR</text> 
    <text xml:lang="fr">Bonjour AIR</text> 
    <text xml:lang="es">Hola AIR</text> 
</name> 

Identifie le nom d’un type de fichier.

Élément parent : fileType

Éléments enfants : aucun

<name>adobe.VideoFile</name>

Identifie l’emplacement de stockage des raccourcis associés à l’application dans le menu Tous les programmes du système d’exploitation Windows ou dans le menu Applications sous Linux. (Ce paramètre n’est actuellement pas pris en charge par les autres systèmes d’exploitation.)

Élément parent : application

Éléments enfants : aucun

<programMenuFolder>Example Company/Sample Application</programMenuFolder>

Identifie l’identifiant d’éditeur requis pour mettre à jour une application AIR initialement créée dans AIR 1.5.2 ou une version antérieure.

Ne spécifiez un identifiant d’éditeur que si vous créez une mise à jour d’application. La valeur de l’élément publisherID doit correspondre à l’identifiant d’éditeur généré par AIR pour la version antérieure de l’application. L’identifiant d’éditeur d’une application installée est indiqué dans le fichier META-INF/AIR/publisherid , qui réside dans le dossier dans lequel est installée l’application.

Les nouvelles applications créées dans AIR 1.5.3 ou ultérieur ne doivent pas spécifier d’identifiant d’éditeur.

Pour plus d’informations, voir A propos des identifiants d’éditeur AIR .

Élément parent : application

Éléments enfants : aucun

<publisherID>B146A943FBD637B68C334022D304CEA226D129B4.1</publisherID>

Indique si l’accélération par unité de processeur graphique (GPU) est utilisée, sous réserve d’être prise en charge par le périphérique actif.

Élément parent : initialWindow

Éléments enfants : aucun

<renderMode>direct</renderMode>

Indique si l’application souhaite utiliser une résolution standard ou haute sur un périphérique ou un ordinateur équipé d’un écran à haute résolution. Si l’élément est défini sur standard (valeur par défaut), l’écran est assimilé par l’application à un écran à résolution standard. Si l’élément est défini sur high , l’application peut adresser chaque pixel à haute résolution.

Par exemple, sur un écran d’iPhone haute résolution 640 x 960, si le paramètre est défini sur standard , la dimension de la scène en plein écran est de 320 x 480, et chaque pixel d’application est rendu en utilisant quatre pixels d’écran. Si le paramètre est défini sur high , la dimension de la scène en plein écran est 640 x 960.

Sur un périphérique équipé d’un écran à haute résolution, les dimensions de la scène correspondent à celles de l’écran, quel que soit le paramètre utilisé.

Si l’élément requestedDisplayResolution est imbriqué dans l’élément iPhone , il s’applique aux périphériques iOS. Dans ce cas, l’attribut excludeDevices peut être utilisé pour spécifier les périphériques auxquels le paramètre ne s’applique pas.

Si l’élément requestedDisplayResolution est imbriqué dans l’élément initialWindow , il s’applique aux applications AIR sur les ordinateurs MacBook Pro prenant en charge des écrans haute résolution. La valeur spécifiée s’applique à toutes les fenêtres natives utilisées dans l’application. L’imbrication de l’élément requestedDisplayResolution dans l’élément initialWindow est pris en charge dans AIR 3.6 et ultérieur.

Élément parent : iPhone , initialWindow

Éléments enfants : aucun

<initialWindow> 
    <requestedDisplayResolution>high</requestedDisplayResolution> 
</initialWindow>

<iPhone> 
    <requestedDisplayResolution excludeDevices="iPad3 iPad4">high</requestedDisplayResolution> 
</iPhone>

Spécifie si la fenêtre peut être redimensionnée.

Élément parent : initialWindow

Éléments enfants :

<resizable>false</resizable>

Spécifie le comportement par défaut de l’application lorsqu’un clavier virtuel est affiché. Le comportement par défaut consiste à déplacer l’application vers le haut. Le moteur d’exécution conserve à l’écran le champ de texte ou l’objet interactif qui sont la cible d’action. Utilisez l’option pan si l’application ne gère pas sa propre logique de traitement du clavier.

Vous pouvez également désactiver le comportement par défaut en définissant l’élément softKeyboardBehavior sur none . Dans ce cas de figure, les champs de texte et les objets interactifs distribuent un événement SoftKeyboardEvent lors de l’affichage du clavier logiciel, mais le moteur d’exécution n’effectue pas de panoramique ou de redimensionnement de l’application. C’est à l’application qu’il incombe de s’assurer que la zone de saisie de texte n’est pas masquée.

Élément parent : initialWindow

Éléments enfants : aucun

<softKeyboardBehavior>none</softKeyboardBehavior>

Identifie les langues prises en charge par l’application. Cet élément est utilisé uniquement par iOS, le moteur d’exécution captif de Mac et les applications Android. Cet élément est ignoré par tous les autres types d’applications.

Si vous ne spécifiez pas cet élément, le programme de mise en package exécute par défaut les actions suivantes en fonction du type d’application :

Élément parent : application

Éléments enfants : aucun

<supportedLanguages>en ja fr es</supportedLanguages>

Identifie les profils pris en charge pour l’application.

Élément parent : application

Éléments enfants : aucun

<supportedProfiles>desktop extendedDesktop</supportedProfiles>

<supportedProfiles>desktop mobileDevice</supportedProfiles>

Indique si la fenêtre de l’application initiale contient la barre de titre, les bordures et les contrôles standard proposés par le système d’exploitation.

Il est impossible de modifier le paramètre systemChrome de la fenêtre à l’exécution.

Élément parent : initialWindow

Éléments enfants : aucun

<systemChrome>standard</systemChrome>

Spécifie une chaîne localisée.

L’attribut xml:lang d’un élément text définit un code de langue, comme indiqué à l’adresse suivante RFC4646 (http://www.ietf.org/rfc/rfc4646.txt).

Le programme d’installation d’une application AIR utilise l’élément text associé à la valeur de l’attribut xml:lang la plus proche de la langue de l’interface utilisateur du système d’exploitation de l’utilisateur.

Prenons l’exemple d’une installation dans laquelle l’élément text comprend une valeur pour le jeu de paramètres régionaux en (anglais). Le programme d’installation d’une application AIR utilise le nom en si le système d’exploitation identifie en (anglais) en tant que langue de l’interface utilisateur. Il utilise également le nom en si la langue de l’interface utilisateur système correspond à en-US (anglais américain). Toutefois, si la langue de l’interface utilisateur correspond à en-US et que le fichier descripteur d’application définit à la fois les noms en-US et en-GB, le programme d’installation d’AIR utilise la valeur en-US.

Si l’application ne définit pas d’élément text qui corresponde aux langues prises en charge par le système d’exploitation, le programme d’installation d’une application AIR utilise la première valeur name stipulée dans le fichier descripteur d’application.

Éléments enfants : aucun

<text xml:lang="fr">Bonjour AIR</text>

Indique le titre figurant dans la barre de titre de la fenêtre initiale de l’application.

Le titre ne s’affiche que si l’élément systemChrome est défini sur standard .

Élément parent : initialWindow

Éléments enfants : aucun

<title>Example Window Title</title>

Indique si la fenêtre initiale de l’application est semi-transparente par rapport au bureau.

Une fenêtre transparente risque d’être tracée plus lentement et de mobiliser plus de mémoire. Il est impossible de modifier le paramètre transparent à l’exécution.

Élément parent : initialWindow

Éléments enfants : aucun

<transparent>true</transparent>

Identifie la version de l’application.

La chaîne version est un indicateur défini par l’application. AIR n’interprète pas la chaîne de version de quelque façon que ce soit. De ce fait, la version « 3.0 » n’est pas considérée comme étant plus récente que la version « 2.0 ». Exemples : « 1.0 », « .4 », « 0.5 », « 4.9 », « 1.3.4a ».

Dans AIR 2.5 et ultérieur, l’élément version a été remplacé par les éléments versionNumber et versionLabel .

Élément parent : application

Éléments enfants : aucun

<version>0.1 Alpha</version>

Spécifie une chaîne indiquant la version intelligible.

La valeur de l’élément versionLabel, plutôt que celle de l’élément versionNumber , est affichée dans les boîtes de dialogue d’installation. Si vous n’utilisez pas l’élément versionLabel , versionNumber est utilisé dans les deux cas.

Élément parent : application

Éléments enfants : aucun

<versionLabel>0.9 Beta</versionlabel>

Numéro de version de l’application.

Élément parent : application

Éléments enfants : aucun

<versionNumber>1.0.657</versionNumber> 
 
<versionNumber>10</versionNumber> 
 
<versionNumber>0.01</versionNumber>

Indique si la fenêtre initiale de l’application est visible dès sa création.

Les fenêtres AIR, y compris la fenêtre initiale, sont par défaut invisibles lors de leur création. Pour afficher une fenêtre, appelez la méthode activate() de l’objet NativeWindow ou définissez la propriété visible sur true . Il peut s’avérer utile de masquer initialement la fenêtre principale, afin de ne pas afficher les modifications apportées à la position, à la taille ou à la disposition du contenu de la fenêtre.

Le composant Flex mx:WindowedApplication affiche et active automatiquement la fenêtre juste avant la distribution de l’événement applicationComplete , à moins que l’attribut visible ne soit défini sur false dans la définition MXML.

Sur les périphériques indiqués dans le profil mobile, qui ne prend pas en charge les fenêtres, le paramètre visible est ignoré.

Élément parent : initialWindow

Éléments enfants : aucun

<visible>true</visible>

Largeur initiale de la fenêtre principale de l’application.

Si vous ne définissez pas de largeur, elle est déterminée par les paramètres figurant dans le fichier SWF racine ou, dans le cas d’une application AIR de type HTML, par le système d’exploitation.

La largeur maximale d’une fenêtre est passée de 2 048 à 4 096 pixels dans AIR 2.

Élément parent : initialWindow

Éléments enfants : aucun

<width>1024</width>

Position horizontale de la fenêtre initiale d’une application.

Dans la plupart des cas, il est préférable de confier au système d’exploitation le soin de déterminer la position initiale de la fenêtre, plutôt que de définir une valeur fixe.

L’origine du système de coordonnées de l’écran (0,0) correspond à l’angle supérieur gauche de l’écran principal de l’ordinateur de bureau (déterminé par le système d’exploitation).

Élément parent : initialWindow

Éléments enfants : aucun

<x>120</x>

Position verticale de la fenêtre initiale d’une application.

Dans la plupart des cas, il est préférable de confier au système d’exploitation le soin de déterminer la position initiale de la fenêtre, plutôt que de définir une valeur fixe.

L’origine du système de coordonnées de l’écran (0,0) correspond à l’angle supérieur gauche de l’écran principal de l’ordinateur de bureau (déterminé par le système d’exploitation).

Élément parent : initialWindow

Éléments enfants : aucun

<y>250</y>