譯：Android Platform Guide（Android 平台指南）

標籤：

Android 平台指南

　　這個指南展示了怎樣搭建你的SDK開發環境部署Android裝置的Cordova應用程式。將會帶你走過整個程式包括安裝Android SDK，在EclipseSDK開啟一個Android項目，和部署到一個模擬器或真實裝置上。你要跟著這個指南至少需要安裝 Android SDK, 不管你下面要進行哪一個工作流程。 ( Web項目開發 和 本地平台開發 工作流程都需要安裝 Android SDK並且通過你的PATH可訪問)

　　查看下列指定平台更詳細的資訊：

• Android Configuration（譯本：Android配置）
• Android WebViews (譯本：Android Web視圖)
• Android Plugins
• Upgrading Android
• Android Command-line Tools

　　上面命令列工具（Android Command-line Tools）指的是Cordova3.0以前的版本，The Command-Line Interface 關於當前介面的資訊。

Requirements and Support

　　Cordova  Android 需要 Android SDK. 查看 Android SDK的 系統要求

　　Cordova 支援 Android 2.3.x (華而不實的,從Android API10開始) 和 4.x。根據一般規則，在Google的  distribution dashboard上面當Android版本使用人數比例掉到5%，那這個版本就不會被Cordova支援。 Android版本早於API10，和3.x版本(AP11-13) 低於5%。

　　開發人員應該使用cordova 工具和 Android SDK結合。怎樣安裝它看命令列工具介面，添加項目，然後構建部署一個項目。

　　從 developer.android.com/sdk安裝 Android SDK。Android SDK是分布式的‘adt-bundle---‘檔案。在Windows上，這個adt-bundle被封裝到安裝程式。在OSX 和Linux，只是把 ‘adt-bundle‘解壓到你在本地存放開放工具的地方。 在這可以找到更多詳細的資訊關於Android SDK的安裝。

　　為了使用cordova命令列工具，你需要將SDK的 tools 和 platform-tools 目錄添加到你的PATH環境中。在Mac中，你可以使用一個文字編輯器來建立或修改 ~/.bash_profile 檔案， 添加一個像下面這樣的代碼，這個值就是你安裝SDK的位置:

export PATH=${PATH}:/Development/adt-bundle/sdk/platform-tools:/Development/adt-bundle/sdk/tools

　　

　　在新開終端視窗顯示SDK工具。另外運行下面這一行，讓它在當前的交談視窗可用：

$ source ~/.bash_profile

　　在win7中修改PATH環境：

• 點擊案頭左下角開始 菜單，右擊電腦，然後點擊屬性.

• 點擊左邊的進階系統設定

• 在開啟的對話方塊中，點擊環境變數

• 選擇 PATH 變數並且點擊 編輯.

• 添加基於你SDK的安裝位置到PATH最後，例如：

   ;C:\Development\adt-bundle\sdk\platform-tools;C:\Development\adt-bundle\sdk\tools

• 儲存並關閉 這兩個對話方塊.

　　你可能也需要使用Java和Ant. 開啟一個命令提示字元並輸入 java 和 ant. 下面添加到 PATH 後面無論哪一個失敗：

    ;%JAVA_HOME%\bin;%ANT_HOME%\bin

 在SDK開啟一個項目

　　使用 cordova 建立一個項目，就像在 Cordova 命令列介面 描述的那樣 。例如，在一個源碼目錄：   

    $ cordova create hello com.example.hello "HelloWorld"    $ cd hello    $ cordova platform add android    $ cordova build

 

　　一旦建立成功，這裡就是如果使用SDK來修改它：

• 啟動 Eclipse 應用程式.

• 選擇 建立項目 菜單選項.

• 從彈出的對話方塊選擇 Android Project from Existing Code ,然後點擊 Next:

• 放到 hello目錄，或者隨便哪個你建立項目的目錄，然後到 platforms/android 子目錄.

• 點擊 Finish（完成）.

　　一旦Eclipse視窗開啟，一個紅色的 X 可能出現，表示未解決的問題。如果這樣的話，繼續下面的步驟：

• 右擊項目目錄.

• 在Properties（屬性） 對話方塊，從導航面板選擇Android.

• 對於項目構建目標，選擇你已經安裝的最進階別Android API

• 點擊OK（完成）.

• 從Project 菜單選擇 Clean 。這應該糾正項目中所有的錯誤。

 部署到模擬器

　　你可以使用 cordova 在一個模擬器中運行app，或者你也可以在SDKl裡運行。不管怎樣,至少在一個裝置中必須配置 SDK 顯示。使用 Android SDK Manager來配置，從Eclipse分開運行一個Java應用程式。這有兩種方法來開啟它：

• 在命令列運行android 命令.

• 從Eclipse裡，點擊這個工具條表徵圖:

 

　　一旦開大，這個Android SDK Manager 像是各種各種的執行階段程式庫:

　　

　　

　　選擇 Tools → Manage AVDs (Android Virtual Devices),然後從這個對話方塊中的Device Definitions 選擇任何項目:

　　

 

　　點擊 Create AVD，隨便修改name，然後點擊 OK 儲存修改:

　　

 

　　然後這個AVD出現在Android Virtual Devices 列表中:

　　

 

　　開啟模擬器作為一個單獨的應用程式，選擇AVD並且點擊Start。它將會在這個裝置上啟動，這個裝置上還有一些可控制的硬體按鈕:

　　

 

　　這時，你可以在命令列使用如下命令將應用程式部署到模擬器:

    $ cordova emulate android

 

　　如果你是在Eclipse裡工作，右擊項目選擇Run As → Android Application. 如果沒有你可能會被要求制定一個已經開啟的AVD.

　　為了更快速的體驗，使用一個基於Intel處理器的模擬器圖片：

• 安裝一個或更多在Extras下面可用的Intel x86 Atom System Images 和 Intel Hardware Accelerated Execution Manager。

• 運行Intel安裝包，在 extras/intel/Hardware_Accelerated_Execution_Manager 目錄你Android SDK是可用的。

• 根據設定為Intel image的目標建立一個新的 AVD

• 當啟動模擬器的時候，確保這裡沒有表示載入HAX模組失敗的錯誤資訊

部署到真實的裝置

　　直接把app放到裝置上面，就像在Android Developer Site中描述的那樣確保USBdebugging能夠使用，並且串連USB插入到你的系統上。

　　使用如下命令將app放到裝置上行：

    $ cordova run android

　其他選擇是在Eclipse裡，右擊項目並且選擇 Run As → Android Application.



如果有翻譯不準確或不正確的地方請留言

譯：Android Platform Guide（Android 平台指南）