建立您的第一個 AIR for iOS 應用程式

建立顯示 “Hello world!” 文字的 SWF 檔案您可以使用 Flash Professional、Flash Builder 或其他 IDE 執行此工作。此範例只會使用文字編輯器以及包括在 Flex SDK 中的命令列 SWF 編譯器。

1. 在便利的位置中建立目錄以儲存您的應用程式檔案。建立名為 HelloWorld.as 的檔案，並在您偏好的程式碼編輯器中編輯檔案。

2. 請加入下列程式碼：

   package{ 
        
       import flash.display.Sprite; 
       import flash.text.TextField; 
       import flash.text.TextFormat; 
       import flash.text.TextFieldAutoSize; 
        
       public class HelloWorld extends Sprite 
       { 
           public function HelloWorld():void 
           { 
               var textField:TextField = new TextField(); 
               textField.text = "Hello World!"; 
               textField.autoSize = TextFieldAutoSize.LEFT; 
                    
               var format:TextFormat = new TextFormat(); 
               format.size = 48; 
                
               textField.setTextFormat ( format ); 
               this.addChild( textField ); 
           } 
       } 
   }

3. 使用 amxmlc 編譯器編譯類別：

   amxmlc HelloWorld.as

   即會在相同的資料夾中建立 SWF 檔案 HelloWorld.swf。

   備註： 此範例假設您已設定環境 Path 變數來加入含有 amxmlc 的目錄。如需設定路徑的資訊，請參閱 Path 環境變數 。您也可以輸入 amxmlc 的完整路徑以及此範例中所使用的其他命令列工具。

所有 iOS 應用程式在 iTunes 應用程式的使用者介面及裝置螢幕上都會有自己的圖示。

1. 在專案目錄中建立目錄，並命名為 icons。

2. 在 icons 目錄中建立 3 個 PNG 檔。將這 3 個檔案分別命名為 Icon_29.png、Icon_57.png 及 Icon_512.png。

3. 編輯 PNG 檔，為您的應用程式建立適當的圖案。檔案必須是 29 x 29 像素、57 x 57 像素及 512 x 512 像素。在此測試中，您可以使用實色的矩形做為圖案。

   備註： 將應用程式送出至 Apple App Store 時，您將使用 512 像素的 JPG 檔 (不是 PNG 檔)。測試應用程式的開發版本時，您便可以使用 PNG 檔。

所有 iPhone 應用程式在載入 iPhone 時都會顯示其起始影像。您會在 PNG 檔定義起始影像：

1. 在主要開發目錄中，建立名為 Default.png 的 PNG 檔。(請勿將此檔案放入 icons 子目錄中，務必將檔案命名為大寫 D 的 Default.png)。

2. 編輯檔案，讓檔案的寬度為 320 像素，而高度為 480 像素。就現在而言，內容可以是簡單的白色矩形 (我們將在稍後予以變更)。

如需這些圖像的詳細資訊，請參閱 應用程式圖示 。

建立應用程式描述器檔案以指定應用程式的基本屬性。您可以使用 IDE (例如 Flash Builder 或文字編輯器) 來完成此工作。

1. 在包含 HelloWorld.as　的專案資料夾中，建立名為 HelloWorld-app.xml　的 XML檔案。在您偏好的 XML編輯器中編輯此檔案。

2. 新增下列 XML：

   <?xml version="1.0" encoding="utf-8" ?> 
   <application xmlns="http://ns.adobe.com/air/application/2.7" minimumPatchLevel="0"> 
       <id>change_to_your_id</id> 
       <name>Hello World iOS</name> 
       <versionNumber>0.0.1</versionNumber> 
       <filename>HelloWorld</filename> 
       <supportedProfiles>mobileDevice</supportedProfiles> 
       <initialWindow> 
           <content>HelloWorld.swf</content> 
           <title>Hello World!</title> 
       </initialWindow> 
       <icon> 
           <image29x29>icons/AIRApp_29.png</image29x29> 
           <image57x57>icons/AIRApp_57.png</image57x57> 
           <image512x512>icons/AIRApp_512.png</image512x512> 
       </icon> 
   </application>

   基於簡潔的考量，此範例只會設定部分可用屬性。

   備註： 若是使用 AIR 2 或更早版本，您必須使用 <version> 元素而非 <versionNumber> 元素。

3. 變更應用程式 ID 以符合在 iOS Provisioning Portal 中指定的應用程式 ID (請勿在 ID 的開頭包括隨機組合包種子部分)。

