Uso di estensioni native per Adobe AIR

Quando impacchettano le estensioni native, gli sviluppatori creano dei file ANE. I file ANE sono file di archivio che contengono le librerie e le risorse necessarie per l'estensione nativa.

Tenete presente che per alcuni dispositivi il file ANE contiene la libreria dei codici nativi impiegati dall'estensione nativa. Tuttavia, per i restanti dispositivi, la libreria dei codici nativi è installata all'interno del dispositivo. In alcuni casi, l'estensione nativa non ha alcun codice nativo per un particolare dispositivo e viene implementata solo con ActionScript.

In qualità di sviluppatori di applicazioni AIR, potete utilizzare il file ANE come segue:

ActionScript 3.0 fornisce la classe NativeProcess, che consente a un'applicazione AIR di eseguire processi nativi nel sistema operativo host. Questa funzionalità è simile alle estensioni native, che consentono l'accesso a funzioni e librerie specifiche della piattaforma. Quando dovete decidere se utilizzare la classe NativeProcess o un'estensione nativa, considerate quanto segue:

• Solo il profilo AIR extendedDesktop supporta la classe NativeProcess. Di conseguenza, per le applicazioni con i profili AIR mobileDevice e extendedMobileDevice , le estensioni native sono la sola scelta possibile.

• Gli sviluppatori di estensioni native spesso forniscono implementazioni native per varie piattaforme, tuttavia l'API di ActionScript che forniscono è generalmente la stessa per tutte le piattaforme. Se si usa la classe NativeProcess, il codice ActionScript per avviare il processo nativo può variare da piattaforma a piattaforma.

• La classe NativeProcess avvia un processo separato, mentre un'estensione nativa esegue lo stesso processo dell'applicazione AIR. Di conseguenza, se avete problemi di blocco del codice, l'impiego della classe NativeProcess è meno rischioso. Tuttavia, un processo separato potrebbe implicare l'implementazione di una gestione delle comunicazioni tra processi.

Un file SWC è una libreria delle classi ActionScript in formato di archivio. Il file SWC contiene un file SWF e altri file di risorse. Il file SWC è un sistema pratico per condividere classi di ActionScript, anziché codice ActionScript individuale e file di risorse.

Un pacchetto di estensioni native è un file ANE. Come il file SWC, anche il file ANE è una libreria di classi di ActionScript contenente un file SWF e altri file di risorse in formato di archivio. Tuttavia, la differenza sostanziale tra un file ANE e un file SWC è che solo il file ANE può contenere una libreria di codici nativi.

A partire da AIR 3, potete usare le estensioni native nelle applicazioni per i seguenti dispositivi:

Spesso, una stessa estensione nativa può essere destinata a più piattaforme. Il file ANE dell'estensione contiene librerie native e di ActionScript per ogni piattaforma supportata. In genere, le librerie di ActionScript presentano le stesse interfacce pubbliche per tutte le piattaforme. Le librerie native sono necessariamente differenti.

Talvolta un'estensione nativa supporta una piattaforma predefinita. L'implementazione della piattaforma predefinita presenta solo codice ActionScript e nessun codice nativo. Se avete confezionato un'applicazione per una piattaforma non specificamente supportata dall'estensione, l'applicazione userà l'implementazione predefinita quando viene eseguita. Ad esempio, prendete in considerazione un'estensione che fornisce una funzione applicabile unicamente a dispositivi mobili. L'estensione può anche fornire un'implementazione predefinita che un'applicazione desktop può usare per simulare la funzione.

I seguenti profili AIR supportano le estensioni native:

Per utilizzare un'estensione nativa nella vostra applicazione, dovete eseguire le seguenti operazioni:

1. Dichiarare l'estensione nel file descrittore dell'applicazione.

2. Includere il file ANE nel percorso di libreria dell'applicazione.

3. Creare il pacchetto dell'applicazione.

Tutte le applicazioni AIR presentano un file descrittore dell'applicazione. Quando un'applicazione usa un'estensione nativa, il file descrittore dell'applicazione include l'elemento <extensions> . Ad esempio:

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

L'elemento extensionID ha lo stesso valore dell'elemento id nel file descrittore dell'estensione. Quest'ultimo è un file XML denominato extension.xml, impacchettato nel file ANE. Potete usare uno strumento di estrazione archivi per analizzare il file extension.xml.

Per compilare un'applicazione che impiega un'estensione, dovete includere il file ANE nel percorso di libreria.

Utilizzate ADT per creare il pacchetto di un'applicazione che usa estensioni native. Non potete creare il pacchetto dell'applicazione utilizzando Flash Professional CS5.5 o Flash Builder 4.5.1.

Per maggiori informazioni sull'uso di ADT, consultate il documento AIR Developer Tool (ADT) .

Ad esempio, il seguente comando ADT consente di creare un file DMG (un file di installazione nativo per Mac OS X) per un'applicazione che usa estensioni native:

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

Il seguente comando consente di creare un pacchetto iOS per un'applicazione di 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

Tenete presente quanto segue:

• Utilizzate un tipo di pacchetto di installazione nativo.

• Specificate la directory dell'estensione.

• Verificate che il file ANE supporti il dispositivo di destinazione dell'applicazione.