Använda ANE-tillägg för Adobe AIR

ANE-utvecklare paketerar ANE-tilläggen i en ANE-fil. En ANE-fil är en arkivfil som innehåller de nödvändiga biblioteken och resurserna för ANE-tillägget.

Tänk på att för vissa enheter innehåller ANE-filen det systemspecifika kodbiblioteket som används i ANE-tilläggen. För andra enheter installeras emellertid det systemspecifika kodbiblioteket på enheten. I vissa fall saknar ANE-tillägget systemspecifik kod för en speciell enhet, eftersom den endast implementeras med ActionScript.

Om du är AIR-utvecklare använder du ANE-filer på följande sätt:

I ActionScript 3.0 finns en NativeProcess-klass. Klassen gör att ett AIR-program kan köra systemspecifika processer i värdoperativsystemet. Detta påminner om ANE-tillägg som ger åtkomst till plattformsspecifika funktioner och bibliotek. När du väljer mellan att använda klassen NativeProcess eller ett ANE-tillägg ska du tänka på följande:

• Endast AIR-profilen extendedDesktop har stöd för klassen NativeProcess. ANE-tillägg är därför det enda alternativet för program med AIR-profilerna , mobileDevice och extendedMobileDevice .

• ANE-utvecklare skapar ofta systemspecifika implementationer för olika plattformar, men det ActionScript-API som används är vanligtvis detsamma för alla plattformar. När klassen NativeProcess används, kan den ActionScript-kod som ska inleda den systemspecifika processen variera mellan olika plattformar.

• Klassen NativeProcess startar en separat process, medan ett ANE-tillägg körs i samma process som AIR-programmet. Detta innebär, om du är orolig för att koden ska krascha, att du ska använda klassen NativeProcess eftersom den är säkrare. Olika processer innebär emellertid att du troligtvis måste implementera kommunikationshantering mellan processerna.

En SWC-fil är ett ActionScript-klassbibliotek i ett arkivformat. SWC-filen innehåller en SWF-fil och ytterligare resursfiler. SWC-filer är ett bekvämt sätt att dela ActionScript-klasser i stället för att dela enskild ActionScript-kod och resursfiler.

Ett systemspecifikt tilläggspaket är en ANE-fil. Precis som en SWC-fil, är en ANE-fil även ett ActionScript-klassbibliotek med en SWF-fil och andra resursfiler i ett arkivformat. Den viktigaste skillnaden mellan en ANE-fil och en SWC-fil är att en ANE-fil kan innehålla ett systemspecifikt kodbibliotek.

Från och med AIR 3 kan du använda ANE-tillägg i program för följande enheter:

Det går ofta att använda samma ANE-tillägg för flera plattformar. Tilläggets ANE-fil innehåller ActionScript och systemspecifika bibliotek för varje plattform som stöds. Vanligtvis används samma publika gränssnitt för ActionScript-bibliotek på alla plattformar. De systemspecifika biblioteken är annorlunda.

Ibland har ANE-tillägg stöd för en standardplattform. Implementationen av standardplattformen innehåller endast ActionScript-kod, ingen systemspecifik kod. Om du paketerar ett program för en plattform som tillägget inte direkt har stöd för, kommer programmet att använda standardimplementationen när det körs. Tänk dig till exempel ett tillägg med en funktion som endast gäller för mobila enheter. Tillägget kan även tillhandahålla en standardimplementation som ett datorprogram kan använda för att simulera funktionen.

Följande AIR-profiler har stöd för ANE-tillägg:

Gör följande för att använda ANE-tillägg i dina program:

1. Deklarera tillägget i programbeskrivningsfilen.

2. Inkludera ANE-filen i programmets bibliotekssökväg.

3. Paketera programmet.

Alla AIR-program har en programbeskrivningsfil. När ett program använder ANE-tillägg, kommer programbeskrivningsfilen att inkludera ett <extensions> -element. Till exempel:

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

Elementet extensionID har samma värde som elementet id i tilläggsbeskrivningsfilen. Tilläggsbeskrivningsfilen är en XML-fil med namnet extension.xml. Den paketeras i en ANE-fil. Du kan använda ett arkivextraheringsverktyg för att läsa extension.xml-filen.

Inkludera ANE-filen i bibliotekssökvägen när du kompilerar ett program som använder ett ANE-tillägg.

Använd ADT för att paketera ett program som använder ANE-tillägg. Du kan inte paketera programmet med Flash Professional CS5.5 eller Flash Builder 4.5.1.

Mer information om ADT finns på AIR Developer Tool (ADT) .

Exempelvis skapar följande ADT-kommandon en DMG-fil (en systemspecifik installationsfil för Mac OS X) för ett program som använder ANE-tillägg:

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

Följande kommando skapar ett iOS-paket för ett iPhone-program:

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

Tänk på följande:

• Använd en systemspecifik typ av installationspaket.

• Ange tilläggskatalogen.

• Kontrollera att ANE-filen har stöd för programmets målenhet.