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 模擬器中執行。

    • -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 模擬器中執行。

      如需詳細資訊,請參閱 除錯行動 AIR 應用程式

    • -target ipa-ad-hoc :選擇此選項可建立進行臨時部署的應用程式。請參閱 Apple iPhone 開發人員中心

    • -target ipa-app-store :選擇此選項可建立要部署到 Apple App Store 的最終版 IPA 檔。

    以應用程式的佈建描述檔路徑來取代 PROFILE_PATH 。如需有關佈建描述檔的詳細資訊,請參閱 iOS 設定

    建置時,請使用 -platformsdk 選項指向 iOS 模擬器 SDK,以便在 iOS 模擬器中執行您的應用程式。

    取代 SIGNING_OPTIONS 以參照您的 iPhone 開發人員憑證和密碼 請使用下列語法:

    -storetype pkcs12 -keystore P12_FILE_PATH -storepass PASSWORD

    以您的 P12 憑證檔案來取代 P12_FILE_PATH。以憑證密碼來取代 PASSWORD。(請參閱以下範例。)如需 P12 憑證檔案的詳細資訊,請參閱 將開發人員憑證轉換成 P12 金鑰儲存檔案

    備註: 為 iOS 模擬器封裝時,您可以使用自我簽署的憑證。

    取代 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 模擬器中執行。

在單一行中輸入整個命令;上述範例中的分行僅為便於閱讀之故。此範例也假設 ADT 工具的路徑位於命令列殼層路徑定義中。(如需說明,請參閱 Path 環境變數 。)

您必須從包含應用程式檔案的目錄中執行命令。範例中的應用程式檔案為 myApp-app.xml (應用程式描述器檔案)、myApp.swf、圖示目錄與 Default.png 檔案。

您必須使用 Apple 核發的正確發佈憑證來簽署應用程式;不可使用其他程式碼簽署憑證。

使用 -connect 選項可進行 wifi 除錯。應用程式會嘗試透過在指定的 IP 或主機名稱上執行的 Flash 除錯程式 (FDB),起始除錯工作階段。使用 -listen 選項可進行 USB 除錯。請先啟動應用程式,然後啟動 FDB,如此,就會針對執行中的應用程式起始除錯工作階段。如需詳細資訊,請參閱 連線至 Flash 除錯程式

建立用於 Apple App Store 提交的 iOS 套件

若要建立提交 Apple App Store 的 iOS 套件,請使用 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 工具的路徑位於命令列殼層路徑定義中。(如需說明,請參閱 Path 環境變數 。)

您必須從包含應用程式檔案的目錄中執行命令。範例中的應用程式檔案為 myApp-app.xml (應用程式描述器檔案)、myApp.swf、圖示目錄與 Default.png 檔案。

您必須使用 Apple 核發的正確發佈憑證來簽署應用程式;不可使用其他程式碼簽署憑證。

重要事項: Apple 要求您使用 Apple Application Loader 程式,以上傳應用程式至 App Store。Apple 僅發佈 Mac OS X 的 Application Loader 。因此,使用 Windows 電腦開發 iPhone 的 AIR 應用程式時,您必須使用執行 OS X (版本 10.5.3,或更新的版本) 的電腦,將應用程式提交至 App Store。您可以從 Apple iOS Developer Center 取得 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 工具的路徑位於命令列殼層路徑定義中。(如需說明,請參閱 Path 環境變數 。)

您必須從包含應用程式檔案的目錄中執行命令。範例中的應用程式檔案為 myApp-app.xml (應用程式描述器檔案)、myApp.swf、圖示目錄與 Default.png 檔案。

您必須使用 Apple 核發的正確發佈憑證來簽署應用程式;不可使用其他程式碼簽署憑證。

建立使用原生擴充功能之應用程式的 iOS 套件

若要建立使用原生擴充功能之應用程式的 iOS 套件,請搭配使用 ADT package 命令與 -extdir 選項。適當在目標中使用 ADT 命令 ( ipa-app-store ipa-debug ipa-ad-hoc ipa-test )。例如:

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 檔案。