4. 使用 ADL 測試應用程式：

   adl HelloWorld-app.xml -screensize iPhone

   ADL 應該會在桌面上開啟顯示下列文字的視窗：Hello World! 如果未開啟，請檢查原始碼與應用程式描述器是否有錯誤。

您現在可以使用 ADT 來編譯 IPA 安裝程式檔案。您必須擁有 P12 檔案格式的 Apple 開發人員憑證與私密金鑰，以及 Apple 開發佈建描述檔。

使用下列選項執行 ADT 公用程式，以自己的值取代 keystore、storepass 及 provisioning-profile 值：

adt -package -target ipa-debug 
    -keystore iosPrivateKey.p12 -storetype pkcs12 -storepass qwerty12 
    -provisioning-profile ios.mobileprovision 
    HelloWorld.ipa 
    HelloWorld-app.xml 
    HelloWorld.swf icons Default.png

(請使用單一命令列；此範例中的斷行符號是為了方便您的閱讀而加入)。

ADT 會在專案目錄中產生 iOS 應用程式安裝程式檔案： HelloWorld.ipa 。編譯 IPA 檔需要花費數分鐘的時間。

安裝 iOS 應用程式以供測試：

1. 開啟 iTunes 應用程式。

2. 如果您尚未這樣做，請將此應用程式的佈建描述檔加到 iTunes 中。在 iTunes 中，選取「檔案 > 加到資料庫」。然後，選取佈建描述檔 (檔案類型為 mobileprovision)。

   現在，請使用開發佈建描述檔在開發人員裝置上測試應用程式。

   稍後要將應用程式散發至 iTunes Store 時，請使用散發描述檔。若要散發臨時應用程式 (至多個裝置，但不經過 iTunes Store)，請使用臨時佈建描述檔。

   如需有關佈建描述檔的詳細資訊，請參閱 iOS 設定 。

3. 在部分 iTunes 版本中，即使您已安裝相同版本的應用程式，新安裝的應用程式並不會取代已安裝的應用程式。在這種情況下，請從裝置及 iTunes 的應用程式清單刪除應用程式。

4. 按兩下應用程式的 IPA 檔。該檔案應該會顯示在 iTunes 的應用程式清單中。

5. 將裝置連接至電腦的 USB 連接埠。

6. 在 iTunes 中，選取裝置的「應用程式」標籤，並確認在要安裝的應用程式清單中已選取該應用程式。

7. 在 iTunes 應用程式的左側清單選取裝置。然後按一下「同步」按鈕。完成同步之後，Hello World 應用程式就會顯示在您的 iPhone 中。

如果還是未安裝新的版本，請從裝置及 iTunes 的應用程式清單中刪除該應用程式，然後重做此程序。發生這種情況的原因可能是目前安裝的版本與新安裝的版本使用相同的應用程式 ID 和版本號碼。

編譯應用程式之前，您可以建立一個 Default.png 檔案 (請參閱 建立應用程式的圖示圖案及起始螢幕圖案 )。此 PNG 檔會在載入應用程式時，做為啟動影像使用。在 iPhone 測試應用程式時，您會在啟動時看到此空白螢幕。

您應該將此影像變更為與應用程式相符的啟動螢幕 ("Hello World!")：

1. 在裝置上啟動應用程式。首次顯示 “Hello World” 文字時，請按住「主畫面」按鈕 (螢幕下方)。按住「主畫面」按鈕的同時，請按住「電源/睡眠」按鈕 (在 iPhone 的最上方)。這樣會擷取一張螢幕快照並傳送至「相機膠卷」。

2. 藉由從 iPhoto 或其他照片傳送應用程式傳送照片，您可以將影像傳送至您的開發電腦 (在 Mac OS，您也可以使用影像擷取應用程式)。

   您也可以將照片透過電子郵件傳送至開發電腦：

   • 開啟「照片」應用程式。

   • 開啟「相機膠卷」。

   • 開啟您擷取的螢幕快照影像。

   • 點選影像，然後點選左下角的「下一頁」(箭號) 按鈕。然後按一下「透過電子郵件傳送照片」按鈕，將影像傳送給自己。

3. 以螢幕擷取影像的 PNG 版本取代 Default.png 檔案 (位於開發目錄中)。

4. 重新編譯應用程式 (請參閱 編譯 IPA 檔 )，並將該應用程式重新安裝到您的裝置。

從現在起，應用程式會於載入時使用新的啟動螢幕。