使用 Adobe AIR 的原生擴充功能

原生擴充功能開發人員會將原生擴充功能封裝成 ANE 檔案。ANE 檔案是包含原生擴充功能必要元件庫與資源的封存檔案。

請注意，在某些裝置中，ANE 檔案包含原生擴充功能使用的原生程式碼元件庫。但在其他裝置上，原生程式碼元件庫是安裝於裝置。在某些案例中，原生擴充功能完全沒有特定裝置的原生程式碼；僅以 ActionScript 來實作。

您身為 AIR 應用程式開發人員，應依照以下方式使用 ANE 檔案：

ActionScript 3.0 提供 NativeProcess 類別。此類別可以讓 AIR 應用程式在主機作業系統上執行原生處理程序。此功能與原生擴充功能相似，可讓您存取特定平台功能與元件庫。比較並決定使用 NativeProcess 類別或原生擴充功能時，請考量以下幾點：

• 僅有 extendedDesktop AIR 描述檔支援 NativeProcess 類別。因此，在 AIR 描述檔為 mobileDevice 和 extendedMobileDevice 的應用程式中，原生功能擴充是唯一的選擇。

• 原生擴充功能開發人員經常提供不同平台的原生實作，但是他們提供的 ActionScript API，通常是跨平台皆相同。使用 NativeProcess 類別時，視不同的平台而定，要啟動原生處理程序的 ActionScript 程式碼也可能有所差異。

• NativeProcess 類別會啟動個別處理程序，而原生擴充功能會在與 AIR 應用程式相同的處理程序中執行。因此，如果您擔心程式碼當掉，使用 NativeProcess 類別比較保險。但是，將程序分開，表示您可能要實作內部程序通訊處理。

SWC 檔案是封存格式的 ActionScript 類別元件庫。SWC 檔案包含 SWF 檔案和其他資源檔案。SWC 檔案是共用 ActionScript 類別的便利方式，而不需要共用個別的 ActionScript 程式碼與資源檔案。

原生擴充功能套件是 ANE 檔案。正如 SWC 檔案，ANE 檔案也是 ActionScript 類別元件庫，包含 SWF 檔案和其他封存格式的資源檔案。但是，AME 檔案與 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 Developer Tool (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 檔案支援應用程式的目標裝置。