使用 Flex SDK 建立您的第一個 AIR for Android 應用程式

首先,您必須已經安裝和設定 AIR 與 Flex SDK。這個教學課程使用 Flex SDK 中的 AMXMLC 編譯器、AIR Debug Launcher (ADL) 以及 AIR SDK 中的 AIR Developer Tool (ADT)。請參閱設定 Flex SDK

您必須另從 Android 網站下載和安裝 Android SDK,如需詳細資訊,請參閱:Android 開發人員:安裝 SDK

備註: 如需 iPhone 開發的資訊,請參閱使用 Flash Professional CS5 建立 Hello World iPhone 應用程式

建立 AIR 應用程式描述器檔案

本節描述如何建立應用程式描述器,這是內含以下結構的 XML 檔案:

<application xmlns="..."> 
    <id>...</id> 
    <versionNumber>...</versionNumber> 
    <filename>…</filename> 
    <initialWindow> 
        <content>…</content> 
    </initialWindow> 
    <supportedProfiles>...</supportedProfiles> 
</application>
  1. 建立名稱為 HelloWorld-app.xml 的 XML 檔案,然後儲存至專案目錄。

  2. 加入 <application> 元素,同時包括 AIR 命名空間特質:

    <application xmlns="http://ns.adobe.com/air/application/2.7">:命名空間的最後一個區段 (「2.7」) 表示應用程式所需的執行階段版本。

  3. 新增 <id> 元素:

    <id>samples.android.HelloWorld</id> :應用程式 ID 連同發行者 ID (由 AIR 衍生自用來簽署應用程式套件的憑證) 可識別應用程式的唯一性。建議的格式為句點分隔的反向 DNS 樣式字串,例如 "com.company.AppName"

  4. 加入 <versionNumber> 元素:

    <versionNumber>0.0.1</versionNumber>:協助使用者判斷所安裝的應用程式版本。

  5. 新增 <filename> 元素:

    <filename>HelloWorld</filename>:應用程式執行檔、安裝目錄以及作業系統中類似參考使用的名稱。

  6. 新增 <initialWindow> 元素,其中包含下列子元素,以指定初始應用程式視窗的屬性:

    <content>HelloWorld.swf</content>:識別供 AIR 載入的根 HTML 檔案。

  7. 新增 <supportedProfiles> 元素。

    <supportedProfiles>mobileDevice</supportedProfiles> 指定應用程式只能在行動描述檔中執行。

  8. 儲存檔案。您的完整應用程式描述器檔案可能看起來如下:

    <?xml version="1.0" encoding="UTF-8"?> 
    <application xmlns="http://ns.adobe.com/air/application/2.7"> 
        <id>samples.android.HelloWorld</id> 
        <versionNumber>0.0.1</versionNumber> 
        <filename>HelloWorld</filename> 
        <initialWindow> 
            <content>HelloWorld.swf</content> 
        </initialWindow> 
        <supportedProfiles>mobileDevice</supportedProfiles> 
    </application>

這個範例僅設定一些可能的應用程式屬性。應用程式描述器檔案中還有其他您可以使用的設定。例如,您可以將 <fullScreen>true</fullScreen> 新增至 initialWindow 元素以建立全螢幕應用程式。若要在 Android 上啟用遠端除錯和存取控制的功能,您也必須將 Android 權限加入應用程式描述器。這個簡單的應用程式不需設定權限,因此您現在不需要新增權限。

如需詳細資訊,請參閱設定行動應用程式屬性

撰寫應用程式程式碼

建立名為 HelloWorld.as 的檔案,並使用文字編輯器新增下列程式碼:

package 
{ 
    import flash.display.Sprite; 
    import flash.text.TextField; 
     
    public class HelloWorld extends Sprite 
    { 
        public function HelloWorld() 
        { 
            var textField:TextField = new TextField(); 
            textField.text = "Hello, World!"; 
            stage.addChild( textField ); 
        } 
    } 
}

