使用 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 文件和其他资源文件。不过，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 文件支持应用程序的目标设备。