Native extensies gebruiken voor Adobe AIR

Ontwikkelaars van native extensies verpakken een native extensie in een ANE-bestand. Een ANE-bestand is een archiefbestand met de vereiste bibliotheken en bronnen voor de native extensie.

Voor bepaalde apparaten bevat het ANE-bestand de native codebibliotheek waarvan de native extensie gebruikmaakt. Maar voor andere apparaten wordt de native codebibliotheek op het apparaat geïnstalleerd. In sommige gevallen heeft de native extensie helemaal geen native code voor een bepaald apparaat. Deze wordt alleen geïmplementeerd met ActionScript.

Ontwikkelaars van AIR-toepassingen gebruiken het ANE-bestand als volgt:

ActionScript 3.0 verschaft een NativeProcess-klasse. Met deze klasse kan een AIR-toepassing native processen uitvoeren op het hostbesturingssysteem. Deze functie valt te vergelijken met native extensies die toegang verlenen tot platformspecifieke functies en bibliotheken. Neem het volgende in overweging wanneer u moet beslissen of u de NativeProcess-klasse of een native extensie gaat gebruiken:

• Alleen het AIR-profiel extendedDesktop biedt ondersteuning voor de NativeProcess-klasse. Voor toepassingen met de AIR-profielen mobileDevice en extendedMobileDevice zijn native extensies dus de enige mogelijkheid.

• Ontwikkelaars van native extensies verschaffen vaak native implementaties voor verschillende platforms, maar ze verschaffen doorgaans dezelfde ActionScript-API voor alle platforms. Wanneer de klasse NativeProcess wordt gebruikt, kan de ActionScript-code waarmee het native proces wordt gestart per platform variëren.

• De klasse NativeProcess start een afzonderlijk proces, terwijl een native extensie in hetzelfde proces als de AIR-toepassing wordt uitgevoerd. U kunt dus beter de NativeProcess-klasse gebruiken als u zich zorgen maakt over vastlopende code. De verschillende processen betekenen echter wel dat u wellicht communicatieafhandeling tussen de processen moet implementeren.

Een SWC-bestand is een ActionScript-klassebibliotheek in een archiefindeling. Het SWC-bestand bevat een SWF-bestand plus andere bronbestanden. SWC-bestanden vormen een handige manier om ActionScript-klassen te delen in plaats van afzonderlijke ActionScript-code en -bronbestanden te delen.

Een ANE-bestand is een native extensiepakket. Net als een SWC-bestand is een ANE-bestand ook een ActionScript-klassebibliotheek met een SWF-bestand en andere bronbestanden in een archiefindeling. Het belangrijkste verschil tussen ANE- en SWC-bestanden is echter dat alleen ANE-bestanden een native codebibliotheek kunnen bevatten.

In AIR 3 of later kunt u native extensies gebruiken in toepassingen voor de volgende apparaten:

Vaak richten native extensies zich op meerdere platforms. Het ANE-bestand van de extensie bevat ActionScript-bibliotheken en native bibliotheken voor elk ondersteund platform. De ActionScript-bibliotheken hebben doorgaans dezelfde openbare interfaces voor alle platforms. De native bibliotheken zijn vanzelfsprekend anders.

Soms biedt een native extensie ondersteuning voor een standaardplatform. De implementatie van het standaardplatform heeft alleen ActionScript-code, maar geen native code. Als u een toepassing in een pakket plaatst voor een platform waarvoor de extensie niet op expliciete wijze ondersteuning biedt, gebruikt de toepassing de standaardimplementatie tijdens de uitvoering. Neem bijvoorbeeld een extensie die een functie verschaft die alleen van toepassing is op mobiele apparatuur. De extensie kan ook een standaardimplementatie verschaffen die een bureaubladtoepassing kan gebruiken om de functie te simuleren.

De volgende AIR-profielen bieden ondersteuning voor native extensies:

Voer de volgende taken uit om een native extensie te gebruiken in uw toepassing:

1. Declareer de extensie in het descriptorbestand van de toepassing.

2. Neem het ANE-bestand op in het bibliotheekpad van uw toepassing.

3. Plaats de toepassing in een pakket.

Alle AIR-toepassingen hebben een descriptorbestand van de toepassing. Wanneer een toepassing een native extensie gebruikt, beschikt het descriptorbestand van de toepassing over een <extensions> -element. Bijvoorbeeld:

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

Het extensionID -element heeft dezelfde waarde als het element id in het descriptorbestand van de extensie. Het descriptorbestand van de extensie is een XML-bestand met de naam ''extension.xml''. Dit bestand is in een pakket met het ANE-bestand geplaatst. Zoek met een hulpprogramma voor het decomprimeren van archiefbestanden naar het bestand extension.xml.

Neem het ANE-bestand op in uw bibliotheekpad als u een toepassing wilt compileren die een native extensie gebruikt.

Gebruik ADT om een toepassing die native extensies gebruikt in een pakket te plaatsen. Het is niet mogelijk de toepassing met gebruik van Flash Professional CS5.5 of Flash Builder 4.5.1 in een pakket te plaatsen.

Op AIR Developer Tool (ADT) vindt u informatie over het gebruik van ADT.

Met de volgende ADT-opdracht maakt u bijvoorbeeld een DMG-bestand (een native installatiebestand voor Mac OS X) voor een toepassing die native extensies gebruikt:

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

En met de volgende opdracht maakt u een iOS-pakket voor een iPhone-toepassing:

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

Let wel:

• Gebruik een pakkettype met een native installatieprogramma.

• Geef de extensiemap op.

• Zorg ervoor dat het ANE-bestand het doelapparaat van de toepassing ondersteunt.