iOS 包

在 iOS 上,ADT 将 SWF 文件字节代码和其他源文件转换为本机 iOS 应用程序。

  1. 使用 Flash Builder、Flash Professional 或命令行编译器创建 SWF 文件。

  2. 打开命令外壳或终端并导航到您的 iPhone 应用程序的项目文件夹。

  3. 然后,使用 ADT 工具创建 IPA 文件,语法如下:

    adt     -package 
                                        -target [ipa-test | ipa-debug | ipa-app-store | ipa-ad-hoc | 
                                        ipa-debug-interpreter | ipa-debug-interpreter-simulator 
                                        ipa-test-interpreter | ipa-test-interpreter-simulator] 
                                        -provisioning-profile PROFILE_PATH 
                                        SIGNING_OPTIONS 
                                        TARGET_IPA_FILE 
                                        APP_DESCRIPTOR 
                                        SOURCE_FILES 
                                        -extdir extension-directory 
                                        -platformsdk path-to-iossdk or path-to-ios-simulator-sdk

    更改引用 adt 以包括 adt 应用程序的完整路径。adt 应用程序安装在 AIR SDK 的 bin 子目录中。

    选择对应于您要创建的 iPhone 应用程序类型的 -target 选项:

    • -target ipa-test — 选择此选项可快速编译要在开发人员 iPhone 上进行测试的应用程序版本。还可以使用 ipa-test-interpreter 获得更快的编译速度,或使用 ipa-test-interpreter-simulator 在 iOS Simulator 中运行。

    • -target ipa-debug — 选择此选项可编译要在开发人员 iPhone 上测试的应用程序调试版本。通过此选项,您可以使用调试会话从 iPhone 应用程序接收 trace() 输出。

      您可以包含以下 -connect 选项 ( CONNECT_OPTIONS ) 之一,以指定运行该调试器的开发计算机的 IP 地址:

      • -connect — 应用程序将尝试通过 wifi 连接到用于编译该应用程序的开发计算机上的调试会话。

      • -connect IP_ADDRESS — 应用程序将尝试通过 wifi 连接到具有指定 IP 地址的计算机上的调试会话。例如:

        -target ipa-debug -connect 192.0.32.10
      • -connect HOST_NAME — 应用程序将尝试通过 wifi 连接到具有指定主机名称的计算机上的调试会话。例如:

        -target ipa-debug -connect bobroberts-mac.example.com

      -connect 选项是可选项。如果不指定该选项,则生成的调试应用程序不会尝试连接到托管调试器。或者可以指定 ‑listen 代替 ‑connect 以启用 USB 调试,如 通过 USB 使用 FDB 进行远程调试 所述。

      如果调试连接尝试失败,应用程序会显示一个对话框,要求用户输入调试主机的 IP 地址。如果设备未连接到 wifi,连接尝试可能失败。如果设备已连接,但不在调试主机的防火墙之后,也可能失败。

      还可以使用 ipa-debug-interpreter 获得更快的编译速度,或使用 ipa-debug-interpreter-simulator 在 iOS Simulator 中运行.

      有关详细信息,请参阅 调试移动 AIR 应用程序

    • -target ipa-ad-hoc — 选择此选项可创建用于临时部署的应用程序。请参见 Apple iPhone 开发人员中心

    • -target ipa-app-store — 选择此选项可创建用于部署到 Apple 应用程序库的 IPA 文件的最终版本。

    用应用程序的设置配置文件的路径替换 PROFILE_PATH 。有关设置配置文件的详细信息,请参阅 iOS 设置

    构建在 iOS Simulator 中运行的应用程序时,使用 -platformsdk 选项指向 iOS Simulator SDK。

    替换 SIGNING_OPTIONS 以引用 iPhone 开发人员证书和密码。应使用以下语法:

    -storetype pkcs12 -keystore P12_FILE_PATH -storepass PASSWORD

    使用 P12 证书文件的路径替换 P12_FILE_PATH 。使用证书密码替换 PASSWORD 。(请参见以下示例。)有关 P12 证书文件的详细信息,请参阅 将开发人员证书转换为 P12 keystore 文件

    注: 为 iOS Simulator 打包时可以使用自签名证书。

    替换 APP_DESCRIPTOR 以引用应用程序描述符文件。

    替换 SOURCE_FILES 以引用项目(后面跟有任何其他要包含的资源)的主 SWF 文件。包括指向在 Flash Professional 中的应用程序设置对话框中或在自定义应用程序描述符文件中定义的所有图标文件的路径。此外,还要添加初始屏幕图片文件 Default.png。

    使用 -extdir extension-directory 选项可指定包含应用程序使用的 ANE 文件(本机扩展)的目录。如果应用程序不使用本机扩展,请勿包含此选项。

    重要说明: 请勿在您的应用程序目录中创建名为 Resources 的子目录。运行时将自动创建具有此名称的文件夹以符合 IPA 包的结构要求。如果您自己创建“Resources”文件夹将导致致命冲突。