編譯應用程式

使用 amxmlc 編譯器將 MXML 程式碼編譯成 SWF 檔案,才能執行應用程式並進行除錯。您可以在 Flex SDK 資料夾的 bin 目錄中找到 amxmlc 編譯器。如果需要,您可以將電腦的路徑環境設定成包括 Flex SDK bin 目錄。設定這個路徑可以更方便地在命令列執行公用程式。

  1. 開啟命令殼層或終端機,然後瀏覽至 AIR 應用程式的專案資料夾。

  2. 輸入下列命令:

    amxmlc HelloWorld.as 

執行 amxmlc 會產生 HelloWorld.swf,它包含應用程式的已編譯程式碼。

備註: 若應用程式未編譯,請修正語法或拼字錯誤。錯誤和警告會顯示在用來執行 AMXMLC 編譯器的主控台視窗。

如需詳細資訊,請參閱編譯 AIR 的 MXML 和 ActionScript 原始檔案

測試應用程式

若要從命令列執行並測試應用程式,請使用 AIR Debug Launcher (ADL),並利用其應用程式描述器檔案來啟動應用程式 (您可以在 AIR 與 Flex SDK 的 bin 目錄中找到 ADL)。

 從命令提示字元輸入以下命令:
adl HelloWorld-app.xml 

如需詳細資訊,請參閱使用 ADL 進行裝置模擬

建立 APK 套件檔案

應用程式成功執行後,可以使用 ADT 公用程式將應用程式封裝成 APK 套件檔案。APK 套件檔案是原生 Android 應用程式檔案格式,可直接散佈給使用者。

所有 Android 應用程式都必須經過簽署。不同於 AIR 檔案,Android 應用程式通常會使用自我簽署的憑證來簽署。Android 作業系統不會嘗試建立應用程式開發人員的身分。您可以使用 ADT 產生的憑證來簽署 Android 套件。送出至 Android Market 的應用程式憑證有效期必須至少為 25 年。

產生自我簽署憑證和金鑰組

 從命令提示字元輸入以下命令 (您可以在 Flex SDK 的 bin 目錄找到 ADT 執行檔):
adt -certificate -validityPeriod 25 -cn SelfSigned 1024-RSA sampleCert.pfx samplePassword

這個範例使用最少數目的特質設定憑證。金鑰類型必須是 1024-RSA 或 2048-RSA (請參閱 ADT certificate 命令)。

建立 AIR 套件

 從命令提示字元輸入下列命令 (在同一行中):
adt -package -target apk -storetype pkcs12 -keystore sampleCert.p12 HelloWorld.apk HelloWorld-app.xml HelloWorld.swf

將會出現提示,要求您提供金鑰儲存檔案密碼。輸入密碼並按 Enter 鍵。

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

安裝 AIR 執行階段

您可以在裝置上安裝從 Android Market 取得的 AIR 執行階段最新版本。您也可以在裝置或 Android 模擬器上安裝 SDK 中包括的執行階段。

 從命令提示字元輸入下列命令 (在同一行中):
adt -installRuntime -platform android -platformsdk

-platformsdk 旗標設定為您的 Android SDK 目錄 (指定 tools 資料夾的上層資料夾)。

ADT 會安裝 SDK 中的 Runtime.apk。

如需詳細資訊,請參閱安裝用於開發的 AIR 執行階段與應用程式

安裝 AIR 應用程式

 從命令提示字元輸入下列命令 (在同一行中):
adt -installApp -platform android -platformsdk path-to-android-sdk -package path-to-app

-platformsdk 旗標設定為您的 Android SDK 目錄 (指定 tools 資料夾的上層資料夾)。

如需詳細資訊,請參閱安裝用於開發的 AIR 執行階段與應用程式

您可以在裝置或模擬器的螢幕上,輕點應用程式圖示以啟動應用程式。