ADOBE Air Création d’applications [fr]

Création d’applications
ADOBE®
AIR®

Informations juridiques

Vous trouverez des informations juridiques à l’adresse http://help.adobe.com/fr_FR/legalnotices/index.html.
Dernière mise à jour le 14/11/2013

Sommaire

Chapitre 1 : A propos d’Adobe AIR
Chapitre 2 : Installation d’Adobe AIR
Installation d’Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Désinstallation d’Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Installation et exécution des exemples d’application AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Mises à jour d’Adobe Air . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Chapitre 3 : Utilisation des API AIR
Classes ActionScript 3.0 propres à AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Classes Flash Player contenant des fonctionnalités propres à AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Composants Flex propres à AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Chapitre 4 : Outils de la plate-forme Adobe Flash pour le développement AIR
Installation du kit de développement SDK AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Configuration du kit SDK Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Configuration de kits SDK externes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
iii
Chapitre 5 : Création d’une première application AIR
Création d’une première application de bureau AIR Flex dans Flash Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Création d’une première application de bureau AIR dans Flash Professional . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Création d’une première application AIR for Android dans Flash Professional . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Création d’une première application AIR for iOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Création d’une première application AIR de type HTML dans Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Création d’une première application AIR de type HTML à l’aide du kit SDK d’AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Création d’une première application de bureau AIR à l’aide du kit SDK de Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Création d’une première application AIR for Android à l’aide du kit SDK de Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Chapitre 6 : Développement d’applications de bureau AIR
Flux de travail de développement d’une application de bureau AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Définition des propriétés d’une application de bureau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Débogage d’une application de bureau AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Mise en package d’un fichier d’installation AIR de bureau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Mise en package d’un programme d’installation natif de bureau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Mise en package d’un paquet de moteur d’exécution captif pour des ordinateurs de bureau . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Distribution d’un package AIR pour ordinateur de bureau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Chapitre 7 : Développement d’applications AIR pour périphériques mobiles
Configuration de l’environnement de développement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Considérations liées à la conception d’applications mobiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Flux de travail de création d’une application AIR pour périphériques mobiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Définition des propriétés d’une application mobile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Mise en package d’une application AIR mobile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Débogage d’une application AIR mobile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Sommaire
Installation d’AIR et d’applications AIR sur un périphérique mobile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Mise à jour des applications AIR mobiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Utilisation des notifications Push . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Chapitre 8 : Développement d’applications AIR pour périphériques TV
Fonctionnalités AIR propres aux téléviseurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Considérations à prendre en compte lors de la création d’une application AIR pour TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Flux de travail de développement d’une application AIR pour TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Propriétés du descripteur de l’application AIR pour TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Mise en package d’une application AIR pour TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Débogage d’applications AIR pour TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Chapitre 9 : Utilisation d’extensions natives pour Adobe AIR
Fichiers AIR Native Extension (ANE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Extensions natives ou classe NativeProcess ActionScript ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Extensions natives ou bibliothèques de classes ActionScript (fichiers SWC) ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Périphériques pris en charge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Profils de périphérique pris en charge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Liste de tâches pour l’utilisation d’une extension native . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Déclaration de l’extension dans le fichier descripteur de l’application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Ajout du fichier ANE au chemin d’accès à la bibliothèque de l’application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Mise en package d’une application faisant appel à des extensions natives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
iv
Chapitre 10 : Compilateurs ActionScript
Présentation des outils de ligne de commande d’AIR intégrés au kit SDK Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Configuration des compilateurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Compilation de fichiers sources MXML et ActionScript pour AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Compilation d’un composant ou d’une bibliothèque de code AIR (Flex) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Chapitre 11 : Application de débogage du lanceur AIR (ADL)
Utilisation de l’application ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Exemples ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Codes d’erreur et de sortie d’ADL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Chapitre 12 : Outil AIR Developer (ADT)
Commandes de l’outil ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Ensembles d’options ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Messages d’erreur du programme ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Variables d’environnement ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Chapitre 13 : Signature d’applications AIR
Signature numérique d’un fichier AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Création d’un fichier AIR intermédiaire non signé à l’aide de l’outil ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Signature d’un fichier intermédiaire AIR à l’aide de l’outil ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Signature d’une version mise à jour d’une application AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Création d’un certificat auto-signé à l’aide de l’outil ADT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Sommaire
Chapitre 14 : Fichiers descripteurs d’applications AIR
Modifications apportées au fichier descripteur d’application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Structure du fichier descripteur d’application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Eléments du fichier descripteur d’application AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Chapitre 15 : Profils de périphérique
Limitation des profils cible dans le fichier descripteur de l’application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Fonctionnalités des différents profils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Chapitre 16 : API intégrée au navigateur et stockée dans le fichier AIR.SWF
Personnalisation du fichier badge.swf de l’installation transparente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Utilisation du fichier badge.swf pour installer une application AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Chargement du fichier air.swf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Vérification de la présence du moteur d’exécution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Vérification à partir d’une page Web de la présence d’une application AIR installée . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Installation d’une application AIR à partir du navigateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Lancement d’une application AIR installée à partir du navigateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Chapitre 17 : Mise à jour des applications AIR
A propos de la mise à jour des applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Présentation d’une interface utilisateur personnalisée pour la mise à jour d’applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Téléchargement d’un fichier AIR sur l’ordinateur de l’utilisateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Vérifications permettant de savoir si l’application est exécutée pour la première fois . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Utilisation de la structure de mise à jour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
v
Chapitre 18 : Affichage du code source
Chargement, configuration et ouverture de Source Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Interface utilisateur de Source Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Chapitre 19 : Débogage à l’aide de l’outil AIR HTML Introspector
Présentation de l’outil AIR HTML Introspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Chargement du code de l’outil AIR HTML Introspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Inspection d’un objet dans l’onglet Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Configuration de l’outil AIR HTML Introspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Interface de l’outil AIR HTML Introspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Utilisation de l’outil AIR HTML Introspector avec du contenu d’un sandbox hors application . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Chapitre 20 : Localisation d’applications AIR
Localisation du nom et de la description de l’application dans le programme d’installation de l’application d’AIR . . . . . . . 306
Localisation de contenu HTML à l’aide de la structure de localisation HTML d’AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Chapitre 21 : Variables d’environnement path
Définition de PATH sous Linux et Mac OS à l’aide de l’interface de commande Bash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
Définition de la variable d’environnement path sous Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Dernière mise à jour le 14/11/2013

Chapitre 1 : A propos d’Adobe AIR

Adobe® AIR® est un moteur d’exécution gérant plusieurs systèmes d’exploitation et écrans, qui permet d’exploiter vos compétences en matière de développement Web pour développer et déployer des applications Internet enrichies (RIA) destinées aux ordinateurs de bureau et périphériques mobiles. Vous pouvez créer des applications AIR de bureau, pour télévisions et périphériques mobiles en ActionScript 3.0 à l’aide d’Adobe® Flex et d’Adobe® Flash® (type SWF). Vous pouvez également créer des applications AIR de bureau par le biais de HTML, JavaScript® et Ajax (type HTML).
Pour plus d’informations sur la prise en main et l’utilisation d’Adobe AIR, voir le site Adobe AIR Developer Connection (http://www.adobe.com/devnet/air/).
AIR permet de travailler dans des environnements qui vous sont familiers, ainsi que d’exploiter les outils et approches qui vous conviennent. La prise en charge de Flex, HTML, JavaScript et Ajax assure la création d’une solution optimale qui répond à vos besoins.
Vous pouvez par exemple développer des applications qui font appel à l’une des technologies suivantes ou à une combinaison de celles-ci :
Flash / Flex / ActionScript
HTML / JavaScript / CSS / Ajax
1
Les utilisateurs manipulent les applications AIR comme toute application native. Le moteur d’exécution est installé une seule fois sur l’ordinateur ou le périphérique de l’utilisateur. Il est alors possible d’installer et d’exécuter les applications AIR à l’instar de toute autre application de bureau. (Sous iOS, étant donné que chaque application AIR est autonome, aucun moteur d’exécution d’AIR n’est installé.)
Quel que soit le système d’exploitation utilisé, le moteur d’exécution propose une plate-forme et une structure uniformes de déploiement d’applications. La cohérence des fonctionnalités et interactions rend ainsi superflus les tests dans plusieurs navigateurs. Au lieu de développer une application pour un système d’exploitation déterminé, vous ciblez le moteur d’exécution. Cette approche offre les avantages suivants :
Les applications développées pour AIR s’exécutent sur divers systèmes d’exploitation sans nécessiter d’intervention
supplémentaire de votre part. Le moteur d’exécution assure une présentation et des interactions cohérentes et prévisibles sur tous les systèmes d’exploitation pris en charge par AIR.
Grâce à l’exploitation de technologies Web et de modèles de conception existants, la création d’applications est plus
rapide. Vous pouvez assurer la migration des applications Web vers le bureau sans avoir à apprendre les technologies traditionnelles de développement pour le bureau ou un code natif complexe.
Parce qu’il ne fait pas appel à des langages de niveau inférieur tels que C et C++, le développement d’applications
s’en trouve simplifié. Il est ainsi inutile de gérer les API complexes de bas niveau propres à chaque système d’exploitation.
Développer des applications pour AIR vous permet d’exploiter un riche ensemble de structures et d’API :
API propres à AIR proposées par le moteur d’exécution et la structure AIR
API d’ActionScript utilisées par les fichiers SWF et la structure Flex (ainsi que qu’autres bibliothèques et structures
basées sur ActionScript)
HTML, CSS et JavaScript
La plupart des structures Ajax
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
A propos d’Adobe AIR
Les extensions natives pour Adobe AIR fournissent des API ActionScript permettant d’accéder à des
fonctionnalités propres à la plate-forme programmées en code natif. Les extensions natives peuvent également permettre d’accéder au code natif hérité, ainsi qu’au code natif qui fournit de meilleures performances.
AIR a un impact considérable sur la création, le déploiement et l’utilisation des applications. Il vous assure un contrôle créatif accru et permet la migration des applications Flash, Flex, HTML et Ajax vers le bureau, les périphériques mobiles et les télévisions.
Pour plus d’informations sur le contenu de chaque nouvelle mise à jour d’AIR, voir les notes de mise à jour sur Adobe AIR (http://www.adobe.com/go/learn_air_relnotes_fr).
2
Dernière mise à jour le 14/11/2013

Chapitre 2 : Installation d’Adobe AIR

Le moteur d’exécution d’Adobe® AIR® permet d’exécuter des applications AIR. Pour installer le moteur d’exécution, procédez comme suit, au choix :
Installez le moteur d’exécution séparément (sans installer d’application AIR).
Installez une application AIR pour la première fois par le biais d’un « badge » d’installation de page Web (vous êtes
également invité à installer le moteur d’exécution).
Créez un programme d’installation personnalisé qui installe votre application et le moteur d’exécution. Vous devez
demander l’autorisation de distribuer le moteur d’exécution AIR à Adobe. Pour demander l’autorisation, consulter la page Distribution du moteur d’exécution Adobe AIR. Notez qu’Adobe ne fournit aucun outil pour créer un tel programme d’installation. De nombreux kits d’outils tiers sont néanmoins disponibles.
Installez une application AIR qui intègre AIR en tant que moteur d’exécution captif. Un moteur d’exécution natif
est utilisé uniquement par l’application de mise en paquet. Il n’est pas utilisé pour exécuter d’autres applications AIR. Le regroupement du moteur d’exécution est possible sur Mac et Windows. Sur iOS, toutes les applications incluent un moteur d’exécution intégré. A partir d’AIR 3.7, les applications Android incluent un moteur d’exécution intégré par défaut (même si vous pouvez utiliser un moteur d’exécution distinct).
Configurez un environnement de développement AIR tel que le kit SDK AIR, Adobe® Flash® Builder™ ou le kit SDK
Adobe Flex® (qui contient les outils de développement de ligne de commande AIR). Le moteur d’exécution intégré au kit SDK est réservé au débogage d’applications, et non à l’exécution d’applications AIR installées.
3
Vous trouverez la configuration requise pour l’installation d’AIR et l’exécution d’applications AIR dans le document :
Adobe AIR : Configuration requise (http://www.adobe.com/fr/products/air/systemreqs/).
Le programme d’installation du moteur d’exécution et celui de l’application AIR créent des fichiers journaux lors de l’installation, la mise à jour ou la suppression de l’application ou du moteur d’exécution. Vous pouvez consulter ces journaux pour déterminer la cause de tout problème d’installation. Voir Installation logs.

Installation d’Adobe AIR

Pour installer ou mettre à jour le moteur d’exécution, l’utilisateur doit disposer de privilèges d’administration sur l’ordinateur.
Installation du moteur d’exécution sur un ordinateur Windows
1 Téléchargez le fichier d’installation du moteur d’exécution à partir de http://get.adobe.com/fr/air.
2 Double-cliquez sur le fichier d’installation du moteur d’exécution.
3 Dans la fenêtre d’installation, suivez les invites pour achever l’installation.
Installation du moteur d’exécution sur un ordinateur Mac
1 Téléchargez le fichier d’installation du moteur d’exécution à partir de http://get.adobe.com/fr/air.
2 Double-cliquez sur le fichier d’installation du moteur d’exécution.
3 Dans la fenêtre d’installation, suivez les invites pour achever l’installation.
4 Si le programme d’installation affiche une fenêtre d’authentification, entrez votre nom d’utilisateur et votre mot de
passe Mac OS.
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Installation d’Adobe AIR
Installation du moteur d’exécution sur un ordinateur Linux
Remarque : actuellement, AIR 2.7 et les versions ultérieures ne sont pas prises en charge sur Linux. Les applications AIR déployées sur Linux doivent continuer d’utiliser le kit SDK d’AIR 2.6.
Utilisation du programme d’installation binaire :
1 Accédez au fichier d’installation binaire à l’adresse http://kb2.adobe.com/cps/853/cpsid_85304.html et téléchargez-
le.
2 Définissez les autorisations du fichier de sorte que le programme d’installation puisse être exécuté : Vous pouvez
définir les autorisations sur une ligne de commande, comme suit :
chmod +x AdobeAIRInstaller.bin
Certaines versions de Linux vous permettent de définir les autorisations des fichiers dans la boîte de dialogue Propriétés, ouverte par l’intermédiaire d’un menu contextuel.
3 Exécutez le programme d’installation à partir de la ligne de commande ou en double-cliquant sur le fichier
d’installation du moteur d’exécution.
4 Dans la fenêtre d’installation, suivez les invites pour achever l’installation.
Adobe AIR est installé sous forme de package natif. En d’autres termes, en tant que rpm sur une distribution de type rpm et en tant que deb sur une distribution Debian. AIR ne prend actuellement en charge aucun autre format de package.
4
Utilisation des programmes d’installation de package :
1 Accédez au fichier du package AIR à l’adresse http://kb2.adobe.com/cps/853/cpsid_85304.html. Téléchargez le
package rpm ou Debian, selon le format pris en charge par votre système.
2 Si nécessaire, double-cliquez sur le fichier de package d’AIR pour installer le package.
Vous pouvez également effectuer l’installation à partir la ligne de commande :
a Sur un système Debian :
sudo dpkg -i <path to the package>/adobeair-2.0.0.xxxxx.deb
b Sur un système rpm :
sudo rpm -i <path to the package>/adobeair-2.0.0-xxxxx.i386.rpm
Ou si vous mettez à jour une version existante (AIR 1.5.3 ou ultérieur) :
sudo rpm -U <path to the package>/adobeair-2.0.0-xxxxx.i386.rpm
Pour installer AIR 2 et les applications AIR, vous devez disposer de privilèges de niveau administrateur sur l’ordinateur.
Adobe AIR est installé à l’emplacement suivant : /opt/Adobe AIR/Versions/1.0
AIR enregistre le type mime « application/vnd.adobe.air-application-installer-package+zip », ce qui signifie que les fichiers .air correspondent à ce type mime et sont donc associés au moteur d’exécution d’AIR.
Installation du moteur d’exécution sur un périphérique Android
Vous pouvez installer la version la plus récente du moteur d’exécution d’AIR à partir d’Android Market.
Vous pouvez installer des versions de développement du moteur d’exécution d’AIR à partir d’un lien de page Web ou à l’aide de la commande ADT
-installRuntime. Il est possible d’installer une seule version du moteur d’exécution
d’AIR à la fois. En d’autres termes, une version validée ne peut pas cohabiter avec une version de développement.
Pour plus d’informations, voir « Commande ADT installRuntime » à la page 185.
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Installation d’Adobe AIR
Installation du moteur d’exécution sur un périphérique iOS
Le code du moteur d’exécution d’AIR requis est intégré à chaque application pour périphériques iPhone, iTouch et iPad. Il est inutile d’installer un composant d’exécution distinct.
Voir aussi
« AIR for iOS » à la page 73

Désinstallation d’Adobe AIR

Après l’installation du moteur d’exécution, les procédures suivantes permettent de le désinstaller.
Désinstallation du moteur d’exécution sur un ordinateur Windows
1 Dans le menu Démarrer de Windows, sélectionnez Paramètres > Panneau de configuration.
2 Selon la version de Windows dont vous disposez, ouvrez l’élément du Panneau de configuration intitulé
Programmes, Programmes et fonctionnalités ou Ajout ou suppression de programmes.
3 Pour désinstaller le moteur d’exécution, sélectionnez « Adobe AIR ».
4 Cliquez sur le bouton Modifier/Supprimer.
5
Désinstallation du moteur d’exécution sur un ordinateur Mac
Double-cliquez sur le programme de désinstallation d’Adobe AIR, situé dans le dossier /Applications/Utilities.
Désinstallation du moteur d’exécution sur un ordinateur Linux
Effectuez l’une des opérations suivantes :
Sélectionnez la commande « Programme de désinstallation d’Adobe AIR » dans le menu Applications.
Exécutez le programme d’installation binaire d’AIR avec l’option -uninstall.
Supprimez les packages AIR (adobeair et adobecerts) avec le gestionnaire de package.
Suppression du moteur d’exécution sur un périphérique Android
1 Ouvrez l’application Réglages sur le périphérique.
2 Touchez l’entrée Adobe AIR sous Applications > Gérer les applications.
3 Touchez le bouton Désinstaller.
Vous disposez également de la commande ADT
ADT uninstallRuntime » à la page 186.
Suppression d’un moteur d’exécution intégré
Pour supprimer un programme d’exécution captif intégré, vous devez supprimer l’application avec laquelle il est installé. Notez que les moteurs d’exécution captifs sont utilisés uniquement pour exécuter l’application d’installation.
-uninstallRuntime. Pour plus d’informations, voir « Commande

Installation et exécution des exemples d’application AIR

Pour installer ou mettre à jour une application AIR, l’utilisateur doit disposer de privilèges d’administration sur l’ordinateur.
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Installation d’Adobe AIR
Certains exemples d’application illustrent des fonctionnalités AIR. Procédez comme suit pour y accéder et les installer :
1 Téléchargez et exécutez les exemples d’application AIR. Les applications compilées et le code source sont
disponibles.
2 Pour télécharger et exécuter un exemple d’application, cliquez sur le bouton Installer maintenant proposé. Vous
êtes invité à installer et exécuter l’application.
3 Si vous décidez de télécharger des exemples d’application et de les exécuter ultérieurement, sélectionnez les liens de
téléchargement. Vous pouvez à tout moment exécuter une application AIR en procédant comme suit :
Sous Windows, double-cliquez sur l’icône de l’application sur le bureau ou sélectionnez-la dans le menu
Démarrer de Windows.
Sous Mac OS, double-cliquez sur l’icône de l’application, qui est installée par défaut dans le dossier Applications
de votre répertoire utilisateur (tel que Macintosh HD/Users/Jean/Applications/).
Remarque : pour vérifier si ces instructions ont été mises à jour, voir les Notes de parution d’AIR, qui résident à l’adresse suivante : http://www.adobe.com/go/learn_air_relnotes_fr.

Mises à jour d’Adobe Air

6
Adobe met régulièrement Adobe AIR à jour pour ajouter de nouvelles fonctionnalités ou corriger des problèmes mineurs. La fonction de notification et de mise à jour automatiques permet à Adobe d’avertir automatiquement les utilisateurs de la disponibilité d’une version mise à jour d’Adobe AIR.
Les mises à jour d’Adobe AIR garantissent que ce produit fonctionne correctement et contiennent souvent d’importantes modifications liées à la sécurité. Adobe recommande d’effectuer la mise à jour vers toute nouvelle version disponible d’Adobe AIR, surtout lorsqu’elle affecte la sécurité.
Au lancement d’une application AIR, le moteur d’exécution vérifie par défaut la disponibilité d’une mise à jour. Il effectue cette opération si la dernière vérification remonte à plus de deux semaines. Si une mise à jour est disponible, AIR la télécharge en arrière-plan.
Il est possible de désactiver la fonction de mise à jour automatique à l’aide de l’application AIR SettingsManager. Cette application peut être téléchargée à partir de
http://airdownload.adobe.com/air/applications/SettingsManager/SettingsManager.air.
Le processus d’installation standard d’Adobe AIR se connecte à http://airinstall.adobe.com pour envoyer des informations de base sur l’environnement d’installation, notamment la version et la langue du système d’exploitation. Ces informations sont transmises une seule fois par installation et permettent à Adobe de confirmer que l’installation a abouti. Aucune information personnelle identifiable n’est collectée ou transmise.
Mise à jour des moteurs d’exécution captifs
Si vous distribuez votre application avec un paquet de moteur d’exécution captif, le moteur d’exécution captif n’est pas mis à jour automatiquement. Pour assurer la sécurité des utilisateurs, vous devez gérer les mises à jour publiées par Adobe et mettre à jour votre application avec la nouvelle version du moteur d’exécution lors de la publication d’une modification de sécurité importante.
Dernière mise à jour le 14/11/2013

Chapitre 3 : Utilisation des API AIR

Adobe® AIR® comprend des fonctionnalités dont ne dispose pas un contenu SWF qui s’exécute dans Adobe® Flash® Player.
Développeurs ActionScript 3.0
Les API Adobe AIR sont décrites dans les deux documents suivants :
Guide du développeur ActionScript 3.0
Guide de référence ActionScript 3.0 pour la plate-forme Adobe Flash
Développeurs HTML
Si vous créez des applications AIR de type HTML, les API disponibles en JavaScript via le fichier AIRAliases.js (voir
Accès aux classes de l’API AIR à partir de JavaScript) sont décrites dans les deux documents suivants :
HTML Developer’s Guide for Adobe AIR
Adobe AIR API Reference for HTML Developers
7

Classes ActionScript 3.0 propres à AIR

Le tableau suivant contient les classes d’exécution propres à Adobe AIR. Elles ne sont pas disponibles pour le contenu SWF s’exécutant dans Adobe® Flash® Player dans le navigateur.
Développeurs HTML
Les classes disponibles en JavaScript via le fichier AIRAliases.js sont décrites dans Adobe AIR API Reference for
HTML Developers (disponible en anglais uniquement).
Classe Package ActionScript 3.0 Ajoutée à la version AIR
ARecord flash.net.dns 2.0
AAAARecord flash.net.dns 2.0
ApplicationUpdater air.update 1.5
ApplicationUpdaterUI air.update 1.5
AudioPlaybackMode flash.media 3.0
AutoCapitalize flash.text 3.0
BrowserInvokeEvent flash.events 1.0
CameraPosition flash.media 3.0
CameraRoll flash.media 2.0
CameraRollBrowseOptions flash.media 3.0
CameraUI flash.media 2.5
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Utilisation des API AIR
Classe Package ActionScript 3.0 Ajoutée à la version AIR
CertificateStatus flash.security 2.0
CompressionAlgorithm flash.utils 1.0
DatagramSocket flash.net 2.0
DatagramSocketDataEvent flash.events 2.0
DNSResolver flash.net.dns 2.0
DNSResolverEvent flash.events 2.0
DockIcon flash.desktop 1.0
DownloadErrorEvent air.update.events 1.5
DRMAuthenticateEvent flash.events 1.0
DRMDeviceGroup flash.net.drm 3.0
DRMDeviceGroupErrorEvent flash.net.drm 3.0
DRMDeviceGroupEvent flash.net.drm 3.0
DRMManagerError flash.errors 1.5
8
EncryptedLocalStore flash.data 1.0
ExtensionContext flash.external 2.5
File flash.filesystem 1.0
FileListEvent flash.events 1.0
FileMode flash.filesystem 1.0
FileStream flash.filesystem 1.0
FocusDirection flash.display 1.0
GameInput flash.ui 3.0
GameInputControl flash.ui 3.0
GameInputControlType flash.ui 3.6 et versions antérieures ;
GameInputDevice flash.ui 3.0
GameInputEvent flash.ui 3.0
GameInputFinger flash.ui 3.6 et versions antérieures ;
GameInputHand flash.ui 3.6 et versions antérieures ;
abandonné à partir de la version 3.7
abandonné à partir de la version 3.7
abandonné à partir de la version 3.7
Geolocation flash.sensors 2.0
GeolocationEvent flash.events 2.0
HTMLHistoryItem flash.html 1.0
HTMLHost flash.html 1.0
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Utilisation des API AIR
Classe Package ActionScript 3.0 Ajoutée à la version AIR
HTMLLoader flash.html 1.0
HTMLPDFCapability flash.html 1.0
HTMLSWFCapabiltiy flash.html 2.0
HTMLUncaughtScriptExceptionEvent flash.events 1.0
HTMLWindowCreateOptions flash.html 1.0
Icon flash.desktop 1.0
IFilePromise flash.desktop 2.0
ImageDecodingPolicy flash.system 2.6
InteractiveIcon flash.desktop 1.0
InterfaceAddress flash.net 2.0
InvokeEvent flash.events 1.0
InvokeEventReason flash.desktop 1.5.1
IPVersion flash.net 2.0
9
IURIDereferencer flash.security 1.0
LocationChangeEvent flash.events 2.5
MediaEvent flash.events 2.5
MediaPromise flash.media 2.5
MediaType flash.media 2.5
MXRecord flash.net.dns 2.0
NativeApplication flash.desktop 1.0
NativeDragActions flash.desktop 1.0
NativeDragEvent flash.events 1.0
NativeDragManager flash.desktop 1.0
NativeDragOptions flash.desktop 1.0
NativeMenu flash.display 1.0
NativeMenuItem flash.display 1.0
NativeProcess flash.desktop 2.0
NativeProcessExitEvent flash.events 2.0
NativeProcessStartupInfo flash.desktop 2.0
NativeWindow flash.display 1.0
NativeWindowBoundsEvent flash.events 1.0
NativeWindowDisplayState flash.display 1.0
NativeWindowDisplayStateEvent flash.events 1.0
NativeWindowInitOptions flash.display 1.0
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Utilisation des API AIR
Classe Package ActionScript 3.0 Ajoutée à la version AIR
NativeWindowRenderMode flash.display 3.0
NativeWindowResize flash.display 1.0
NativeWindowSystemChrome flash.display 1.0
NativeWindowType flash.display 1.0
NetworkInfo flash.net 2.0
NetworkInterface flash.net 2.0
NotificationType flash.desktop 1.0
OutputProgressEvent flash.events 1.0
PaperSize flash.printing 2.0
PrintMethod flash.printing 2.0
PrintUIOptions flash.printing 2.0
PTRRecord flash.net.dns 2.0
ReferencesValidationSetting flash.security 1.0
10
ResourceRecord flash.net.dns 2.0
RevocationCheckSettings flash.security 1.0
Screen flash.display 1.0
ScreenMouseEvent flash.events 1.0
SecureSocket flash.net 2.0
SecureSocketMonitor air.net 2.0
ServerSocket flash.net 2.0
ServerSocketConnectEvent flash.events 2.0
ServiceMonitor air.net 1.0
SignatureStatus flash.security 1.0
SignerTrustSettings flash.security 1.0
SocketMonitor air.net 1.0
SoftKeyboardType flash.text 3.0
SQLCollationType flash.data 1.0
SQLColumnNameStyle flash.data 1.0
SQLColumnSchema flash.data 1.0
SQLConnection flash.data 1.0
SQLError flash.errors 1.0
SQLErrorEvent flash.events 1.0
SQLErrorOperation flash.errors 1.0
SQLEvent flash.events 1.0
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Utilisation des API AIR
Classe Package ActionScript 3.0 Ajoutée à la version AIR
SQLIndexSchema flash.data 1.0
SQLMode flash.data 1.0
SQLResult flash.data 1.0
SQLSchema flash.data 1.0
SQLSchemaResult flash.data 1.0
SQLStatement flash.data 1.0
SQLTableSchema flash.data 1.0
SQLTransactionLockType flash.data 1.0
SQLTriggerSchema flash.data 1.0
SQLUpdateEvent flash.events 1.0
SQLViewSchema flash.data 1.0
SRVRecord flash.net.dns 2.0
StageAspectRatio flash.display 2.0
11
StageOrientation flash.display 2.0
StageOrientationEvent flash.events 2.0
StageText flash.text 3.0
StageTextInitOptions flash.text 3.0
StageWebView flash.media 2.5
StatusFileUpdateErrorEvent air.update.events 1.5
StatusFileUpdateEvent air.update.events 1.5
StatusUpdateErrorEvent air.update.events 1.5
StatusUpdateEvent air.update.events 1.5
StorageVolume flash.filesystem 2.0
StorageVolumeChangeEvent flash.events 2.0
StorageVolumeInfo flash.filesystem 2.0
SystemIdleMode flash.desktop 2.0
SystemTrayIcon flash.desktop 1.0
TouchEventIntent flash.events 3.0
UpdateEvent air.update.events 1.5
Updater flash.desktop 1.0
URLFilePromise air.desktop 2.0
URLMonitor air.net 1.0
URLRequestDefaults flash.net 1.0
XMLSignatureValidator flash.security 1.0
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Utilisation des API AIR

Classes Flash Player contenant des fonctionnalités propres à AIR

Les classes suivantes sont disponibles pour les contenus SWF exécutés dans le navigateur, mais AIR offre des propriétés ou des méthodes supplémentaires :
12
Package Classe Propriété, méthode ou événement Ajoutée à la version
flash.desktop Clipboard supportsFilePromise 2.0
ClipboardFormats BITMAP_FORMAT 1.0
FILE_LIST_FORMAT 1.0
FILE_PROMISE_LIST_FORMAT 2.0
URL_FORMAT 1.0
flash.display LoaderInfo
Stage assignFocus() 1.0
childSandboxBridge 1.0
parentSandboxBridge 1.0
autoOrients 2.0
deviceOrientation 2.0
nativeWindow 1.0
orientation 2.0
Evénement orientationChange 2.0
Evénement orientationChanging 2.0
setAspectRatio 2.0
setOrientation 2.0
AIR
softKeyboardRect 2.6
supportedOrientations 2.6
supportsOrientationChange 2.0
NativeWindow owner 2.6
listOwnedWindows 2.6
NativeWindowInitOptions owner 2.6
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Utilisation des API AIR
13
Package Classe Propriété, méthode ou événement Ajoutée à la version
AIR
flash.events Event CLOSING 1.0
DISPLAYING 1.0
PREPARING 2.6
EXITING 1.0
HTML_BOUNDS_CHANGE 1.0
HTML_DOM_INITIALIZE 1.0
HTML_RENDER 1.0
LOCATION_CHANGE 1.0
NETWORK_CHANGE 1.0
STANDARD_ERROR_CLOSE 2.0
STANDARD_INPUT_CLOSE 2.0
STANDARD_OUTPUT_CLOSE 2.0
USER_IDLE 1.0
USER_PRESENT 1.0
HTTPStatusEvent
HTTP_RESPONSE_STATUS 1.0
responseHeaders 1.0
KeyboardEvent
responseURL 1.0
commandKey 1.0
controlKey 1.0
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Utilisation des API AIR
14
Package Classe Propriété, méthode ou événement Ajoutée à la version
AIR
flash.net FileReference extension 1.0
Evénement
uploadUnencoded() 1.0
NetStream Evénement
Evénement
preloadEmbeddedData() 1.5
resetDRMVouchers() 1.0
setDRMAuthenticationCredent ials()
httpResponseStatus 1.0
drmAuthenticate 1.0
onDRMContentData 1.5
1.0
URLRequest authenticate 1.0
cacheResponse 1.0
followRedirects 1.0
idleTimeout 2.0
manageCookies 1.0
useCache 1.0
userAgent 1.0
URLStream
événement httpResponseStatus
1.0
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Utilisation des API AIR
15
Package Classe Propriété, méthode ou événement Ajoutée à la version
flash.printing PrintJob active 2.0
copies 2.0
firstPage 2.0
isColor 2.0
jobName 2.0
lastPage 2.0
maxPixelsPerInch 2.0
paperArea 2.0
printableArea 2.0
printer 2.0
printers 2.0
selectPaperSize() 2.0
showPageSetupDialog() 2.0
start2() 2.0
supportsPageSetupDialog 2.0
terminate() 2.0
AIR
PrintJobOptions
flash.system Capabilities
LoaderContext
Security
flash.ui KeyLocation D_PAD 2.5
pixelsPerInch 2.0
printMethod 2.0
languages 1.1
allowLoadBytesCodeExecution 1.0
APPLICATION 1.0
La plupart de ces nouvelles propriétés et méthodes sont uniquement disponibles pour le contenu situé dans le sandbox de sécurité de l’application AIR. Toutefois, les nouveaux membres des classes URLRequest sont également disponibles pour le contenu exécuté dans d’autres sandbox.
Les méthodes
algorithm permettant de choisir entre les compressions deflate et zlib. Ce paramètre n’est disponible que pour le
ByteArray.compress() et ByteArray.uncompress() comprennent chacune un nouveau paramètre
contenu s’exécutant dans AIR.

Composants Flex propres à AIR

Les composants MX d’Adobe® Flex™ suivants sont disponibles lors du développement d’un contenu pour Adobe AIR :
FileEvent
FileSystemComboBox
FileSystemDataGrid
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Utilisation des API AIR
FileSystemEnumerationMode
FileSystemHistoryButton
FileSystemList
FileSystemSizeDisplayMode
FileSystemTree
FlexNativeMenu
HTML
Window
WindowedApplication
WindowedSystemManager
Par ailleurs, Flex 4 comprend les composants AIR spark suivants :
Window
WindowedApplication
Pour plus d’informations sur les composants AIR Flex, voir Utilisation des composants AIR de Flex.
16
Dernière mise à jour le 14/11/2013

Chapitre 4 : Outils de la plate-forme Adobe Flash pour le développement AIR

Vous pouvez développer des applications AIR à l’aide des outils de développement suivants de la plate-forme Adobe Flash.
Développeurs ActionScript 3.0 (Flash et Flex) :
Adobe Flash Professional (voir Publication pour AIR)
Kit SDK d’Adobe Flex 3.x et 4.x (voir « Configuration du kit SDK Flex » à la page 19 et « Outil AIR Developer
(ADT) » à la page 173)
Adobe Flash Builder (voir Développement d’applications AIR avec Flash Builder)
Développeurs HTML et Ajax :
Kit de développement SDK Adobe AIR (voir « Installation du kit de développement SDK AIR » à la page 17 et
« Outil AIR Developer (ADT) » à la page 173)
Adobe Dreamweaver CS3, CS4, CS5 (voir Extension AIR pour Dreamweaver)
17

Installation du kit de développement SDK AIR

Le kit de développement SDK AIR contient les outils de ligne de commande suivants, qui permettent de lancer et de mettre en package des applications :
Application de débogage du lanceur AIR (ADL) Permet de lancer des applications AIR sans devoir d’abord les installer.
Voir « Application de débogage du lanceur AIR (ADL) » à la page 167.
Outil AIR Developer (ADT) Met en package des applications AIR sous la forme de packages d’installation distribuables.
Voir « Outil AIR Developer (ADT) » à la page 173.
Les outils de ligne de commande d’AIR nécessitent l’installation de Java sur l’ordinateur. Vous pouvez utiliser la machine virtuelle Java à partir des environnements JRE ou JDK (version 1.5 ou ultérieure). Vous pouvez télécharger ces environnements à l’adresse suivante : http://java.sun.com/.
Vous devez disposer d’au moins 2 Go de mémoire pour exécuter l’outil ADT.
Remarque : l’utilisateur final n’a pas besoin de Java pour exécuter les applications AIR.
Pour consulter un aperçu rapide de la création d’une application AIR à l’aide du kit SDK d’AIR, voir « Création d’une
première application AIR de type HTML à l’aide du kit SDK d’AIR » à la page 34.

Téléchargement et installation du kit SDK AIR

Pour télécharger et installer le kit SDK AIR, procédez comme suit :
Installation du kit SDK AIR sous Windows
Téléchargez le fichier d’installation du kit SDK AIR.
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Outils de la plate-forme Adobe Flash pour le développement AIR
Il est distribué sous la forme d’une archive de fichier standard. Pour installer AIR, extrayez le contenu du kit SDK
dans un dossier sur l’ordinateur (exemple : C:\Program Files\Adobe\AIRSDK ou C:\AIRSDK).
Les outils ADL et ADT figurent dans le dossier bin du kit SDK AIR. Ajoutez le chemin de ce dossier à la variable
d’environnement PATH.
Installation du kit SDK AIR sous Mac OS X
Téléchargez le fichier d’installation du kit SDK AIR.
Il est distribué sous la forme d’une archive de fichier standard. Pour installer AIR, extrayez le contenu du kit SDK
dans un dossier sur l’ordinateur (exemple : /Users/<nomUtilisateur>/Applications/AIRSDK).
Les outils ADL et ADT figurent dans le dossier bin du kit SDK AIR. Ajoutez le chemin de ce dossier à la variable
d’environnement PATH.
Installation du kit SDK AIR sous Linux
Le kit SDK est disponible au format tbz2.
Pour installer le kit SDK, créez un dossier pour le décompresser, puis entrez la commande suivante : tar -jxvf
<chemin d’accès à AIR-SDK.tbz2>
Pour plus d’informations sur l’initiation aux outils du kit SDK AIR, voir Création d’une application AIR à l’aide des outils de ligne de commande.
18

Contenu du kit SDK AIR

Le tableau suivant décrit les fichiers que contient le kit SDK AIR :
Dossier du kit SDK Description des fichiers/outils
bin L’application de débogage du lanceur AIR (ADL) permet d’exécuter une application
frameworks Le répertoire libs contient des bibliothèques de code destinées aux applications AIR.
include Le répertoire include contient un fichier d’en-tête de langage C pour l’écriture
install Le répertoire install contient les pilotes USB Windows associés aux périphériques
lib Contient le code de prise en charge des outils du kit SDK d’AIR.
AIR sans la mettre en package et l’installer au préalable. Pour plus d’informations sur l’utilisation de cette application, voir « Application de débogage du lanceur AIR
(ADL) » à la page 167.
L’outil AIR Developer (ADT) met en package une application sous la forme d’un fichier AIR distribuable. Pour plus d’informations sur l’utilisation de cet outil, voir « Outil AIR
Developer (ADT) » à la page 173.
Le répertoire projects contient le code des bibliothèques SWF et SWC compilées.
d’extensions natives.
Android. (Ces pilotes sont fournis par Google dans le kit SDK d’Android.)
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Outils de la plate-forme Adobe Flash pour le développement AIR
Dossier du kit SDK Description des fichiers/outils
runtimes Moteurs d’exécution d’AIR destinés au bureau et aux périphériques mobiles.
L’application de débogage du lanceur AIR (ADL) utilise le moteur d’exécution pour lancer les applications AIR avant leur mise en package ou leur installation.
Vous pouvez installer les moteurs d’exécution d’AIR for Android (packages APK) sur des émulateurs ou des périphériques Android à des fins de développement ou de test. Utilisez un package APK distinct pour les périphériques et les émulateurs. (Vous pouvez télécharger le moteur d’exécution d’AIR for Android public à partir d’Android Market.)
19
samples Ce dossier contient un exemple de fichier descripteur d’application, un exemple de
templates descriptor-template.xml : modèle du fichier descripteur d’application, que requiert
fonction d’installation transparente (badge.swf) et les icônes d’application AIR par défaut.
chaque application AIR. Pour une description détaillée du fichier descripteur d’application, voir « Fichiers descripteurs d’applications AIR » à la page 215.
Ce dossier contient également les fichiers de schéma associés à la structure XML du fichier descripteur d’application de chaque version d’AIR.

Configuration du kit SDK Flex

Pour développer des applications Adobe® AIR® dans Adobe® Flex™, vous disposez des options suivantes :
Vous pouvez télécharger et installer Adobe® Flash® Builder™, qui intègre des outils permettant de créer des projets
Adobe AIR, ainsi que de tester, déboguer et mettre en package les applications AIR. Voir « Création d’une première
application de bureau AIR Flex dans Flash Builder » à la page 21.
Vous pouvez télécharger le kit SDK d’Adobe® Flex™ et développer des applications AIR Flex à l’aide de votre éditeur
de texte et de vos outils de ligne de commande favoris.
Pour consulter un aperçu rapide de la création d’une application AIR à l’aide du kit SDK de Flex, voir « Création d’une
première application de bureau AIR à l’aide du kit SDK de Flex » à la page 38.

Installation du kit SDK Flex

Pour pouvoir créer des applications AIR à l’aide des outils de ligne de commande, Java doit être installé sur l’ordinateur. Vous pouvez utiliser la machine virtuelle Java à partir des environnements JRE ou JDK (version 1.5 ou ultérieure). Vous pouvez télécharger ces environnements à l’adresse suivante : http://java.sun.com/.
Remarque : l’utilisateur final n’a pas besoin de Java pour exécuter les applications AIR.
Le kit SDK de Flex offre l’API d’AIR et les outils de ligne de commande nécessaires pour mettre en package, compiler et déboguer les applications AIR.
1 Le cas échéant, téléchargez le kit SDK Flex à partir de
http://opensource.adobe.com/wiki/display/flexsdk/Downloads.
2 Placez le contenu du kit SDK dans un dossier (Flex SDK, par exemple).
3 Copiez le contenu du kit SDK d’AIR sur les fichiers du kit SDK de Flex.
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Outils de la plate-forme Adobe Flash pour le développement AIR
Remarque : sur un ordinateur Mac, veillez à copier ou remplacer les fichiers des dossiers du kit SDK, plutôt que des répertoires entiers. Par défaut, copier un répertoire sur un répertoire du même nom sur un ordinateur Mac supprime les fichiers existants du répertoire cible, plutôt que de fusionner le contenu des deux répertoires. Vous pouvez utiliser la commande
air_sdk_folder flex_sdk_folder
4 Les outils de ligne de commande AIR figurent dans le dossier bin.
ditto dans une fenêtre de terminal pour fusionner le kit SDK d’AIR et le kit SDK de Flex :ditto

Configuration de kits SDK externes

Le développement d’applications pour Android et iOS nécessite de télécharger des fichiers de configuration, des kits SDK et autres outils de développement à partir des éditeurs de la plate-forme.
Pour plus d’informations sur le téléchargement et l’installation du kit SDK d’Android, voir Android Developers :
Installing the SDK (disponible en anglais uniquement). Depuis AIR 2.6, il n’est plus obligatoire de télécharger le kit
SDK d’Android. Le kit SDK d’AIR comprend à présent les composants de base requis pour installer et lancer des packages APK. Le kit SDK d’Android s’avère toutefois utile pour diverses tâches de développement, notamment la création et l’exécution d’émulateurs logiciels, ainsi que la capture d’écrans de périphérique.
Le développement d’application iOS ne requiert pas de kit SDK externe. Vous devez toutefois disposer de certificats et fichiers de configuration spéciaux. Pour plus d’informations, voir Obtention de fichiers de développement auprès
d’Apple.
20
Dernière mise à jour le 14/11/2013

Chapitre 5 : Création d’une première application AIR

Création d’une première application de bureau AIR Flex dans Flash Builder

Pour vous familiariser rapidement avec le fonctionnement d’Adobe® AIR®, suivez les instructions ci-dessous, qui permettent de créer et de mettre en package une application AIR SWF simple, appelée « Hello World », à l’aide d’Adobe® Flash® Builder.
Le cas échéant, téléchargez et installez Flash Builder. Téléchargez et installez également la version la plus récente d’Adobe AIR à partir de l’adresse suivante : www.adobe.com/go/air_fr.

Création d’un projet AIR

Flash Builder propose des outils de développement et de mise en package d’applications AIR.
21
Pour créer une application AIR dans Flash Builder ou Flex Builder, vous commencez comme s’il s’agissait de tout autre projet d’application Flex, c-à-d. en définissant un nouveau projet.
1 Ouvrez Flash Builder.
2 Sélectionnez Fichier > Nouveau > Projet Flex.
3 Attribuez au projet le nom AIRHelloWorld.
4 Dans Flex, les applications AIR sont considérées comme un type d’application. Vous disposez de deux options de
type :
Application Web qui s’exécute dans Adobe® Flash® Player
Application de bureau qui s’exécute dans Adobe AIR
Sélectionnez le type d’application de bureau.
5 Cliquez sur Terminer pour créer le projet.
Les projets AIR se composent initialement de deux fichiers : le fichier MXML principal et un fichier XML d’application (ou fichier descripteur d’application). Le second fichier spécifie les propriétés d’une application.
Pour plus d’informations, voir Développement d’applications AIR avec Flash Builder.

Ecriture du code de l’application AIR

Pour écrire le code de l’application « Hello World », vous modifiez le fichier MXML de l’application, qui est ouvert dans l’éditeur. (Le cas échéant, ouvrez le fichier dans l’explorateur de projets.)
Les applications AIR Flex de bureau sont contenues dans la balise MXML WindowedApplication. Celle-ci crée une fenêtre simple qui comprend des contrôles de fenêtre de base, tels qu’une barre de titre et un bouton de fermeture.
1 Ajoutez un attribut title au composant WindowedApplication et affectez-lui la valeur "Hello World" :
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Création d’une première application AIR
<?xml version="1.0" encoding="utf-8"?> <s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx" title="Hello World">
</s:WindowedApplication>
2 Ajoutez un composant Label à l’application (en le plaçant dans la balise WindowedApplication). Définissez la
propriété
<?xml version="1.0" encoding="utf-8"?> <s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009"
</s:WindowedApplication>
text du composant Label sur "Hello AIR" et stipulez qu’il doit être centré, comme illustré ci-dessous :
xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx" title="Hello World">
<s:Label text="Hello AIR" horizontalCenter="0" verticalCenter="0"/>
3 Ajoutez le bloc de style suivant juste après la balise WindowedApplication d’ouverture et avant la balise du
composant Label que vous venez d’entrer :
<fx:Style>
@namespace s "library://ns.adobe.com/flex/spark"; s|WindowedApplication {
skinClass:ClassReference("spark.skins.spark.SparkChromeWindowedApplicationSkin");
background-color:#999999; background-alpha:"0.7";
}
</fx:Style>
22
Ces paramètres de style s’appliquent à l’intégralité de l’application et définissent un arrière-plan de fenêtre gris légèrement transparent.
Le code de l’application se présente à présent comme suit :
<?xml version="1.0" encoding="utf-8"?> <s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx" title="Hello World">
<fx:Style>
@namespace s "library://ns.adobe.com/flex/spark"; s|WindowedApplication {
skinClass:ClassReference("spark.skins.spark.SparkChromeWindowedApplicationSkin");
background-color:#999999; background-alpha:"0.7";
}
</fx:Style>
<s:Label text="Hello AIR" horizontalCenter="0" verticalCenter="0"/>
</s:WindowedApplication>
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Création d’une première application AIR
Vous allez maintenant modifier certains paramètres dans le descripteur de l’application pour que celle-ci soit transparente :
1 Dans le panneau Navigation de Flex, recherchez le fichier descripteur d’application dans le répertoire source du
projet. Si vous avez nommé le projet AIRHelloWorld, ce fichier s’appelle AIRHelloWorld-app.xml.
2 Double-cliquez sur le fichier descripteur d’application pour le modifier dans Flash Builder.
3 Dans le code XML, recherchez les lignes de commentaire des propriétés systemChrome et transparent (de la
propriété
« --> »).
4 Définissez la valeur de texte de la propriété systemChrome sur none, comme indiqué ci-après :
<systemChrome>none</systemChrome>
5 Définissez la valeur de texte de la propriété transparent sur true, comme indiqué ci-après :
<transparent>true</transparent>
6 Enregistrez le fichier.
initialWindow). Supprimez les commentaires (autrement dit, supprimez les séparateurs « <!-- » et

Test de l’application AIR

Pour tester le code d’application que vous venez d’écrire, exécutez-le en mode de débogage.
23
1 Cliquez sur le bouton de débogage dans la barre d’outils principale.
Vous pouvez aussi sélectionner la commande Run > Debug > AIRHelloWorld.
L’application AIR qui en résulte s’apparente à l’exemple suivant :
2 Grâce aux propriétés horizontalCenter et verticalCenter du contrôle Label, le texte est placé au centre de la
fenêtre. Vous pouvez déplacer ou redimensionner la fenêtre comme pour toute autre application de bureau.
Remarque : si la compilation de l’application échoue, corrigez les erreurs de syntaxe ou les fautes d’orthographe introduites par inadvertance dans le code. Dans Flash Builder, les erreurs et les avertissements s’affichent en mode Problems.
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Création d’une première application AIR

Mise en package, signature et exécution de l’application AIR

Vous pouvez maintenant mettre l’application « Hello World » en package sous forme de fichier AIR pour la distribuer. Un fichier AIR est un fichier d’archives contenant les fichiers de l’application ; autrement dit, tous les fichiers qui figurent dans le dossier bin du projet. Dans cet exemple simple, il s’agit des fichiers SWF et XML. Vous distribuez le package AIR aux utilisateurs, qui s’en servent pour installer l’application. Dans le cadre de ce processus, il est impératif de signer le package numériquement.
1 Assurez-vous que l’application est exempte d’erreurs de compilation et s’exécute comme il se doit.
2 Sélectionnez Projet > Exporter vers une version validée.
3 Vérifiez que le projet correspond à AIRHelloWorld et l’application à AIRHelloWorld.mxml.
4 Sélectionnez l’option d’exportation en tant que package signé. Cliquez ensuite sur Suivant.
5 Si vous disposez déjà d’un certificat numérique, cliquez sur Parcourir pour y accéder, puis sélectionnez-le.
6 Si vous devez créer un certificat numérique auto-signé, sélectionnez Créer.
7 Spécifiez les informations requises et cliquez sur OK.
8 Cliquez sur Terminer pour générer le package AIR, qui s’appelle AIRHelloWorld.air.
Vous pouvez maintenant installer et exécuter l’application à partir de l’explorateur de projets dans Flash Builder ou en double-cliquant sur le fichier AIR dans le système de fichiers.
24

Création d’une première application de bureau AIR dans Flash Professional

Cette rubrique propose une brève démonstration pratique du fonctionnement d’Adobe® AIR® en vous aidant à créer et à mettre en package une application AIR simple nommée « Hello World » à l’aide d’Adobe® Flash® Professional.
Le cas échéant, téléchargez et installez Adobe AIR, à l’adresse suivante : www.adobe.com/go/air_fr.

Création de l’application Hello World dans Flash

La création d’une application Adobe AIR dans Flash ressemble beaucoup à la création d’un autre fichier FLA. La procédure suivante vous guide tout au long du processus de création de l’application Hello World simple avec Flash Professional.
Pour créer l’application Hello World
1 Démarrez Flash.
2 Dans l’écran de bienvenue, cliquez sur AIR pour créer un fichier FLA vide avec les paramètres de publication
d’Adobe AIR.
3 Sélectionnez l’outil Texte dans le panneau Outils et créez un champ de texte statique (par défaut) au centre de la
scène. Choisissez une largeur pouvant contenir 15 à 20 caractères.
4 Entrez le texte « Hello World » dans le champ.
5 Enregistrez le fichier en lui donnant un nom (HelloAIR, par exemple).
Dernière mise à jour le 14/11/2013
CRÉATION D’APPLICATIONS ADOBE AIR
Création d’une première application AIR

Test de l’application

1 Appuyez sur Ctrl + Entrée ou sélectionnez Contrôle > Tester l’animation > Tester pour tester l’application dans
Adobe AIR.
2 Pour utiliser la fonction Déboguer l’animation, ajoutez d’abord du code ActionScript à l’application. Vous pouvez
le faire rapidement en ajoutant une instruction trace telle que :
trace("Running AIR application using Debug Movie");
3 Appuyez sur Ctrl + Maj + Entrée ou sélectionnez Déboguer > Déboguer l’animation > Déboguer pour exécuter
l’application avec Déboguer l’animation.
L’application Hello World ressemble à l’illustration suivante :
25

Mise en package de l’application

1 Sélectionnez Fichier > Publier.
2 Signez le package Adobe AIR à l’aide d’un certificat numérique existant ou créez un certificat auto-signé en
procédant comme suit :
a Cliquez sur le bouton Créer en regard du champ Certificat.
b Renseignez les entrées Nom de l’éditeur, Unité d’organisation, Nom de l’organisation, E-mail, Pays, Mot de
passe et Confirmer le mot de passe.
c Spécifiez le type de certificat. L’option Type du certificat fait référence au niveau de sécurité : 1024-RSA utilise
une clé 1 024 bits (moins sécurisée) et 2048-RSA une clé 2 048 bits (plus sécurisée).
d Enregistrez les informations dans un fichier de certificat en renseignant l’entrée Enregistrer sous ou en cliquant
sur le bouton Parcourir... pour localiser un dossier. (Par exemple, C:/Temp/mycert.pfx). Lorsque vous avez terminé, cliquez sur OK.
e Flash vous renvoie à la boîte de dialogue Signature numérique. Le chemin et le nom de fichier du certificat auto-
signé s’affichent dans le champ de texte Certificat. Si ce n’est pas le cas, entrez le chemin et le nom du fichier ou cliquez sur le bouton Parcourir pour le localiser et le sélectionner.
Dernière mise à jour le 14/11/2013
Loading...
+ 294 hidden pages