Uso de extensiones nativas para Adobe AIR

Los desarrolladores de extensiones nativas empaquetan una extensión nativa en un archivo ANE. Un archivo ANE es un archivador que contiene las bibliotecas y los recursos necesarios para la extensión nativa.

En algunos dispositivos, el archivo ANE contiene la biblioteca del código nativo que utiliza la extensión nativa. En otros, la biblioteca del código nativo se instala en el dispositivo. En algunos casos, la extensión nativa no tiene ningún código nativo para un dispositivo concreto; se implementa solamente con ActionScript.

Como desarrollador de una aplicación de AIR, utilizará el archivo ANE del modo siguiente:

ActionScript 3.0 proporciona una clase NativeProcess. Esta clase permite que una aplicación de AIR ejecute procesos nativos en el sistema operativo del host. Esta función es parecida a las extensiones nativas, que proporcionan acceso a funciones y bibliotecas específicas de la plataforma. Si decide utilizar la clase NativeProcess y no una extensión nativa, tenga en cuenta lo siguiente:

• El perfil de AIR extendedDesktop es el único que admite la clase NativeProcess. Por lo tanto, para las aplicaciones con perfiles de AIR mobileDevice y extendedMobileDevice , las extensiones nativas son la única opción.

• Los desarrolladores de extensiones nativas a menudo proporcionan implementaciones nativas para varias plataformas, pero la API de ActionScript que se incluye suele ser la misma para todas. Si utiliza la clase NativeProcess, el código ActionScript para iniciar el proceso nativo puede variar en función de la plataforma.

• La clase NativeProcess inicia un proceso independiente, mientras que una extensión nativa se ejecuta en el mismo proceso que la aplicación de AIR. Por ello, si le preocupa que el código pueda bloquearse, utilizar la clase NativeProcess es lo más fiable. Sin embargo, un proceso independiente implica que posiblemente deba implementar gestión de comunicaciones entre procesos.

Un archivo SWC es una biblioteca de clases de ActionScript en formato archivador. El archivo SWC contiene un archivo SWF así como otros archivos de recursos. El archivo SWC es una forma cómoda de compartir clases de ActionScript sin tener que compartir el código ActionScript individual y los archivos de recursos.

Un paquete de extensiones nativas es una archivo ANE. Al igual que un archivo SWC, un archivo ANE también es una biblioteca de clases de ActionScript que contiene un archivo SWF y otros archivos de recursos en formato archivador. No obstante, la diferencia más importante entre un archivo ANE y uno SWC reside en que solamente el archivo ANE puede contener una biblioteca del código nativo.

Desde AIR 3, se pueden utilizar extensiones nativas en aplicaciones para los siguientes dispositivos:

A menudo, la misma extensión nativa está destinada a varias plataformas. El archivo ANE de la extensión contiene bibliotecas de ActionScript y nativas para cada plataforma admitida. Normalmente, las bibliotecas de ActionScript tienen las mismas interfaces públicas para todas las plataformas. Las bibliotecas nativas son necesariamente distintas.

A veces, una extensión nativa admite una plataforma en concreto. La implementación predeterminada de la plataforma solo tiene código ActionScript, no código nativo. Si empaqueta una aplicación para una plataforma no admitida específicamente por la extensión, la aplicación utilizará la implementación predeterminada al ejecutarla. Por ejemplo, consideremos una extensión que proporciona una función que se aplica solamente a dispositivos móviles. La extensión también puede proporcionar una implementación predeterminada que la aplicación de escritorio puede usar para simular la función.

Los siguientes perfiles de AIR admiten extensiones nativas:

Para utilizar una extensión nativa en la aplicación, lleve a cabo las siguientes tareas:

1. Declare la extensión en el archivo descriptor de la aplicación.

2. Incluya el archivo ANE en la ruta de la biblioteca de la aplicación.

3. Empaquete la aplicación.

Todas las aplicaciones de AIR tienen un archivo descriptor de la aplicación. Cuando una aplicación utiliza una extensión nativa, el archivo descriptor de la aplicación incluye un elemento <extensions> . Por ejemplo:

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

El elemento extensionID tiene el mismo valor que id en el archivo descriptor de la extensión. El archivo descriptor de la extensión es un archivo XML denominado extension.xml. Se empaqueta en el archivo ANE. Puede utilizar una herramienta extractora de archivos para buscar el archivo extension.xml.

Para compilar una aplicación que utilice una extensión nativa, incluya el archivo ANE en la ruta de la biblioteca.

Utilice ADT para empaquetar una aplicación con extensiones nativas. No es posible empaquetar la aplicación con Flash Professional CS5.5 o Flash Builder 4.5.1.

Para obtener más información sobre ADT, consulte AIR Developer Tool (ADT) .

Por ejemplo, el siguiente comando ADT crea un archivo DMG (un archivo de instalación nativo para Mac OS X) para una aplicación que utiliza extensiones nativas:

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

El siguiente comando crea un paquete iOS para una aplicación de 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

Debe tener en cuenta lo siguiente:

• Utilice un tipo de paquete de archivo de instalación nativo.

• Especifique el directorio de la extensión.

• Asegúrese de que el dispositivo de destino de la aplicación admite el archivo ANE.