Verwenden von nativen Erweiterungen für Adobe AIR

Entwickler von nativen Erweiterungen verpacken eine native Erweiterung in einer ANE-Datei. Eine ANE-Datei ist eine Archivdatei, die die erforderlichen Bibliotheken und Ressourcen für die native Erweiterung enthält.

Beachten Sie, dass die ANE-Datei bei einigen Geräten die native Codebibliothek enthält, die die native Erweiterung verwendet. Bei anderen Geräten dagegen ist die Bibliothek mit dem nativen Code auf dem Gerät installiert. In einigen Fällen hat die native Erweiterung gar keinen nativen Code für ein bestimmtes Gerät; in diesem Fall wird sie nur mit ActionScript implementiert.

Als Entwickler von AIR-Anwendungen verwenden Sie die ANE-Datei folgendermaßen:

ActionScript 3.0 stellt eine NativeProcess-Klasse bereit. Mithilfe dieser Klasse kann eine AIR-Anwendung native Prozesse auf dem Host-Betriebssystem ausführen. Diese Fähigkeit ähnelt nativen Erweiterungen, die Zugriff auf plattformspezifische Funktionen und Bibliotheken ermöglichen. Wenn Sie überlegen, ob Sie die NativeProcess-Klasse oder eine native Erweiterung verwenden sollen, beachten Sie Folgendes:

• Nur das AIR-Profil extendedDesktop unterstützt die NativeProcess-Klasse. Deshalb sind native Erweiterungen die einzige Möglichkeit für Anwendungen mit dem AIR-Profil mobileDevice oder extendedMobileDevice .

• Entwickler von nativen Erweiterungen stelle häufig native Implementierungen für verschiedene Plattformen bereit; die ActionScript-API, die sie bereitstellen, ist normalerweise jedoch bei allen Plattformen identisch. Wenn die NativeProcess-Klasse verwendet wird, kann der ActionScript-Code zum Starten des nativen Prozesses sich zwischen den verschiedenen Plattformen unterscheiden.

• Die NativeProcess-Klasse startet einen separaten Prozess, während eine native Erweiterung im selben Prozess wie die AIR-Anwendung ausgeführt wird. Wenn Sie Bedenken wegen Code-Abstürzen haben, ist das Verwenden der NativeProcess-Klasse sicherer. Der separate Prozess bedeutet jedoch, dass Sie möglicherweise die Verarbeitung von Kommunikation zwischen Prozessen implementieren müssen.

Eine SWC-Datei ist eine ActionScript-Klasse in einem Archivformat. Die SWC-Datei enthält eine SWF-Datei und andere Ressourcendateien. Die SWC-Datei ist eine praktische Möglichkeit, ActionScript-Klassen gemeinsam zu verwenden, anstatt einzelne ActionScript-Code- und Ressourcendateien zu verwenden.

Ein Paket mit einer nativen Erweiterung ist eine ANE-Datei. Wie eine SWC-Datei ist auch eine ANE-Datei eine ActionScript-Klassenbibliothek, die eine SWF-Datei und andere Ressourcendateien im Archivformat enthält. Der wichtigste Unterschied zwischen einer ANE-Datei und einer SWC-Datei besteht darin, dass nur eine ANE-Datei eine Bibliothek mit nativem Code enthalten kann.

Ab AIR 3 können Sie native Erweiterungen in Anwendungen für die folgenden Geräte verwenden:

Häufig zielt eine native Erweiterung auf mehrere Plattformen ab. Die ANE-Datei der Erweiterung enthält ActionScript und native Bibliotheken für jede unterstützte Plattform. Normalerweise haben die ActionScript-Bibliotheken dieselben öffentlichen Schnittstellen für alle diese Plattformen. Die nativen Bibliotheken unterscheiden sich jedoch notwendigerweise.

Manchmal unterstützt eine native Erweiterung eine Standardplattform. Die Implementierung der Standardplattform hat nur ActionScript-Code, keinen nativen Code. Wenn Sie eine Anwendung für eine Plattform verpacken, die von der Erweiterung nicht ausdrücklich unterstützt wird, verwendet die Anwendung bei der Ausführung die Standardimplementierung. Denken Sie zum Beispiel an eine Erweiterung, die eine Funktion bereitstellt, die nur für mobile Geräte zutrifft. Die Erweiterung kann auch eine Standardimplementierung bereitstellen, mit der eine Desktopanwendung die Funktion simulieren kann.

Die folgenden AIR-Profile unterstützen native Erweiterungen:

Führen Sie die folgenden Aufgaben aus, um eine native Erweiterung in Ihrer Anwendung zu verwenden:

1. Deklarieren Sie die Erweiterung in Ihrer Anwendungsdeskriptordatei.

2. Schließen Sie die ANE-Datei in den Bibliothekspfad Ihrer Anwendung ein.

3. Verpacken Sie die Anwendung.

Alle AIR-Anwendungen haben eine Anwendungsdeskriptordatei. Wenn eine Anwendung eine native Erweiterung verwendet, enthält die Anwendungsdeskriptordatei ein <extensions> -Element. Zum Beispiel:

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

Das extensionID -Element hat denselben Wert wie das id -Element in der Erweiterungsdeskriptordatei. Die Erweiterungsdeskriptordatei ist eine XML-Datei mit dem Namen „extension.xml“. Sie ist in der ANE-Datei verpackt. Sie können ein Programm zum Extrahieren von Archiven verwenden, um sich die Datei „extension.xml“ anzusehen.

Um eine Anwendung zu kompilieren, die eine native Erweiterung verwendet, schließen Sie die ANE-Datei in den Bibliothekspfad ein.

Verpacken Sie Anwendungen, die native Erweiterungen verwenden, mit ADT. Sie können die Anwendung nicht mit Flash Professional CS5.5 oder Flash Builder 4.5.1 verpacken.

Ausführliche Informationen zur Verwendung von ADT finden Sie unter AIR Developer Tool (ADT) .

Der folgende ADT-Befehl erstellt zum Beispiel eine DMG-Datei (ein natives Installationsprogramm für Mac OS X) für eine Anwendung, die native Erweiterungen verwendet:

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

Der folgende Befehl erstellt ein iOS-Paket für eine iPhone-Anwendung:

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

Beachten Sie Folgendes:

• Verwenden Sie einen nativen Installerpakettyp.

• Legen Sie den Erweiterungsordner fest.

• Stellen Sie sicher, dass die ANE-Datei das Zielgerät der Anwendung unterstützt.