Como utilizar extensões nativas para Adobe AIR

Os desenvolvedores de extensões nativas fazem a compactação de uma extensão nativa para um arquivo ANE. Um arquivo ANE é um arquivo de arquivo morto que contém as bibliotecas e recursos necessários para a extensão nativa.

Observe que, em alguns dispositivos, o arquivo ANE contém a biblioteca do código nativo que a extensão nativa utiliza. Mas para outros dispositivos a biblioteca do código nativo é instalada no dispositivo. Em alguns casos, a extensão nativa não tem nenhum código nativo para um dispositivo em particular; ele é implementado somente com o ActionScript.

Como um desenvolvedor de aplicativos do AIR, você utiliza o arquivo ANE da seguinte maneira:

O ActionScript 3.0 fornece uma classe NativeProcess. Essa classe permite que o aplicativo do AIR execute processos nativos no sistema operacional host. Essa capacidade é similar a extensões nativas, que fornecem acesso a recursos e bibliotecas específicas de plataforma. Ao decidir utilizar a classe NativeProcess em vez de utilizar uma extensão nativa, considere o seguinte:

• Somente o perfil extendedDesktop do AIR suporta a classe NativeProcess. Portanto, para aplicativos com os perfis mobileDevice e extendedMobileDevice do AIR, as extensões nativas são a única escolha.

• Os desenvolvedores de extensões nativas geralmente fornecem implementações nativas para várias plataformas, mas a API do ActionScript que eles fornecem são geralmente as mesmas plataformas cruzadas. Ao usar a classe NativeProcess, o código do ActionScript para iniciar o processo nativo pode variar entre as diferentes plataformas.

• A classe NativeProcess inicia um processo separado, enquanto que a extensão nativa é executada no mesmo processo do aplicativo do AIR. Portanto, se você está preocupado com o bloqueio de códigos, o uso da classe NativeProcess é mais seguro. No entanto, o processo separado significa que provavelmente você tem uma manipulação de comunicação de interprocessos para implementar.

Um arquivo SWC file é uma biblioteca da classe ActionScript em um formato de arquivo morto. O arquivo SWC contém um arquivo SWF e outros arquivos de recurso. O arquivo SWC é uma maneira conveniente de compartilhar classes ActionScript em vez de compartilhar arquivos ActionScript de recurso e de código individuais.

Um pacote de extensão nativa é um arquivo ANE. Assim como um arquivo SWC, um arquivo ANE também é uma biblioteca da classe ActionScript, que contém um arquivo SWF e outros arquivos de recurso em formato de arquivo morto. No entanto, a diferença mais importante entre um arquivo ANE file e um arquivo SWC é que somente um arquivo ANE pode obter uma biblioteca de código nativa.

A partir do AIR 3, é possível utilizar extensões nativas em aplicativos para os seguintes dispositivos:

Geralmente, a mesma extensão nativa é direcionada para múltiplas plataformas. O arquivo ANE da extensão contém bibliotecas do ActionScript e nativas para cada plataforma suportada. Geralmente, as bibliotecas do ActionScript possuem as mesmas interfaces públicas para todas as plataformas. As bibliotecas nativas são basicamente diferentes.

Às vezes, uma extensão nativa é compatível com uma plataforma padrão. A implementação da plataforma padrão tem somente o código do ActionScript, mas nenhum código nativo. Se você empacotar um aplicativo para uma plataforma que a extensão não suporte especificamente, o aplicativo utilizará a implementação padrão ao ser executado. Por exemplo, considere uma extensão que fornece um recurso que se aplica somente a dispositivos móveis. A extensão também poderá fornecer uma implementação padrão que um aplicativo de desktop poderá utilizar para simular o recurso.

Os seguintes perfis do AIR suportam extensões nativas:

Para usar uma extensão nativa no aplicativo, realize as seguintes tarefas:

1. Indique a extensão no arquivo de indexação do aplicativo.

2. Inclua o arquivo ANE no caminho da biblioteca do aplicativo.

3. Empacotar o aplicativo.

Todos os aplicativos do AIR possuem um arquivo de indexação do aplicativo Quando um aplicativo utiliza uma extensão nativa, o arquivo de indexação do aplicativo inclui um elemento <extensions> . Por exemplo:

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

O elemento extensionID tem o mesmo valor que o elemento id no arquivo descritor de extensão. O arquivo descritor da extensão é um arquivo XML chamado extension.xml. Ele é empacotado em um arquivo ANE. É possível utilizar uma ferramenta de extração de arquivo morto para visualizar o arquivo extension.xml.

Para compilar um aplicativo que utilize uma extensão nativa, inclua o arquivo ANE no caminho da biblioteca.

Use a ADT para empacotar um aplicativo que utilize extensões nativas. Não é possível empacotar o aplicativo usando o Flash Professional CS5.5 ou o Flash Builder 4.5.1.

Detalhes sobre o uso de ADT podem ser encontrados em Ferramenta do Desenvolvedor do AIR (ADT) .

Por exemplo, o seguinte comando de ADT cria um arquivo DMG (um arquivo de instalador nativo para o Mac OS X) para um aplicativo que utiliza extensões 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

O seguinte comando cria um pacote iOS para um aplicativo 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

Observe o seguinte:

• Utilize um tipo de pacote de instalador nativo.

• Especifique o diretório da extensão.

• Certifique-se de que o arquivo ANE suporte o dispositivo de destino do aplicativo.