创建 iOS 包以便调试

若要创建一个 iOS 包以便安装在测试设备上,请使用 ADT package 命令,将目标类型设置为 ios-debug 。在运行此命令前,必须已经从 Apple 获取一个开发代码签名证书和设置配置文件。

adt     -package 
                                -target ipa-debug 
                                -storetype pkcs12 -keystore ../AppleDevelopment.p12 
                                -provisioning-profile AppleDevelopment.mobileprofile 
                                -connect 192.168.0.12 | -listen 
                                myApp.ipa 
                                myApp-app.xml 
                                myApp.swf icons Default.png
注: 还可以使用 ipa-debug-interpreter 获得更快的编译速度,或使用 ipa-debug-interpreter-simulator 在 iOS Simulator 中运行

请在一行内键入完整的命令;上面示例中出现换行符仅是为了阅读更加方便。另外,此示例假设指向 ADT 工具的路径存在于命令行 shell 的路径定义中。(有关帮助信息,请参阅 路径环境变量 。)

必须从包含应用程序文件的目录运行此命令。示例中的应用程序文件是 myApp-app.xml(应用程序描述符文件)、myApp.swf、图标目录和 Default.png 文件。

必须使用由 Apple 颁发的正确分发证书对应用程序进行签名;不得使用其他代码签名证书。

使用 -connect 选项执行 wifi 调试。应用程序尝试使用在指定 IP 或主机名上运行的 Flash Debugger (FDB) 启动一个调试会话。使用 -listen 选项执行 USB 调试。首先启动应用程序,然后启动 FDB,这时会启动运行中应用程序的调试会话。请参阅 连接到 Flash 调试器 以了解详细信息。

创建 iOS 包以便提交到 Apple 应用程序库

若要创建一个 iOS 包以便提交到 Apple 应用程序库,请使用 ADT package 命令,将目标类型设置为 ios-app-store 。在运行此命令前,您必须已经从 Apple 获取一个分发代码签名证书和设置配置文件。

adt     -package 
                                -target ipa-app-store 
                                -storetype pkcs12 -keystore ../AppleDistribution.p12 
                                -provisioning-profile AppleDistribution.mobileprofile 
                                myApp.ipa 
                                myApp-app.xml 
                                myApp.swf icons Default.png

请在一行内键入完整的命令;上面示例中出现换行符仅是为了阅读更加方便。另外,此示例假设指向 ADT 工具的路径存在于命令行 shell 的路径定义中。(有关帮助信息,请参阅 路径环境变量 。)

必须从包含应用程序文件的目录运行此命令。示例中的应用程序文件是 myApp-app.xml(应用程序描述符文件)、myApp.swf、图标目录和 Default.png 文件。

必须使用由 Apple 颁发的正确分发证书对应用程序进行签名;不得使用其他代码签名证书。

重要说明: Apple 要求您使用 Application Loader 程序,以便将应用程序上载到应用程序库。Apple 仅针对 Mac OS X 发布了 Application Loader 。因此,当您使用 Windows 计算机为 iPhone 开发 AIR 应用程序时,必须具有访问运行 OS X(版本 10.5.3 或更高版本)的计算机的权限,以便将应用程序提交到应用程序库。您可以从 Apple iOS 开发人员中心获取 Application Loader 程序。

创建 iOS 包以便进行临时分发

若要创建 iOS 包以便进行临时分发,请使用 ADT package 命令,将目标类型设置为 ios-ad-hoc 。在运行此命令前,您必须已经从 Apple 获取适当的临时分发代码签名证书和设置配置文件。

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

请在一行内键入完整的命令;上面示例中出现换行符仅是为了阅读更加方便。另外,此示例假设指向 ADT 工具的路径存在于命令行 shell 的路径定义中。(有关帮助信息,请参阅 路径环境变量 。)

必须从包含应用程序文件的目录运行此命令。示例中的应用程序文件是 myApp-app.xml(应用程序描述符文件)、myApp.swf、图标目录和 Default.png 文件。

必须使用由 Apple 颁发的正确分发证书对应用程序进行签名;不得使用其他代码签名证书。

为使用本机扩展的应用程序创建 iOS 包

要为使用本机扩展的应用程序创建 iOS 包,请使用具有 -extdir 选项的 ADT package 命令。使用与目标( ipa-app-store ipa-debug ipa-ad-hoc ipa-test )相适应的 ADT 命令。例如:

adt     -package 
                                -target ipa-ad-hoc 
                                -storetype pkcs12 -keystore ../AppleDistribution.p12 
                                -provisioning-profile AppleDistribution.mobileprofile 
                                myApp.ipa 
                                myApp-app.xml 
                                -extdir extensionsDir 
                                myApp.swf icons Default.png

请在一行内键入完整的命令;上面示例中出现换行符仅是为了阅读更加方便。

关于本机扩展,本示例假设名为 extensionsDir 的目录位于运行命令的目录中。 extensionsDir 目录包含应用程序所使用的 ANE 文件。