license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,
     software distributed under the License is distributed on an
     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations

under the License.

Android 平臺指南

本指南演示如何設置您的 SDK 環境部署科爾多瓦的 Android 設備的應用程式以及如何在您的開發工作流中（可選）使用 Android 居中的命令列工具。您需要安裝 Android SDK 無論是否你想要使用這些平臺為中心的外殼工具或跨平臺 Cordova CLI 的發展。兩條發展路徑的比較，請參見概述。 CLI 的詳細資訊，請參閱命令列介面。

要求和支援

科爾多瓦 android 系統要求 Android SDK。請參閱 Android SDK的系統要求.

科爾多瓦支援 Android 2.3.x (姜餅，開始與 Android API 級別 10）和 4.x 版。作為一般規則，Android 版本成為不受支援的科爾多瓦作為他們沾在谷歌的分佈的儀表板上的 5%以下。 Android 版本早于 API 級別 10，而 3.x 版本 (蜂窩，API 級別 11-13) 大大低於那 5%門檻。

安裝科爾多瓦殼工具

如果您想要使用科爾多瓦的 Android 居中外殼工具與 SDK 一起，從cordova.apache.org下載科爾多瓦。如果您計畫使用所述的命令列介面的跨平臺 CLI 工具，否則忽略此節。

科爾多瓦下載包含單獨的檔案，為每個平臺。一定要展開相應的存檔， android 在這種情況下，在一個空的目錄內。有關 executible 實用程式可用在頂級 bin 目錄。 (參閱自述檔，如果有必要作更詳細的指示）。

這些外殼工具允許您創建、構建和運行 Android 應用程式。額外的命令列介面，可以跨所有平臺的外掛程式功能的資訊，請參閱使用 Plugman 到管理外掛程式。有關如何開發外掛程式的詳細資訊，請參閱應用程式外掛程式。

從developer.android.com/sdk安裝 Android SDK。 Android sdk 是作為 ‘adt-捆綁-< os > < 拱 >-< ver >’ 檔分發。在 windows 上，adt 捆綁打包用安裝程式安裝。在 OSX 和 Linux，只需打開包裝 ‘adt 捆綁’ 中的位置，您將存儲的開發工具。關於 Android SDK 安裝程式的詳細的資訊可以在這裡找到

科爾多瓦正常工作，或者基於他們的 CLI 命令列工具，您需要包括 SDK 的 tools 和 platform-tools 中的目錄你 PATH 。在 Mac 上可以使用一個文字編輯器來創建或修改 ~/.bash_profile 檔中，添加行，如下，根據 SDK 的安裝位置：

    匯出路徑 = ${路徑}：/開發/adt-捆綁/sdk/平臺-工具：/開發/adt-捆綁/sdk/工具

添加的路徑為 java 和 ant 如果需要。在這條線 ~/.bash_profile 公開這些工具在新打開的終端視窗。如果您的終端視窗已經打開在 OSX，或避免的登出登錄在 Linux 上，運行這個是為了讓他們在當前的終端視窗中可用：

    元源 ~/.bash_profile

若要修改 PATH 上 Windows 7 的環境：

在桌面的左下角的開始功能表上按一下，在電腦上，按右鍵，然後選擇屬性.
在左邊的列中選擇高級系統設置。
在結果對話方塊中，按下環境變數.
選擇PATH變數，然後按編輯.

追加到以下 PATH 基於在安裝 SDK，例如：

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

將值保存並關閉這兩個對話方塊。

您可能還需要啟用 JAVA 和螞蟻打開一個命令提示符並鍵入 java ，然後還鍵入 ant 。將追加到 PATH 為准的這些運行失敗：

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

在 SDK 中打開一個新的專案

此時，若要創建一個新的專案您可以選擇在命令列介面或一組特定于 android 作業系統 shell 工具中所述的跨平臺 CLI 工具之間。在原始程式碼目錄中，這裡是從 CLI 的辦法：

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

這裡是 Unix 和 Windows 的相應較低級別外殼工具方法：

    $ /path/to/cordova-android/bin/create /path/to/new/hello com.example.hello HelloWorld
    C:\path\to\cordova-android\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld

這裡是如何使用 SDK 來修改它：

啟動Eclipse應用程式。
選擇新建專案功能表項目。
從結果對話方塊中，選擇從現有代碼的 Android 專案並按下一步：
如果您使用的 CLI，導航到 hello 您創建專案，然後到目錄 platforms/android 子目錄。或者，如果您使用 create 殼實用程式，只需定位到 hello 目錄。
按完成.

一旦日食視窗將打開，一個紅色的X可能似乎表明未解決的問題。如果是這樣，執行這些額外的步驟：

按右鍵專案目錄。
在出現的屬性對話方塊中，選擇Android從功能窗格。
為專案生成目標，選擇您已安裝的最高的 Android API 級別。
按一下確定.
從專案功能表中選擇清潔。這應該更正該專案中的所有錯誤。

生成專案

如果您在開發中使用 CLI，專案目錄的頂級 www 目錄中包含的原始程式碼檔。運行任何這些專案目錄重新生成該應用程式中：

    $ 科爾多瓦 # 構建了添加的 $ 科爾多瓦的所有平臺都生成 android # 都生成調試只 Android $ 科爾多瓦建造安卓 — — 只有 Android $ 科爾多瓦都生成 android — — 唯一的 android 版本 # 都生成調試 # 都生成調試

如果您使用特定于 android 作業系統外殼工具在發展中，有不同的方法。一旦您生成該專案，預設應用程式的源是可用在 assets/www 子目錄。隨後的命令都可用在其 cordova 子目錄。

build命令，清理專案檔案並重新生成應用程式。這裡是為 Mac 和 Windows 的語法。第一次兩個示例生成調試資訊，和第二個構建版本的應用程式：

    $ /path/to/project/cordova/build --debug
    C:\path\to\project\cordova\build.bat --debug

    $ /path/to/project/cordova/build --release
    C:\path\to\project\cordova\build.bat --release

當生成版本中，如果您添加到下面的定義你 local.properties 檔，然後您的 APK 將得到簽署並對齊，它將會準備上傳到谷歌播放存儲：

    key.store=/Users/me/Developer/mykeystore.jks key.alias=mykeyalias

如果金鑰存儲庫和/或使用別名的鍵有一個密碼，則生成腳本將提示您輸入密碼。你不需要在屬性檔中定義的密碼。如果你想要避免出現提示，您可以定義它們在 local.properties 為 key.store.password 和 key.alias.password 。如果你這樣做，會意識到這些密碼的安全擔憂。

配置模擬器

您可以使用 cordova CLI 實用程式或科爾多瓦的安卓系統中心殼的工具，以在模擬器中運行應用程式。無論哪種方式，SDK 必須首先配置顯示至少一個設備。要這樣做，請使用 Android SDK 管理器，從 Eclipse 獨立運行的 JAVA 應用程式。有兩種方法，以將其打開：

運行 android 命令列上。
從內日食，按此工具列圖示：

一旦打開，Android SDK 管理器將顯示不同的運行時庫：

選擇工具 → 管理 AVDs （Android 的虛擬裝置），然後從裝置定義在隨後出現的對話方塊中選擇任何項：

按創建 AVD，（可選）修改該名稱，然後按確定以接受這些更改：

AVD 然後出現在虛擬的 Android 設備清單中：

若要打開模擬器作為單獨的應用程式，請選擇 AVD，然後按開始。它推出一樣在設備上，使用其他控制項可用的硬體按鈕:

部署到模擬程式

在這一點上，您可以使用 cordova CLI 實用程式部署到模擬器應用程式從命令列：

    $ 科爾多瓦效仿安卓系統

否則使用備用殼介面：

    $ /path/to/project/cordova/run — — 模擬器

而不是依靠哪種模擬器當前啟用在 SDK 中，你可以引用每個由您提供的名稱：

    $ /path/to/project/cordova/run — — 目標 = 名稱

這將應用程式推送至主畫面，啟動它：

當你 run 應用程式，您也 build 它。您可以附加額外 --debug ， --release ，和 --nobuild 標誌來控制它如何構建的或甚至是否重建是必需的：

    $ /path/to/project/cordova/run — — 模擬器 — — 不允許建造區域

如果相反你正在在 Eclipse 中，按右鍵該專案，並選擇作為 → 運行 Android 應用程式。可能要求您指定 AVD，如果都已經打開。

為獲得更快的體驗，您可以使用 Virtual Machine Acceleration 來提高執行速度。許多現代的 Cpu 提供擴展外掛程式，以更有效地執行虛擬機器。嘗試使用這種類型的加速度之前，您需要確定是否您當前的開發系統 CPU 支援一種以下的虛擬化技術：

英特爾虛擬化技術(VT-x，vmx) →英特爾 VT-x 支援的處理器清單
AMD 虛擬化（AMD-V，支援向量機），只支援 Linux （自 2006 年 5 月以來所有 Cpu AMD 都包括 AMD-V，閃龍除外）。

另一種方法來找出如果您的英特爾處理器支援 VT x 技術，它是由執行 Intel Processor Identification Utility ，為 Windows 您可以從英特爾下載中心，下載它，或者你可以使用booteable 實用程式，這是OS Independent.

後安裝和執行 Intel Processor Identification Utility 在 Windows 中，你會得到下面的視窗，以檢查是否您的 CPU 支援虛擬化技術：

為了加快模擬程式，您需要下載並安裝一個或多個 Intel x86 Atom 系統映射，以及Intel Hardware Accelerated Execution Manager (HAXM).

打開你的 Android SDK 經理，並選擇 Intel x86 Atom 為您想要測試哪種版本的系統映射。然後轉到 Extras ，並選擇 Intel x86 Emulator Accelerator (HAXM) ，並安裝這些套裝軟體：

下載後，運行了英特爾的安裝程式，在 Android SDK 中有可用 extras/intel/Hardware_Accelerated_Execution_Manager 。注： If you have any problems installing the package, you can find more information and step by step guidance check this 英特爾條 .

安裝一個或多個 Intel x86 Atom 的系統映射，以及 Intel Hardware Accelerated Execution Manager 下的額外的可用.
運行英特爾安裝程式時，這是在您 Android SDK 內可用extras/intel/Hardware_Accelerated_Execution_Manager.
設置為英特爾圖像的目標來創建新的 AVD。
當啟動模擬程式，確保沒有任何錯誤訊息，指示未能載入 HAX 模組。

將部署到設備

若要應用程式直接推向該設備，請確保在您的設備在安卓開發者網站上，所述啟用 USB 調試，然後使用一個迷你的 USB 電纜把它插到你的系統。

可以使用此 CLI 命令以將應用程式推送到設備：

    運行 android 的 $ 科爾多瓦

你要麼使用此以 Android 為中心的 shell 介面：

    $ /path/to/project/cordova/run — — 設備

無標誌指定， run 命令檢測到已連接的設備或當前正在運行的模擬程式，如果沒有設備被發現，否則將提示您指定一個模擬器。

若要運行該應用程式從在 Eclipse 中的，按右鍵該專案，並選擇作為 → 運行 Android 應用程式.

其他命令

下列生成詳細的日誌，該應用程式的運行時：

    $ C:\path\to\project\cordova\log.bat /path/to/project/cordova/log

以下清理的專案檔案：

    $ C:\path\to\project\cordova\clean.bat /path/to/project/cordova/clean