Utilisation d’extensions natives pour Adobe AIR

Les développeurs d’extensions natives mettent en package une extension native dans un fichier ANE. Un fichier ANE est un fichier archive qui contient les bibliothèques et les ressources nécessaires à l’extension native.

Notez que pour certains périphériques, le fichier ANE contient la bibliothèque de code natif qu’utilise l’extension native. Pour d’autres, la bibliothèque de code natif est installée sur le périphérique. Dans certains cas, l’extension native ne possède pas de code natif pour un périphérique donné, elle est implémentée avec ActionScript uniquement.

En tant que développeur d’applications AIR, vous devez utiliser le fichier ANE de la manière suivante :

ActionScript 3.0 fournit une classe NativeProcess. Cette classe permet à une application AIR d’exécuter des processus natifs sur le système d’exploitation hôte. Cette fonctionnalité est similaire aux extensions natives, qui permettent d’accéder aux fonctions et aux bibliothèques propres à la plate-forme. Si vous hésitez entre l’utilisation de la classe NativeProcess et l’utilisation d’une extension native, tenez compte des points suivants :

• Seul le profil AIR extendedDesktop prend en charge la classe NativeProcess. Ainsi, pour les applications dotées des profils AIR mobileDevice et extendedMobileDevice , les extensions natives constituent la seule option.

• Les développeurs d’extensions natives proposent souvent des implémentations natives pour diverses plates-formes, mais l’API ActionScript qu’ils fournissent est généralement la même sur toutes les plates-formes. Lors de l’utilisation de la classe NativeProcess, le code ActionScript permettant de lancer le processus natif peut varier selon les plates-formes.

• La classe NativeProcess lance un processus distinct, tandis que l’extension native exécute le même processus que l’application AIR. Par conséquent, si le blocage de code vous préoccupe, utilisez la classe NativeProcess pour plus de sécurité. Un processus distinct signifie néanmoins que vous devrez probablement gérer la communication entre les processus.

Un fichier SWC est une bibliothèque de classes ActionScript dans un format d’archive. Le fichier SWC contient un fichier SWF et d’autres fichiers de ressources. Le fichier SWC permet de partager des classes ActionScript au lieu de partager du code ActionScript et des fichiers de ressources individuels.

Un package d’extensions natives est un fichier ANE. À l’instar d’un fichier SWC, un fichier ANE est une bibliothèque de classes ActionScript contenant un fichier SWF et d’autres fichiers de ressources dans un format d’archive. Toutefois, la principale différence entre un fichier ANE et un fichier SWC est que seul le fichier ANE peut contenir une bibliothèque de code natif.

A partir d’AIR 3, vous pouvez utiliser des extensions natives dans les applications pour les périphériques suivants :

Il n’est pas rare que la même extension native cible plusieurs plates-formes. Le fichier ANE de l’extension contient les bibliothèques ActionScript et les bibliothèques natives pour chaque plate-forme prise en charge. En règle générale, les bibliothèques ActionScript disposent des mêmes interfaces publiques pour toutes les plates-formes. Les bibliothèques natives sont nécessairement différentes.

Une extension native prend parfois en charge une plate-forme par défaut. L’implémentation de la plate-forme par défaut possède uniquement du code ActionScript. Si vous mettez en package une application pour une plate-forme que l’extension ne prend pas spécifiquement en charge, l’application fait appel à l’implémentation par défaut lors de son exécution. Par exemple, prenez le cas d’une extension disposant d’une fonction qui s’applique uniquement aux périphériques mobiles. L’extension peut également fournir une implémentation par défaut à laquelle peut faire appel une application de bureau pour simuler cette fonction.

Les profils AIR suivants prennent en charge les extensions natives :

Pour utiliser une extension native dans votre application, procédez de la façon suivante :

1. Déclarez l’extension dans le fichier descripteur de votre application.

2. Ajoutez le fichier ANE au chemin d’accès à la bibliothèque de l’application.

3. Mettez en package l’application.

Toutes les applications AIR possèdent un fichier descripteur de l’application. Lorsqu’une application utilise une extension native, le fichier descripteur de l’application inclut un élément <extensions> . Exemple :

<extensions> 
    <extensionID>com.example.Extension1</extensionID> 
    <extensionID>com.example.Extension2</extensionID> 
</extensions>

La valeur de l’élément extensionID est identique à celle de l’élément id dans le fichier descripteur de l’extension. Le fichier descripteur de l’extension est un fichier XML appelé extension.xml. Il est mis en package dans le fichier ANE. Vous pouvez utiliser un outil d’extraction pour accéder au fichier extension.xml.

Pour compiler une application qui utilise une extension native, ajoutez le fichier ANE au chemin d’accès à la bibliothèque.

Utilisez l’outil AIR Developer (ADT) pour mettre en package une application faisant appel à des extensions natives. Vous ne pouvez pas mettre en package l’application avec Flash Professional CS5.5 ou Flash Builder 4.5.1.

Pour plus d’informations sur l’utilisation d’ADT, voir Outil AIR Developer (ADT) .

Par exemple, la commande d’ADT suivante crée un fichier DMG (fichier de programme d’installation natif pour Mac OS X) pour une application faisant appel à des extensions natives :

adt -package 
    -storetype pkcs12 
    -keystore myCert.pfx 
    -target native 
    myApp.dmg 
    application.xml 
    index.html resources 
    -extdir extensionsDir

adt -package 
    -target apk 
    -storetype pkcs12 -keystore ../codesign.p12 
    myApp.apk 
    myApp-app.xml 
    myApp.swf icons 
    -extdir extensionsDir

La commande suivante crée un package iOS pour une application iPhone :

adt -package 
    -target ipa-ad-hoc 
    -storetype pkcs12 -keystore ../AppleDistribution.p12 
    -provisioning-profile AppleDistribution.mobileprofile 
    myApp.ipa 
    myApp-app.xml 
    myApp.swf icons Default.png 
    -extdir extensionsDir

Remarques importantes :

• Utilisez un package de type programme d’installation natif.

• Spécifiez le répertoire de l’extension.

• Assurez-vous que le fichier ANE prend en charge le périphérique cible de l’application.