Adobe AIR 用ネイティブ拡張の使用

ネイティブ拡張の開発者は、ネイティブ拡張を ANE ファイルにパッケージ化します。ANE ファイルは、ネイティブ拡張に必要なライブラリやリソースを含むアーカイブファイルです。

デバイスによっては、ネイティブ拡張で使用するネイティブコードライブラリが ANE ファイルに含まれている場合もあれば、ネイティブコードライブラリがデバイスにインストールされている場合もあります。また、特定のデバイスではネイティブコードがネイティブ拡張に全く含まれず、ActionScript のみで実装される場合もあります。

AIR アプリケーション開発者は、ANE ファイルを次のように使用します。

ActionScript 3.0 では、NativeProcess クラスが提供されます。このクラスを使用すると、AIR アプリケーションで、ホストオペレーティングシステム上でネイティブプロセスを実行できます。この機能はネイティブ拡張と類似しており、プラットフォーム固有の機能およびライブラリにアクセスできます。NativeProcess クラスを使用するかネイティブ拡張を使用するかを判断する際には、次の点を考慮してください。

• NativeProcess クラスをサポートするのは extendedDesktop AIR プロファイルのみです。したがって、AIR プロファイル mobileDevice および extendedMobileDevice を使用しているアプリケーションの場合は、ネイティブ拡張が唯一の選択肢です。

• ネイティブ拡張の開発者は、多くの場合、様々なプラットフォーム用のネイティブ実装を提供しますが、ネイティブ拡張の開発に伴って提供される ActionScript API は、通常、どのプラットフォームでも同じになります。NativeProcess クラスを使用する場合、ネイティブプロセスを開始するための ActionScript コードは、プラットフォームによって異なることがあります。

• NativeProcess クラスは別プロセスを開始します。一方、ネイティブ拡張は AIR アプリケーションと同じプロセスで実行されます。そのため、コードの失敗が懸念される場合は、NativeProcess クラスを使用する方が安全です。ただし、別プロセスになると、通常はプロセス間通信処理を実装することになります。

SWC ファイルは、アーカイブ形式の ActionScript クラスライブラリです。SWC ファイルには、SWF ファイルおよびその他のリソースファイルが含まれています。SWC ファイルは、ActionScript コードとリソースファイルを個々に共有するのではなく、ActionScript クラスを共有する場合に便利です。

ネイティブ拡張パッケージは ANE ファイルです。SWC ファイルと同様に、ANE ファイルも ActionScript クラスライブラリであり、SWF ファイルとその他のリソースファイルがアーカイブ形式で含まれています。ただし、ANE ファイルと SWC ファイルの最も重要な相違点は、ネイティブコードライブラリは ANE ファイルのみに含めることができるということです。

AIR 3 以降では、次のデバイス向けのネイティブ拡張を使用できます。

多くの場合、同じネイティブ拡張が複数のプラットフォームをターゲットにできます。拡張の ANE ファイルには、サポートされている各プラットフォーム用の ActionScript ライブラリとネイティブライブラリが含まれます。通常、ActionScript ライブラリのパブリックインターフェイスは、すべてのプラットフォームで同じです。ネイティブライブラリでは、プラットフォームごとに異なります。

ネイティブ拡張がデフォルトのプラットフォームをサポートする場合もあります。デフォルトプラットフォームの実装には、ActionScript コードのみが含まれ、ネイティブコードは含まれません。拡張で明確にサポートされていないプラットフォーム向けにアプリケーションをパッケージ化する場合、アプリケーションでは実行時にデフォルトの実装が使用されます。例えば、モバイルデバイスのみに適用される機能を備えた拡張の場合、この拡張でデフォルトの実装も提供することにより、デスクトップアプリケーションでもこの機能をシミュレーションすることができます。

ネイティブ拡張は以下の AIR プロファイルでサポートされています。

アプリケーションでネイティブ拡張を使用するには、次のタスクを実行します。

1. アプリケーション記述ファイルで拡張を宣言します。

2. アプリケーションのライブラリパスに ANE ファイルを含めます。

3. アプリケーションをパッケージ化します。

すべての AIR アプリケーションに、アプリケーション記述ファイルがあります。ネイティブ拡張を使用するアプリケーションのアプリケーション記述ファイルには、 <extensions> エレメントが含まれます。次に、例を示します。

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

extensionID エレメントは、拡張記述ファイルの id エレメントと同じ値です。拡張記述ファイルは、extension.xml という名前の XML ファイルです。これは ANE ファイルにパッケージ化されます。アーカイブ抽出ツールを使用して extension.xml ファイルを確認することができます。

ネイティブ拡張を使用するアプリケーションをコンパイルするには、ANE ファイルをライブラリパスに含めます。

ネイティブ拡張を使用するアプリケーションをパッケージ化するには、ADT を使用します。Flash Professional CS5.5 や Flash Builder 4.5.1 を使用してアプリケーションをパッケージ化することはできません。

ADT の使用方法について詳しくは、「 AIR 開発ツール（ADT） 」を参照してください。

例えば、以下の ADT コマンドでは、ネイティブ拡張を使用するアプリケーションの DMG ファイル（Mac OS X 用のネイティブインストーラーファイル）が作成されます。

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

以下のコマンドでは、iPhone アプリケーション用の iOS パッケージが作成されます。

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

次の点に注意してください。

• ネイティブインストーラーパッケージタイプを使用します。

• 拡張ディレクトリを指定します。

• ANE ファイルがアプリケーションのターゲットデバイスをサポートすることを確認します。