You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by db...@apache.org on 2016/04/06 11:27:22 UTC
[06/51] [partial] docs commit: Adding both Chinese versions.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/dev/guide/hybrid/plugins/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/hybrid/plugins/index.md b/www/docs/zh-cn/dev/guide/hybrid/plugins/index.md
new file mode 100644
index 0000000..27f9e1f
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/hybrid/plugins/index.md
@@ -0,0 +1,177 @@
+---
+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.
+
+title: 外掛程式開發指南
+---
+
+# 外掛程式開發指南
+
+*外掛程式*是代碼的一個套裝軟體，注入，允許在其中應用程式呈現與在其上運行的本機平臺進行通信的科爾多瓦 web 視圖。 外掛程式提供對基於 web 的應用程式通常不可用的設備和平臺功能的訪問。 科爾多瓦 API 的所有主要功能作為外掛程式，實現和許多其他的可用條碼掃描器、 NFC 通信等功能的啟用或定制日曆的介面。 有可用外掛程式[註冊表][1]。
+
+ [1]: http://plugins.cordova.io
+
+外掛程式包括一個單一的 JavaScript 介面和相應的本機代碼庫，每個受支援的平臺。 本質上這隱藏在一個共同的 JavaScript 介面背後各種本機代碼實現。
+
+這一節步驟通過一個簡單的*echo*外掛程式，將一個字串從 JavaScript 傳遞到本機平臺又回來，一個人，你可以使用作為一種模式，建立更為複雜的功能。 本節討論的基本外掛程式結構和麵向外部的 JavaScript 介面。 對於每個相應的本機介面，看到這一節的結尾處的清單。
+
+除了這些指令，當準備寫一個外掛程式，最好去看一下[現有的外掛程式][2]為指導。
+
+ [2]: http://cordova.apache.org/#contribute
+
+## 建設一個外掛程式
+
+應用程式開發人員使用 CLI 的 `plugin add` 命令 （討論中的命令列介面），適用于一個專案的一個外掛程式。 該命令的參數是一個包含外掛程式代碼的*git*存儲庫的 URL。 此示例實現科爾多瓦的設備 API：
+
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git
+
+
+外掛程式存儲庫必須功能頂級 `plugin.xml` 清單檔。 有很多方法來配置這個檔的可用外掛程式規範中的詳細資訊。 此縮寫的版本的 `Device` 外掛程式提供了一個簡單的例子，使用作為一種模式：
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+ id="cordova-plugin-device" version="0.2.3">
+ <name>Device</name>
+ <description>Cordova Device Plugin</description>
+ <license>Apache 2.0</license>
+ <keywords>cordova,device</keywords>
+ <js-module src="www/device.js" name="device">
+ <clobbers target="device" />
+ </js-module>
+ <platform name="ios">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Device">
+ <param name="ios-package" value="CDVDevice"/>
+ </feature>
+ </config-file>
+ <header-file src="src/ios/CDVDevice.h" />
+ <source-file src="src/ios/CDVDevice.m" />
+ </platform>
+ </plugin>
+
+
+頂級 `plugin` 標記的 `id` 屬性使用相同的反向域格式添加到他們的應用程式所識別的外掛程式包。 `js-module`標記指定的常見的 JavaScript 介面的路徑。 `platform`標記為指定一組相應的本機代碼， `ios` 在這種情況下的平臺。 `config-file`標記封裝 `feature` 標記，注入特定于平臺的 `config.xml` 檔，讓這個平臺認識到額外的代碼庫。 `header-file`和 `source-file` 標籤指定庫的元件檔的路徑。
+
+## 驗證外掛程式
+
+您可以使用 `plugman` 實用程式來檢查是否該外掛程式正確安裝每個平臺。 安裝 `plugman` 與[節點][3]下面的命令：
+
+ [3]: http://nodejs.org/
+
+ $ npm install -g plugman
+
+
+你需要有效的應用程式的原始目錄中，如頂級 `www` 目錄包含在預設 CLI 生成專案中所述的命令列介面。 請確保應用程式的 `index.html` 的主頁引用名稱的外掛程式的 JavaScript 介面，好像它是相同的原始目錄中：
+
+ <script src="myplugin.js"></script>
+
+
+然後運行以下命令來測試是否能正常載入的 iOS 的依賴關係：
+
+ $ plugman install --platform ios --project /path/to/my/project/www --plugin /path/to/my/plugin
+
+
+有關的詳細資訊 `plugman` 選項，請參閱使用 Plugman 管理外掛程式。 有關如何實際*調試*外掛程式的資訊，請參閱此頁面的底部列出的每個平臺的本機介面。
+
+## JavaScript 介面
+
+JavaScript 提供了面向前面的介面，使外掛程式的也許最重要的部分。 您可以結構你的外掛程式的 JavaScript，然而你喜歡，但是你需要調用 `cordova.exec` 來交流的本機平臺，使用下面的語法：
+
+ cordova.exec(function(winParam) {},
+ function(error) {},
+ "service",
+ "action",
+ ["firstArgument", "secondArgument", 42, false]);
+
+
+這裡是每個參數的工作原理：
+
+* `function(winParam) {}`： 成功回呼函數。假設您 `exec` 調用成功完成，以及任何您傳遞給它的參數執行此函數。
+
+* `function(error) {}`： 錯誤回呼函數。如果該操作未成功完成，此函數執行帶有可選錯誤參數。
+
+* `"service"`： 要調用的本機一邊的服務名稱。這對應于本機類，為其更多的資料，可在下面列出的本機指南。
+
+* `"action"`： 要調用的本機一邊的操作名稱。這通常對應于本機類的方法。請參閱下面列出的本機指南。
+
+* `[/* arguments */]`： 要傳遞到本機環境中的參數陣列。
+
+## 示例 JavaScript
+
+此示例演示實現外掛程式的 JavaScript 介面的一種方法：
+
+ window.echo = function(str, callback) {
+ cordova.exec(callback, function(err) {
+ callback('Nothing to echo.');
+ }, "Echo", "echo", [str]);
+ };
+
+
+在此示例中，該外掛程式的重視本身對 `window` 物件作為 `echo` 功能，外掛程式使用者會調用，如下所示：
+
+ window.echo("echome", function(echoValue) {
+ alert(echoValue == "echome"); // should alert true.
+ });
+
+
+看看的最後三個參數的 `cordova.exec` 函數。 第一次調用 `Echo` *的服務*，一個類名稱。 第二個請求 `echo` *行動*，該類中的方法。 第三個是一個陣列，包含 echo 字串，該字串參數的 `window.echo` 函數的第一個參數。
+
+成功回檔傳遞到 `exec` 是簡單的回呼函數的引用 `window.echo` 花。 如果本機平臺觸發錯誤回檔，它只是調用的成功回呼函數，並傳遞一個預設字串。
+
+## 本地介面
+
+一旦你為你的外掛程式定義 JavaScript，你需要補充與至少一個本機實現。 下面，列出每個平臺的詳細資訊和每個生成回聲外掛程式上面的簡單示例：
+
+* [亞馬遜火 OS 外掛程式](../../platforms/amazonfireos/plugin.html)
+* [Android 外掛程式](../../platforms/android/plugin.html)
+* [iOS 外掛程式](../../platforms/ios/plugin.html)
+* [黑莓 10 外掛程式](../../platforms/blackberry10/plugin.html)
+* [Windows Phone 8 外掛程式](../../platforms/wp8/plugin.html)
+* [Windows 外掛程式](../../platforms/win8/plugin.html)
+
+Tizen 平臺不支援外掛程式。
+
+## 發佈外掛程式
+
+一旦你開發你的外掛程式，你可能想要發佈並與社區分享它。 你可以將你的外掛程式發佈到任何`npmjs`-基於註冊表，但推薦的一種[NPM 註冊表][4]。 請閱讀我們的[新公共管理指南 》 的發佈外掛程式][5].
+
+ [4]: https://www.npmjs.com
+ [5]: http://plugins.cordova.io/npm/developers.html
+
+**注**:[科爾多瓦外掛程式註冊表][6]移動到唯讀狀態。 `publish`/`unpublish`命令刪除從`plugman`，所以你需要使用相應的`新公共管理`命令。
+
+ [6]: https://plugins.cordova.io
+
+其他開發人員可以安裝你的外掛程式使用`plugman`或科爾多瓦 CLI 自動。 (每個發展路徑的詳細資訊，請參閱使用 Plugman 管理外掛程式和命令列介面。)
+
+要將一個外掛程式發佈到故宮註冊表你需要按照以下的步驟:
+
+* 創建你的外掛程式的`package.json`檔:
+
+ $ plugman createpackagejson /path/to/your/plugin
+
+
+* 發佈:
+
+ $ npm adduser # that is if you don't have an account yet
+ $ npm publish /path/to/your/plugin
+
+
+就是這個!
+
+運行`plugman --help`列出其他可用的基於註冊表的命令。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/dev/guide/hybrid/webviews/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/hybrid/webviews/index.md b/www/docs/zh-cn/dev/guide/hybrid/webviews/index.md
new file mode 100644
index 0000000..899831d
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/hybrid/webviews/index.md
@@ -0,0 +1,32 @@
+---
+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.
+
+title: 嵌入 WebViews
+---
+
+# 嵌入 WebViews
+
+科爾多瓦的應用程式通常是作為基於瀏覽器的*web 視圖*在本機的移動平臺內實現的。 這一節演示如何，為支援平臺，以創建您自己的 web 視圖元件，充分使用科爾多瓦的 api。 然後，您可以部署在混合應用程式中的本機組件以及這些科爾多瓦應用程式元件。
+
+若要部署 web 視圖，您需要熟悉每個本機程式設計環境。下面提供了支援的平臺的說明：
+
+* [亞馬遜火 OS WebViews](../../platforms/amazonfireos/webview.html)
+* [Android WebViews](../../platforms/android/webview.html)
+* [WebViews iOS](../../platforms/ios/webview.html)
+* [Windows Phone 8.0 WebViews](../../platforms/wp8/webview.html)
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/dev/guide/next/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/next/index.md b/www/docs/zh-cn/dev/guide/next/index.md
new file mode 100644
index 0000000..44db500
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/next/index.md
@@ -0,0 +1,272 @@
+---
+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.
+
+title: 下一步
+---
+
+# 下一步
+
+對於開發人員瞭解如何使用科爾多瓦 CLI 並使使用的外掛程式，有幾個東西你可能要考慮旁邊建設得更好，更多性能科爾多瓦應用研究。 下面的文檔提供了各種主題有關的最佳做法、 測試、 升級和其他主題的意見，但並不意味著要規範。 認為這是你為你的成長作為科爾多瓦開發人員的啟動點。 同時，如果你看到一些可以做得更好，請[作出貢獻][1]!
+
+ [1]: http://cordova.apache.org/#contribute
+
+本指南包含以下主題：
+
+* 最佳做法
+* 處理升級
+* 測試科爾多瓦應用程式
+* 科爾多瓦的調試應用程式
+* 使用者介面
+* 特殊的注意事項
+* 保持
+* 獲取説明
+
+# 最佳做法科爾多瓦應用程式開發
+
+## 1） SPA 是你的朋友
+
+首先-科爾多瓦應用程式應在 SPA （單頁面應用程式） 設計。 定義寬泛，SPA 是一個用戶端應用程式，從一個請求 web 頁的運行。 使用者載入一組初始的資源 （HTML、 CSS 和 JavaScript） 和進一步更新 （顯示一個新的視圖，資料載入） 通過 AJAX。 水療中心常用應用於更複雜的用戶端應用程式。 GMail 是一個偉大的例子。 你載入 GMail、 郵件視圖、 編輯和組織後都是由更新而不是實際上離開當前頁面 DOM 載入一個新的人。
+
+使用一個水療中心可以説明您組織您的應用程式在一個更有效率的方式，但它也有科爾多瓦申請的具體好處。 科爾多瓦應用程式必須等待要火可能使用的任何外掛程式之前的 [deviceready](../../cordova/events/events.deviceready.html) 事件。 如果您不使用水療中心，和您的使用者按一下去從一個網頁到另一個，你將不得不等待 [deviceready](../../cordova/events/events.deviceready.html) 再次觸發之前要使用一個外掛程式。 這很容易忘記，您的應用程式變得更大。
+
+即使您選擇不使用科爾多瓦，創建一個移動應用程式不使用單個頁面結構將產生嚴重的性能影響。 這是因為頁面之間導航需要腳本、 資產等，被重新載入。 即使這些資產則進行緩存，仍有性能問題。
+
+水療中心庫您可以在科爾多瓦應用程式中使用的示例如下：
+
+* [AngularJS][2]
+* [EmberJS][3]
+* [骨幹][4]
+* [劍道 UI][5]
+* [摩納卡][6]
+* [ReactJS][7]
+* [Sencha 觸摸][8]
+* [jQuery 移動][9]
+
+ [2]: http://angularjs.org
+ [3]: http://emberjs.com
+ [4]: http://backbonejs.org
+ [5]: http://www.telerik.com/kendo-ui
+ [6]: http://monaca.mobi/en/
+ [7]: http://facebook.github.io/react/
+ [8]: http://www.sencha.com/products/touch/
+ [9]: http://jquerymobile.com
+
+和許多，許多，更多。
+
+## 2） 性能注意事項
+
+新的科爾多瓦開發人員可以利用的最大錯誤之一是想當然地認為他們會在桌上型電腦的性能是相同的他們會在行動裝置上。 雖然每年我們的行動裝置已經變得更強大，但它們仍然缺乏電力和桌上型電腦性能。 行動裝置通常有更少的 RAM 和很遠從他們的桌面上的 GPU （或甚至筆記本電腦） 的弟兄們。 小竅門的完整清單將太多了，但這裡有幾件事要牢記 （與更長的時間在結束了為進一步研究的資源的清單）。
+
+**按一下與觸摸**-你能犯的最大和最簡單的錯誤是使用 click 事件。 雖然這些手機上很好的"工作"，大多數設備徵收上他們的 300ms年延遲，以區分觸摸和觸摸"持有"事件。 使用 `touchstart` ，或 `touchend` ，將導致一個戲劇性的改善 — — 300ms年不聽起來很多，但它可以導致忽動忽停的 UI 更新和行為。 您還應該考慮"觸摸"事件的事實不支援在非 webkit 瀏覽器，請參閱[CanIUse][10]。 為了應付這些限制，您可以簽出不同的庫，如 HandJS 和 Fastouch。
+
+ [10]: http://caniuse.com/#search=touch
+
+**CSS 轉換與 DOM 操作**— — 使用硬體加速 CSS 轉換將大大優於使用 JavaScript 來創建動畫。 請參見本節末尾的資源的清單。
+
+**網路吸**-好的網路不總是很爛，但移動網路的延遲甚至良好的移動網路，比你可能想像的差很遠。 一個桌面的應用程式，吃了 500 行的 JSON 資料，每隔 30 秒，將既慢行動裝置，以及電池的豬。 請牢記科爾多瓦的應用程式有多種的方式來保持資料在應用程式 （本機存放區和檔案系統，例如）。 緩存本地資料，認識到你來回發送的資料量。 您的應用程式通過一個蜂窩網路連接時，這是一個特別重要的考慮因素。
+
+**額外的性能文章和資源**
+
+* ["你一半屁股它"][11]
+* ["頂十的性能提示 PhoneGap 和混合應用程式"][12]
+* ["快速應用程式和網站的 JavaScript"][13]
+
+ [11]: http://sintaxi.com/you-half-assed-it
+ [12]: http://coenraets.org/blog/2013/10/top-10-performance-techniques-for-phonegap-and-hybrid-apps-slides-available/
+ [13]: https://channel9.msdn.com/Events/Build/2013/4-313
+
+## 3） 認識和處理離線狀態
+
+請參閱關於網路上的提示。 你不僅可以在慢速網路上，這是完全有可能為您的應用程式必須完全離線。 您的應用程式應該處理這一種智慧化的方式。 如果您的應用程式不存在，人們會以為您的應用程式被破壞。 鑒於它是多麼容易處理 （科爾多瓦支援偵聽離線和線上活動），就絕對沒有理由為您的應用程式不回應時離線運行。 一定要測試 （見下面的測試一節） 您的應用程式，一定要測試您的應用程式是如何處理的當你開始處於一種狀態，然後切換到另一個。
+
+注意連線和離線的事件，如網路連接 API 不是完美。 您可能需要依賴于使用 XHR 請求，看看設備是否真正離線或連線。 在年底的一天，肯定添加某種形式的支助網路問題 — — 事實上，蘋果商店 （和可能其他存儲） 將拒絕不妥善處理離線/線上狀態的應用程式。 關於這一主題的更多討論，請參見["是對的這件事嗎?"][14]
+
+ [14]: http://blogs.telerik.com/appbuilder/posts/13-04-23/is-this-thing-on-%28part-1%29
+
+# 處理升級
+
+## 升級科爾多瓦專案
+
+如果您現有的專案使用科爾多瓦創建 3.x 版，您可以通過發出以下升級該專案：
+
+ 科爾多瓦平臺更新平臺名稱 ios，android，等。
+
+
+如果現有專案所創建的是根據之前科爾多瓦的版本 3.x，它可能會最好創建一個新的科爾多瓦 3.x 專案，然後將您現有的專案代碼和資源複製到新專案。 典型的步驟：
+
+* 創建一個新的科爾多瓦 3.x 專案 (科爾多瓦創建...)
+* 將 www 資料夾從您的舊專案複製到新的專案
+* 將任何配置設置從舊專案複製到新的專案
+* 添加到新專案的舊專案中使用任何外掛程式
+* 生成您的專案
+* 測試、 測試、 測試 ！
+
+該專案以前的版本，無論是絕對關鍵的你讀完上在更新後的版本中，更改了什麼，更新可能會中斷您的代碼。 最好的地方要查找此資訊將公佈在倉庫中，並在科爾多瓦的博客上的版本資訊中。 你會想要進行全面測試您的應用程式，驗證它工作正常後，則執行更新。
+
+注： 某些外掛程式可能無法與科爾多瓦的新版本相容。 如果一個外掛程式不是相容的你可能能夠找到一個更換外掛程式，你需要什麼，或者您可能需要推遲升級您的專案。 另外，改變該外掛程式，以便在最新的版本下工作並重新對社會有貢獻。
+
+## 外掛程式升級
+
+截至科爾多瓦 3.4 是沒有升級更改的外掛程式使用單個命令的機制。相反，刪除該外掛程式並添加它回到您的專案，並將安裝新的版本：
+
+ 科爾多瓦外掛程式 rm com.some.plugin 科爾多瓦外掛程式添加 com.some.plugin
+
+
+一定要檢查更新的外掛程式的文檔，因為您可能需要調整代碼以使用最新的版本。 此外，再檢查一遍，該外掛程式的新版本與您的專案版本的科爾多瓦。
+
+始終在測試您的應用程式，以確保安裝新外掛程式已不打破你預料不到的東西。
+
+如果您的專案具有大量的外掛程式，您需要更新，則可能會節省時間來創建殼或批次處理腳本中刪除並添加的外掛程式使用一個命令。
+
+# 測試科爾多瓦應用程式
+
+測試您的應用程式是非常重要的。科爾多瓦團隊使用茉莉花卻將任何 web 友好單位測試解決方案。
+
+## 在實際設備上與模擬器上測試
+
+它並非罕見時要使用桌面瀏覽器和設備模擬器/模擬器開發科爾多瓦的應用程式。 然而，這是非常重要的是您測試您的應用程式上盡可能多的物理設備，盡你所能：
+
+* 模擬器只是： 模擬器。 例如，您的應用程式可能工作在 iOS 模擬器沒有問題，但它真正的設備 （尤其是在某些情況下，例如一種低記憶體狀態） 上可能會失敗。 或者，您的應用程式實際上可能失敗在模擬器上，雖然它在實際設備上只是正常工作。
+* 模擬程式只是： 模擬器。 他們並不代表您的應用程式將在一個物理設備上運行的多好。 例如，一些模擬器可能呈現您的應用程式與顯示出現亂碼，雖然實際設備沒有任何問題。 （如果你確實遇到此問題，禁用在模擬程式中的主機 GPU。
+* 模擬器都比您的物理設備一般快。 模擬器，另一方面，是通常速度較慢。 由它在模擬器或模擬器中的執行不判斷您的應用程式的性能。 做以它對光譜的實際設備的運行方式來判斷您的應用程式的性能。
+* 它是不可能為您的應用程式如何回應通過使用模擬器或模擬器的觸摸得到的感覺很好。 相反，真正的設備上運行的應用程式可以點出大小的使用者介面元素、 反應能力等問題。
+* 雖然是很好，以便能夠測試僅在平臺每一台設備上，它是最佳體育許多不同的作業系統版本的很多設備上進行測試。 例如，什麼作品對你特別的 Android 智慧手機上可能會失敗另一個 Android 設備。 什麼工作 7 的 iOS 設備上的 iOS 6 設備上可能會失敗。
+
+當然，這是不可能在市場上每個可能的設備上進行測試。 出於這個原因，它是明智招募許多測試人員有不同的設備。 雖然他們不會抓住每一個問題，很好他們會發現怪癖和你永遠找不到一個人的問題。
+
+小貼士： 它有可能在 Android nexus 系列設備很容易閃不同版本的 Android 設備上。 這個簡單的過程將使您能夠輕鬆地測試您的應用程式對不同級別的 Android 與一個單一的設備，沒有排尿您的保修服務或要求你到"根"或"越獄"您的設備。 谷歌安卓系統工廠的圖像和說明都位於： HTTPs://developers.google.com/android/nexus/images#instructions
+
+# 科爾多瓦的調試應用程式
+
+調試科爾多瓦需要進行一些設置。不像桌面應用程式，你只需打開 dev 工具無法在您的行動裝置上，並開始調試，幸運的是，有一些不錯的方案。
+
+## iOS 調試
+
+### Xcode
+
+使用 Xcode 可以調試應用程式科爾多瓦的 iOS 本機側。 確保調試區域顯示 （-> 調試區域視圖）。 一旦您的應用程式運行在設備 （或類比） 上，您可以在調試區域查看日誌輸出。 這是任何錯誤或警告的列印位置。 此外可以在原始檔案中設置中斷點。 這將允許您逐句通過一行代碼一次，那次查看變數的狀態。 命中中斷點時，變數的狀態是顯示在調試區域。 一旦您的應用程式是在設備上啟動並運行，你可以把 Safari 的 web 督察 （如下所述） 來調試您的應用程式 web 視圖和 js 的一面。 有關更多詳細資訊和説明，請參閱 Xcode 指南： [Xcode 調試指南][15]
+
+ [15]: https://developer.apple.com/library/mac/documentation/ToolsLanguages/Conceptual/Xcode_Overview/DebugYourApp/DebugYourApp.html#//apple_ref/doc/uid/TP40010215-CH18-SW1
+
+### Safari 遠端偵錯 Web 督察
+
+使用 Safari 的 web 檢查器，您可以調試的 web 視圖和 js 代碼科爾多瓦在應用程式中。 這工作只在 OSX 上，只與 iOS 6 （或更高）。 它使用 Safari 來連接到您的設備 （或類比），並將連接到科爾多瓦應用程式的瀏覽器的開發工具。 你得到你期望從 DOM 檢查/操作、 JavaScript 調試器、 網路檢測、 主控台和開發工具。 像 Xcode，使用 Safari 的 web 檢查器可以在 JavaScript 代碼中設置中斷點並查看變數的狀態在那段時間。 您可以查看任何錯誤、 警告或消息列印到主控台。 當您的應用程式正在運行，您還可以直接從主控台運行 JavaScript 命令。 有關如何設置它，你可以做的更多詳細資訊，請參閱這篇優秀博客： [HTTP://moduscreate.com/enable-remote-web-inspector-in-ios-6/][16]和本指南： [Safari 網路督察指南][17]
+
+ [16]: http://moduscreate.com/enable-remote-web-inspector-in-ios-6/
+ [17]: https://developer.apple.com/library/safari/documentation/AppleApplications/Conceptual/Safari_Developer_Guide/Introduction/Introduction.html
+
+## 鉻遠端偵錯
+
+Safari 版本幾乎一樣，這只與 Android 工作但可以從任何桌面作業系統使用。 它需要最小的 Android 4.4 （奇巧）、 最低 API 級別的 19 和鉻 30 + （在桌面上）。 一旦連接，您可以得到相同的 Chrome 開發工具體驗移動應用程式像你與你的桌面應用程式。 更妙的是，Chrome 開發工具有一個鏡像選項表明您在行動裝置上運行的應用程式。 這是不僅僅是一個視圖-您可以向下滾動並按一下從開發工具，它在行動裝置上更新。 鉻遠端偵錯功能的更多詳細資訊可以在這裡找到： [HTTPs://developers.google.com/chrome/mobile/docs/debugging][18]
+
+ [18]: https://developers.google.com/chrome/mobile/docs/debugging
+
+它是可能使用 Chrome 開發工具來檢查 iOS 應用程式，通過 WebKit 代理： [HTTPs://github.com/google/ios-webkit-debug-proxy/][19]
+
+ [19]: https://github.com/google/ios-webkit-debug-proxy/
+
+## 波紋
+
+波紋是一個桌面的基於的模擬器科爾多瓦專案。 本質上，它允許您在您的桌面應用程式中運行科爾多瓦應用和假科爾多瓦的各種功能。 例如，它允許您類比加速度感應器檢測搖事件。 它通過讓您從您的硬碟上選擇一張圖片假貨攝像頭 API。 波紋讓你更專注于您的自訂代碼，而不是擔心科爾多瓦外掛程式。 你可以在這裡找到更多關於波紋： [HTTP://ripple.incubator.apache.org/][20]
+
+ [20]: http://ripple.incubator.apache.org/
+
+## Weinre
+
+Weinre 創建可以承載您科爾多瓦的應用程式的遠端偵錯用戶端的本機伺服器。 您已經安裝並啟動它後，你將某行代碼複製到您的科爾多瓦應用程式，然後重新開機它。 然後可以在您的桌面上，使用應用程式打開一個 dev 工具面板。 Weinre 不是很高檔的鉻和 Safari 遠端偵錯但有工作的作業系統和平臺的範圍要大得多的效益。 更多的資訊可以在這裡找到： [HTTP://people.apache.org/~pmuellr/weinre/docs/latest/][21]
+
+ [21]: http://people.apache.org/~pmuellr/weinre/docs/latest/
+
+## 其他選項
+
+* 黑莓 10 支援以及調試：[文檔][22]
+* 你可以調試以及使用火狐瀏覽器的應用程式管理器，請參見[此博客文章][23]和此[MDN 條][24].
+* 更多的例子和解釋上面的調試提示，請參閱： [HTTP://developer.telerik.com/featured/a-concise-guide-to-remote-debugging-on-ios-android-and-windows-phone/][25]
+
+ [22]: https://developer.blackberry.com/html5/documentation/v2_0/debugging_using_web_inspector.html
+ [23]: https://hacks.mozilla.org/2014/02/building-cordova-apps-for-firefox-os/
+ [24]: https://developer.mozilla.org/en-US/Apps/Tools_and_frameworks/Cordova_support_for_Firefox_OS#Testing_and_debugging
+ [25]: http://developer.telerik.com/featured/a-concise-guide-to-remote-debugging-on-ios-android-and-windows-phone/
+
+# 使用者介面
+
+構建一個科爾多瓦應用程式，看起來不錯移動可以是一種挑戰，尤其是開發商。 很多人選擇使用 UI 框架使這個容易。 這裡是您可能想要考慮的選項短名單。
+
+* [jQuery 移動][9]-jQuery 移動自動增強您的移動優化的佈局。它也可以處理自動為你創建一個水療中心。
+* [離子][26]-此功能強大的 UI 框架實際上有它自己的 CLI 來處理創建專案。
+* [棘輪][27]-帶給你的那些創建引導的人。
+* [劍道 UI][5] -開放原始碼的使用者介面和應用程式框架從 Telerik。
+* [面漆][28]
+* [ReactJS][7]
+
+ [26]: http://ionicframework.com/
+ [27]: http://goratchet.com/
+ [28]: http://topcoat.io
+
+建立您的使用者介面，時，重要的是思考你的目標的所有平臺和使用者的期望之間的差異。 例如，有 iOS 樣式的使用者介面的 Android 應用程式可能不會很好與使用者。 這有時是即使執行各種應用程式商店。 正因為如此，很重要的尊重每個平臺的公約，因此熟悉各種人機界面指南:
+
+* [iOS][29]
+* [安卓系統][30]
+* [Windows Phone][31]
+
+ [29]: https://developer.apple.com/library/ios/documentation/userexperience/conceptual/MobileHIG/index.html
+ [30]: https://developer.android.com/designWP8
+ [31]: http://dev.windowsphone.com/en-us/design/library
+
+## 其他 UI 文章和資源
+
+儘管瀏覽器引擎變得更多、 更多標準的投訴，我們仍然生活在一個帶首碼的世界 （-webkit 和-女士） 開發 UI 中的跨瀏覽器的應用程式時，下面的文章是寶貴： [HTTP://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx][32]
+
+ [32]: http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx
+
+# 特殊的注意事項
+
+雖然科爾多瓦跨平臺開發更加容易，但它是不可能提供 100%從底層本機平臺的隔離。所以要瞭解限制。
+
+## 平臺的怪癖
+
+在閱讀文檔時，尋找其中簡要說明了不同的行為或要求在多個平臺上的部分。 如果存在，這些將是在一節題為"安卓 Quirks 」，"iOS 怪癖"等。 通讀這些怪癖，覺察到它們作為你工作與科爾多瓦。
+
+## 載入遠端內容
+
+調用科爾多瓦 JavaScript 函數從一個遠端載入的 HTML 頁面 （不存儲在本地設備上的 HTML 頁） 是一種不受支援的配置。 這是因為科爾多瓦被設計用來此，和 Apache 科爾多瓦社區並沒有測試此配置。 雖然它可以工作在某些情況下，它不是建議也不支援。 還有挑戰與同源策略，保持上的 javascript 代碼和科爾多瓦的本機部分同步相同的版本 （因為他們耦合通過私人的 Api 可能會更改），在調用本機的本地函數和潛在的應用程式商店拒絕的遠端內容的可信度。
+
+應該做的遠端載入 HTML 內容在 web 視圖中顯示使用科爾多瓦的 InAppBrowser。 InAppBrowser 專門設計，以便 JavaScript 運行那裡沒有存取權限的但對科爾多瓦 JavaScript Api 為上面列出的原因。 請參閱安全指南。
+
+# 保持
+
+這裡有幾種方法可以更新科爾多瓦。
+
+* [科爾多瓦博客][33]訂閱.
+* 訂閱的[開發人員名單][34]。請注意--這不是一個支援組!相反，這是發展的科爾多瓦是的討論。
+
+ [33]: http://cordova.apache.org/#news
+ [34]: http://cordova.apache.org/#mailing-list
+
+# 獲取説明
+
+下面的連結是最好的地方去科爾多瓦的説明：
+
+* 計算機: [HTTP://stackoverflow.com/questions/tagged/cordova][35]通過使用科爾多瓦標記，您可以查看和流覽所有的科爾多瓦問題。 請注意計算機自動轉換到"科爾多瓦""Phonegap"標記，所以這種方式你將能夠訪問歷史問題以及
+* PhoneGap 谷歌組: [HTTPs://groups.google.com/forum/#! 論壇/phonegap][36]此谷歌組的時候老支援論壇科爾多瓦還叫 PhoneGap。 雖然仍有很多頻繁的這一組的科爾多瓦使用者，科爾多瓦表示，社會上對這群不會專注並改用計算機支援興趣
+* Meetup: [HTTP://phonegap.meetup.com][37] -考慮尋找本地的科爾多瓦/PhoneGap meetup 組
+
+ [35]: http://stackoverflow.com/questions/tagged/cordova
+ [36]: https://groups.google.com/forum/#!forum/phonegap
+ [37]: http://phonegap.meetup.com
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/dev/guide/overview/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/overview/index.md b/www/docs/zh-cn/dev/guide/overview/index.md
new file mode 100644
index 0000000..60c1d15
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/overview/index.md
@@ -0,0 +1,77 @@
+---
+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.
+
+title: 概述
+---
+
+# 概述
+
+Apache 科爾多瓦是一個開放源碼移動開發框架。 它允許您使用標準的 web 技術如 HTML5、 CSS3 和 JavaScript 進行跨平臺開發，避免每個移動平臺的本機開發語言。 應用程式在有針對性的對每個平臺的包裝內執行，並依靠符合標準的 API 綁定訪問每個設備的感應器、 資料和網路狀態。
+
+Apache 科爾多瓦于 2012 年 10 月畢業于作為一個頂級專案內阿帕奇軟體基金會 (ASF)。 科爾多瓦的未來發展會透過 ASF，確保開放管理的專案。 它將永遠是根據 Apache 許可證，2.0 版本的自由和開放源碼。訪問[cordova.apache.org][1]的詳細資訊。
+
+ [1]: http://cordova.apache.org
+
+如果您是，使用 Apache 科爾多瓦：
+
+* 移動開發人員和想要擴展應用程式跨多個平臺，而無需重新實現它與每個平臺的語言和工具集。
+
+* 網頁程式開發人員和想要部署 web 應用程式打包為分佈在各種應用程式中存儲的門戶。
+
+* 移動開發人員感興趣與*web 視圖*（特殊的瀏覽器視窗），可以訪問設備級別的 Api，混合本機應用程式元件或如果你想開發一個外掛程式介面本機和 web 視圖元件之間。
+
+## 基本元件
+
+Apache 科爾多瓦的應用程式都依賴于一個共同的 `config.xml` 檔，提供有關應用程式的資訊，並指定參數影響它如何工作，如它是否回應方向轉移。 此檔遵循 W3C 的[打包 Web 應用程式][2]或*構件*，規範。
+
+ [2]: http://www.w3.org/TR/widgets/
+
+應用程式本身作為 web 頁上，預設情況下名為*index.html*，引用任何 CSS、 JavaScript、 圖像、 媒體檔案或其他資源的本地檔是必要的它的運行來實現。 這款應用程式作為*web 視圖*的本機應用程式中包裝，您分發給應用程式商店內執行。
+
+科爾多瓦啟用 web 視圖可提供具有其整個使用者介面的應用程式。 在一些平臺上，它也可以是更大，混合應用程式與本機應用程式元件混合 web 視圖中的一個元件。 （請參閱嵌入 WebViews 的詳細資訊）。
+
+*外掛程式*介面，供科爾多瓦和本機組件與對方溝通。 這使您可以調用來調用本機代碼從 JavaScript。 理想情況下，到該本機代碼的 JavaScript Api 是一致的跨多個設備平臺。 版本 3.0，外掛程式提供綁定到標準設備的 Api。 協力廠商外掛程式在所有平臺上提供額外綁定到不一定可用的功能。 你可以在[外掛程式註冊表][3]中找到這些協力廠商外掛程式，在您的應用程式中使用它們。 您也可以開發自己的外掛程式，外掛程式開發指南中所述。 外掛程式可能是必要的例如，科爾多瓦和自訂本機組件之間進行通信。
+
+ [3]: http://plugins.cordova.io
+
+**注**： 版本為 3.0，當您創建它並沒有任何外掛程式目前科爾多瓦專案。 這是新的缺省行為。 你的願望，甚至核心外掛程式，必須顯式添加任何外掛程式。
+
+科爾多瓦不提供任何 UI 小部件或 MV * 框架。 科爾多瓦提供只在那些可以執行的運行時。 如果您想要使用 UI 部件和/或 MV * 框架，您將需要選擇那些並將它們包含在應用程式中自己作為協力廠商材料。
+
+## 發展路徑
+
+版本 3.0，你可以使用兩種基本的工作流程來創建一個移動應用程式。雖然你經常可以使用任一工作流完成相同的任務，他們每個人都具有優點：
+
+* **跨平臺 (CLI) 工作流程**： 使用此工作流如果您希望您的應用程式在許多不同的移動作業系統上運行，盡可能以小的特定于平臺的發展需要。 此工作流都是圍繞 `cordova` 實用程式，否則稱為科爾多瓦*CLI*，引入的科爾多瓦 3.0。CLI 是功能的一個高級別的工具，使您可以生成許多平臺的專案一次，提取很大一部分的較低級別 shell 腳本。 CLI 將一組通用的 web 資產複製到每個移動平臺的子目錄，使得任何必需的配置更改為每個，運行生成腳本來生成應用程式二進位檔案。 CLI 還提供了一個通用介面，適用于您的應用程式的外掛程式。CLI 的更多詳細資訊，請參閱命令列介面。 除非你有需要為該平臺為中心的工作流，被建議的跨平臺工作流。
+
+* **平臺為中心的工作流**： 如果你想要注重建立一個單一的平臺的應用程式和需要，以便能夠在較低級別進行修改使用此工作流。 您需要使用這種方法，例如，如果您希望您的應用程式組合自訂本機組件與基於 web 的科爾多瓦元件，如嵌入 WebViews 中所討論。 作為一個經驗法則，使用此工作流，如果您需要修改 SDK 中的專案。 此工作流，依賴于一套專門針對每個受支援的平臺和單獨的 Plugman 實用程式，它允許您要應用的外掛程式的較低級別 shell 腳本。 雖然您可以使用此工作流構建跨平臺的應用程式，通常很難更因為缺乏的一種較高級別的工具意味著單獨的組建循環和外掛程式修改為每個平臺。 儘管如此，此工作流允許您提供的每個 SDK 的開發選項獲得更多和複雜混合應用程式至關重要。 有關每個平臺可用外殼實用程式，請參閱各種平臺指南�
�詳細資訊。
+
+當第一次開始的時候，它可能是最簡單的方法使用跨平臺工作流來創建一個應用程式，如所述的命令列介面。 然後，您可以選擇要切換到以平臺為中心的工作流，如果你需要 SDK 提供的更大控制。 較低級別外殼實用程式，可在[cordova.apache.org][1]在 CLI 比單獨的分發。 生成的專案最初由 CLI，這些外殼工具也是在中可用專案的各種 `platforms/*/cordova` 目錄。
+
+**注意**： 一旦你從基於 CLI 的工作流切換到一個圍繞特定于平臺的 Sdk 和殼的工具，你不能回去。 CLI 維護一套共同的跨平臺原始程式碼，這對每個構建它使用它來寫入的特定于平臺的原始程式碼。 要保留的特定于平臺的資產做的任何修改，你需要要切換到的以平臺為中心的殼工具，忽視的跨平臺原始程式碼，並轉而依賴特定于平臺的原始程式碼。
+
+## 安裝科爾多瓦
+
+科爾多瓦的安裝會不同上面你選擇的工作流：
+
+* 跨平臺工作流： 請參閱命令列介面。
+
+* 平臺為中心的工作流： 請參見平臺輔助線。
+
+在安裝之後科爾多瓦，建議您查看您將為開發移動平臺平臺指南。 它還建議你還審查的隱私指南、 [安全指南](../appdev/security/index.html) 》 和接下來的步驟。 用於配置科爾多瓦，見 config.xml 檔。 從 JavaScript 訪問本機函數在一個設備上的，請參閱外掛程式 Api。 和參考作為必要的其他包括指南。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/dev/guide/platforms/amazonfireos/config.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/amazonfireos/config.md b/www/docs/zh-cn/dev/guide/platforms/amazonfireos/config.md
new file mode 100644
index 0000000..a5b7970
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/amazonfireos/config.md
@@ -0,0 +1,71 @@
+---
+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.
+
+title: 亞馬遜火 OS 配置
+---
+
+# 亞馬遜火 OS 配置
+
+`config.xml`檔控制應用於每個應用程式和 CordovaWebView 實例的應用程式的基本設置。 此節詳細資訊首選項僅適用于亞馬遜火 OS 的基礎。 有關全域配置選項的資訊，請參閱 [config.xml 檔][1]。
+
+ [1]: config_ref_index.md.html#The%20config.xml%20File
+
+* `KeepRunning`(boolean 類型的值，預設值為 `true` ）： 確定應用程式是否保持甚至後在後臺運行 `[pause](../../../cordova/events/events.pause.html)` 事件火災。 將此設置為 `false` 不會殺死後的 app `[pause](../../../cordova/events/events.pause.html)` 事件，但只是暫停執行代碼內科爾多瓦 web 視圖應用程式時在背景中。
+
+ <preference name="KeepRunning" value="false"/>
+
+
+* `ErrorUrl`（URL，預設為 `null` ）： 如果設置，將顯示而不是以"應用程式錯誤"標題對話方塊的應用程式中的錯誤時所引用的網頁。
+
+ <preference name="ErrorUrl" value="error.html"/>
+
+
+* `LoadingDialog`（字串，預設值為 `null` ）： 如果設置，顯示一對話方塊中指定的標題和消息，和一個微調框，載入的應用程式中的第一頁時。 由在此值字串中的逗號分隔的標題和消息，那逗號刪除之前顯示的對話方塊。
+
+ <preference name="LoadingDialog" value="Please wait, the app is loading"/>
+
+
+* `LoadingPageDialog`（字串，預設值為 `null` ）： 相同， `LoadingDialog` ，但用於在應用程式中的第一頁後載入的每個頁面。
+
+ <preference name="LoadingPageDialog" value="Please wait, the data is loading"/>
+
+
+* `LoadUrlTimeoutValue`（數，預設值是 `20000` ）： 當載入一個頁面，在引發逾時錯誤之前等待的時間量。 此示例指定 10 秒，而不是 20：
+
+ <preference name="LoadUrlTimeoutValue" value="10000"/>
+
+
+* `SplashScreen`： 減去其副檔名的檔的名稱 `res/drawable` 目錄。各種資產必須共用此各子目錄中的共同名稱。
+
+ <preference name="SplashScreen" value="splash"/>
+
+
+* `SplashScreenDelay`(編號，預設值為 `5000` ）： 所需的時間初始螢幕圖像顯示。
+
+ <preference name="SplashScreenDelay" value="10000"/>
+
+
+* `ShowTitle`(boolean 類型的值，預設值為 `false` ）： 顯示在螢幕頂部的標題。
+
+ <preference name="ShowTitle" value="true"/>
+
+
+* `LogLevel`（字串，預設值為 `ERROR` ）： 將通過哪些日誌將過濾郵件從您的應用程式的最小日誌級別設置。 有效的值為 `ERROR` ， `WARN` ， `INFO` ， `DEBUG` ，和`VERBOSE`.
+
+ <preference name="LogLevel" value="VERBOSE"/>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/dev/guide/platforms/amazonfireos/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/amazonfireos/index.md b/www/docs/zh-cn/dev/guide/platforms/amazonfireos/index.md
new file mode 100644
index 0000000..f69c097
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/amazonfireos/index.md
@@ -0,0 +1,192 @@
+---
+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.
+
+title: 亞馬遜火 OS 平臺指南
+---
+
+# 亞馬遜火 OS 平臺指南
+
+本指南介紹如何設置您的 SDK 開發環境部署亞馬遜火 OS 的設備，如 Kindle 火 HDX 科爾多瓦應用軟體。
+
+請參閱下列特定于平臺的詳細資訊：
+
+* [亞馬遜火 OS 配置](config.html)
+* [亞馬遜火 OS WebViews](webview.html)
+* [亞馬遜火 OS 外掛程式](plugin.html)
+
+## 簡介
+
+通過針對亞馬遜火 OS 平臺，科爾多瓦開發人員可以創建利用先進的 web 引擎集成的 Kindle 消防設備的混合 web 應用程式。 亞馬遜 web 視圖 API (AWV) 是獨有的火 OS 鉻派生的 web 運行時。 為 web 視圖使用的 Android 設備附帶的投遞更換，AWV 使成為可能，更好地執行功能更強大的混合 web 應用程式通過創建為一個更快的 JavaScript 引擎 (V8)、 遠端偵錯和 Kindle 消防設備包括加速 2D 畫布的硬體優化提供支援和不支援的 Android 的 HTML5 功能的訪問內置的 web 視圖如: CSS 除垢，表單驗證，getUserMedia，IndexedDB、 網路工作者、 WebSockets 和 WebGL。
+
+關於亞馬遜 web 視圖 API 的詳細資訊，請參閱亞馬遜開發人員門戶[HTML5 混合應用程式頁][1]。 有關獲取開始和其他的問題支援問題，請參見亞馬遜開發人員門戶[論壇-HTML5 混合應用程式][2].
+
+ [1]: https://developer.amazon.com/public/solutions/platforms/android-fireos/docs/building-and-testing-your-hybrid-app
+ [2]: http://forums.developer.amazon.com/forums/category.jspa?categoryID=41
+
+## 要求和支援
+
+亞馬遜火 os 開發科爾多瓦的應用程式需要安裝的各種支援檔，包括 android 系統的發展，以及亞馬遜 web 視圖 SDK 所需的一切。 請檢查下面的清單中所需的安裝：
+
+* [命令列介面](../../cli/index.html)
+* [Android SDK][3]
+* [Apache Ant][4]
+* [亞馬遜 web 視圖 SDK][1]
+
+ [3]: http://developer.android.com/sdk/
+ [4]: http://ant.apache.org
+
+## 安裝
+
+### Android SDK 和 Apache Ant
+
+從[developer.android.com/sdk][3]安裝 Android SDK。 你可能會出現一個選擇在哪裡安裝 SDK，否則移動下載 `adt-bundle` 樹到無論您存儲的開發工具。
+
+你需要在運行 Android SDK 管理器 （ `android` 從命令列） 開始您的科爾多瓦專案前至少一次。 一定要安裝最新版本的 Android SDK 工具和 SDK 平臺**具體 API 級別為 19**。 請關於亞馬遜開發人員門戶如何設置您的開發環境為 Kindle 火 OS 設備的詳細資訊，參閱[您的開發環境設置][5]。
+
+ [5]: https://developer.amazon.com/public/resources/development-tools/ide-tools/tech-docs/01-setting-up-your-development-environment
+
+Apache Ant 生成工具[下載螞蟻二進位分發][6]，解壓縮到您以後可以引用的目錄的安裝。 請參閱[Ant 手冊][7]為更多的資訊。
+
+ [6]: http://ant.apache.org/bindownload.cgi
+ [7]: http://ant.apache.org/manual/index.html
+
+對於科爾多瓦的命令列工具來工作，您需要包括 Android SDK 的 `tools` 、 `platform-tools` 和 `apache-ant/bin` 目錄路徑環境中的。
+
+#### Mac/Linux 路徑
+
+關於 Mac、 Linux 或其他 unix 平臺，您可以使用文字編輯器來創建或修改 `~/.bash_profile` 檔中，添加行，如下，依據的 SDK 和 Ant 安裝位置：
+
+ 匯出路徑 = ${路徑}：/開發/adt-捆綁/sdk/平臺-工具：/開發/adt-捆綁/sdk/工具：/發展/阿帕奇-ant/bin
+
+
+這暴露了 SDK 工具在新打開的終端視窗。否則運行這使它們在當前會話中可用：
+
+ $ source ~/.bash_profile
+
+
+#### Windows 路徑
+
+若要修改路徑在 Windows 上的環境：
+
+* 在桌面的左下角的**開始**功能表上按一下，在**電腦**上，按右鍵，然後按一下**屬性**.
+
+* 在左側列中，按一下**高級系統設置**。
+
+* 在結果對話方塊中，按下**環境變數**.
+
+* 選擇**PATH**變數，然後按**編輯**.
+
+* 將以下內容追加到哪裡你安裝了 SDK 和螞蟻，例如基於的路徑：
+
+ ;C:\Development\adt-bundle\sdk\platform-tools;C:\Development\adt-bundle\sdk\tools;C:\Development\apache-ant\bin
+
+
+* 將值保存並關閉這兩個對話方塊。
+
+* 您還將需要啟用 JAVA。 打開一個命令提示符並鍵入 `java` ，如果它沒有運行，追加到您的路徑以及 JAVA 二進位檔案的位置。 請確保已安裝 JDK 目錄指向的 %JAVA_HOME%。 您可能必須添加 JAVA_HOME 環境變數分別。
+
+ ； %JAVA_HOME%\bin
+
+
+### 亞馬遜 web 視圖 SDK
+
+若要創建使用目標亞馬遜火 OS 平臺的科爾多瓦應用程式，您需要下載、 解壓和安裝亞馬遜 web 視圖 SDK 的支援檔。 這一步只需要為你的第一個亞馬遜火 OS 專案做。
+
+* 從[亞馬遜開發人員門戶][1]下載亞馬遜 web 視圖 SDK.
+
+* 複製 `awv_interface.jar` 從下載 SDK 到科爾多瓦的工作目錄。如果它不存在，請創建 commonlibs(shown below) 資料夾：
+
+ **Mac/Linux:** `~/.cordova/lib/commonlibs/`
+
+ **Windows:** `%USERPROFILE%\.cordova\lib\commonlibs`
+
+## 為亞馬遜火 OS 創建新專案
+
+使用 `cordova` 實用程式來建立一個新的專案，如所述在科爾多瓦的命令列介面。例如，在一個原始程式碼目錄:
+
+ $ cordova create hello com.example.hello "HelloWorld"
+ $ cd hello
+ $ cordova platform add amazon-fireos
+ $ cordova build
+
+
+***注：***第一次亞馬遜 fireos 平臺的安裝在您的系統，它會到科爾多瓦的工作目錄，下載相應的檔但然後會失敗，因為它缺少 AWV SDK 的支援檔 （見上文）。 請按照上面的說明來安裝 `awv_interface.jar` ，刪除，然後重新將亞馬遜 fireos 平臺添加到您的專案。 這一步只需要為第一次亞馬遜火 OS 專案做。
+
+## 將部署到設備
+
+一個應用程式直接推向該設備，請確保您的設備在[Android 開發者網站][8]上，所述上啟用 USB 調試和使用一個迷你的 USB 電纜，把它插到你的系統。
+
+ [8]: http://developer.android.com/tools/device.html
+
+您可以從命令列將應用程式推送到設備：
+
+ $ 科爾多瓦運行亞馬遜 fireos
+
+
+或者在 Eclipse，按右鍵該專案，然後選擇**→ 作為運行 Android 應用程式**.
+
+**注**： 目前，對於亞馬遜 web 視圖基於應用程式測試通過模擬器不支援，另外亞馬遜 web 視圖 API 是只可用火 OS 的設備上。 有關詳細資訊，請參閱[亞馬遜 web 視圖 API SDK][1]文檔。
+
+### 運行標誌
+
+運行命令接受可選參數作為科爾多瓦的命令列介面文檔中指定，火 OS 也接受額外 `--debug` 將啟用遠端 web 調試鉻的開發人員工具的標誌。
+
+要使用的開發工具，請輸入：
+
+ $ cordova run --debug amazon-fireos
+
+
+這將使在用戶端上運行的工具。你可以連接到用戶端通過埠轉發使用安卓系統調試橋 （亞銀） 指的應用程式的包名。
+
+例如：
+
+ 亞行轉發 tcp:9222 localabstract:com.example.helloworld.devtools
+
+
+然後，可以使用通過基於鉻的瀏覽器 DevTools 導航到：`http://localhost:9222`.
+
+### 可選的 Eclipse 支援
+
+一旦創建，您可以使用 Eclipse 隨之而來的 Android SDK 來修改專案。 要小心是否你繼續使用科爾多瓦命令列工具，通過 Eclipse 所做的修改將被覆蓋。
+
+* 啟動**Eclipse**應用程式。
+
+* 選擇**新建專案**功能表項目。
+
+* 從結果對話方塊中，選擇**從現有代碼的 Android 專案**並按**下一步**： ![][9]
+
+* 定位到 `hello` ，或無論你創建目錄的專案，然後到 `platforms/amazon-fireos` 子目錄。
+
+* Eclipse 將顯示你你好、 你好-CorddovaLib-2 專案要添加。添加兩個。
+
+* 按**完成**.
+
+ [9]: {{ site.baseurl }}/static/img/guide/platforms/android/eclipse_new_project.png
+
+一旦日食視窗打開，一個紅色的**X**可能似乎表明未解決的問題。如果是這樣，請按照這些額外的步驟：
+
+* 按右鍵專案目錄。
+
+* 在出現的**屬性**對話方塊中，選擇**Android**從功能窗格。
+
+* 專案的生成目標，請選擇最高的 Android API 級別 （目前 API 級別 19），安裝了。
+
+* 按一下**確定**.
+
+* 從**專案**功能表中選擇**清潔**。這應該更正該專案中的所有錯誤。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/dev/guide/platforms/amazonfireos/plugin.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/amazonfireos/plugin.md b/www/docs/zh-cn/dev/guide/platforms/amazonfireos/plugin.md
new file mode 100644
index 0000000..0677f2a
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/amazonfireos/plugin.md
@@ -0,0 +1,106 @@
+---
+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.
+
+title: 亞馬遜火 OS 外掛程式
+---
+
+# 亞馬遜火 OS 外掛程式
+
+按照有關的開發自訂外掛程式概述 Android 外掛程式指南中提供的說明。
+
+## 回聲亞馬遜火 OS 外掛程式示例
+
+若要匹配的 JavaScript 介面*回波*特徵描述的應用程式外掛程式，使用 `plugin.xml` 來注入 `feature` 到本地平臺規範 `config.xml` 檔：
+
+ <platform name="amazon-fireos">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Echo">
+ <param name="android-package" value="org.apache.cordova.plugin.Echo"/>
+ </feature>
+ </config-file>
+ </platform>
+
+
+然後添加以下到 `src/org/apache/cordova/plugin/Echo.java` 檔：
+
+ package org.apache.cordova.plugin;
+
+ import org.apache.cordova.CordovaPlugin;
+ import org.apache.cordova.CallbackContext;
+
+ import org.json.JSONArray;
+ import org.json.JSONException;
+ import org.json.JSONObject;
+
+ /**
+ * This class echoes a string called from JavaScript.
+ */
+ public class Echo extends CordovaPlugin {
+
+ @Override
+ public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
+ if (action.equals("echo")) {
+ String message = args.getString(0);
+ this.echo(message, callbackContext);
+ return true;
+ }
+ return false;
+ }
+
+ private void echo(String message, CallbackContext callbackContext) {
+ if (message != null && message.length() > 0) {
+ callbackContext.success(message);
+ } else {
+ callbackContext.error("Expected one non-empty string argument.");
+ }
+ }
+ }
+
+
+如果你想要重用的亞馬遜火 OS 平臺 Android 外掛程式代碼然後修改通過指向 `android` 特定的原始檔案。例如，
+
+ <platform name="amazon-fireos">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Echo">
+ <param name="android-package" value="org.apache.cordova.plugin.Echo"/>
+ </feature>
+ </config-file>
+ <source-file src="src/android/Echo.java" target-dir="src/org/apache/cordova/plugin" />
+ </platform>
+
+
+如果你想要編寫自訂的外掛程式的亞馬遜火 OS 平臺，然後創建一個名為資料夾 `amazon` 下你的外掛程式 src / 資料夾和修改通過為指向 `amazon` 特定的原始檔案。 例如，
+
+ <platform name="amazon-fireos">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Echo">
+ <param name="android-package" value="org.apache.cordova.plugin.Echo"/>
+ </feature>
+ </config-file>
+ <source-file src="src/amazon/Echo.java" target-dir="src/org/apache/cordova/plugin" />
+ </platform>
+
+
+## 在你的外掛程式中使用亞馬遜 web 視圖
+
+科爾多瓦的亞馬遜火 OS 使得使用的基於開放源碼鉻專案的自訂亞馬遜 web 視圖。它是 GPU 加速和優化的流體性能上點燃火。
+
+若要瞭解如何以最佳方式在您的專案中使用亞馬遜 web 視圖，查閱[亞馬遜開發人員門戶][1].
+
+ [1]: https://developer.amazon.com/sdk/fire/IntegratingAWV.html
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/dev/guide/platforms/amazonfireos/webview.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/amazonfireos/webview.md b/www/docs/zh-cn/dev/guide/platforms/amazonfireos/webview.md
new file mode 100644
index 0000000..33526d3
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/amazonfireos/webview.md
@@ -0,0 +1,129 @@
+---
+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.
+
+title: 亞馬遜火 OS WebViews
+---
+
+# 亞馬遜火 OS WebViews
+
+從 3.3.0 開始，你可以使用科爾多瓦作為亞馬遜火 OS 應用程式中的一個元件。 亞馬遜火 OS 是指這種元件 `CordovaWebView` 。 `CordovaWebView`擴展建立在開放原始碼鉻專案的亞馬遜 web 視圖。 通過利用此功能，您的 web 應用程式可以利用最新的 HTML5 web 標準在現代 web 運行時引擎中運行。
+
+如果你是亞馬遜火 OS 不熟悉，您應首先熟悉亞馬遜火 OS 平臺指南和有最新的 Sdk 安裝之前您嘗試嵌入 web 視圖的更多不尋常的發展方案。
+
+## 系統必備元件
+
+* 科爾多瓦 3.3.0 或更高
+
+* Android SDK 更新到最新的 SDK
+
+* 亞馬遜 web 視圖 SDK
+
+## 在亞馬遜火 OS 專案中使用 CordovaWebView 的指南
+
+1. 要按照這些說明進行操作，請確保您有最新的科爾多瓦分佈。從[cordova.apache.org][1]下載並解壓其亞馬遜火 OS 套裝程式。
+
+2. 下載並展開[亞馬遜 web 視圖 SDK][2] ，然後複製到 awv_interface.jar `/framework/libs` 目錄。 創建庫 / 資料夾如果它不存在。
+
+3. 導航到包的 `/framework` 目錄，運行 `ant jar` 。它創建了科爾多瓦 `.jar` 檔中，形成了作為`/framework/cordova-x.x.x.jar`.
+
+4. 複製 `.jar` 到 Android 專案檔案 `/libs` 目錄。
+
+5. 將以下內容添加到應用程式的 `/res/xml/main.xml` 檔中，與 `layout_height` 、 `layout_width` 和 `id` 修改，以適合應用程式：
+
+ <org.apache.cordova.CordovaWebView
+ android:id="@+id/tutorialView"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent" />
+
+
+6. 修改您的活動，使它實現了 `CordovaInterface` 。 您應該執行包括的方法。 您可能希望將它們從複製 `/framework/src/org/apache/cordova/CordovaActivity.java` ，或執行這些靠你自己。 下面的代碼片段顯示了一個基本的應用程式，使用該介面。 請注意如何引用的視圖 id 匹配 `id` 在上面所示的 XML 片段中指定的屬性：
+
+ public class CordovaViewTestActivity extends Activity implements CordovaInterface {
+ CordovaWebView cwv;
+ /* Called when the activity is first created. */
+ @Override
+ public void onCreate(Bundle savedInstanceState) {
+ super.onCreate(savedInstanceState);
+ setContentView(R.layout.main);
+ cwv = (CordovaWebView) findViewById(R.id.tutorialView);
+ Config.init(this);
+ cwv.loadUrl(Config.getStartUrl());
+ }
+
+
+ [1]: http://cordova.apache.org
+ [2]: https://developer.amazon.com/sdk/fire/IntegratingAWV.html#installawv
+
+如果您使用的相機，你應該也可以實現這：
+
+ @Override
+ public void setActivityResultCallback(CordovaPlugin plugin) {
+ this.activityResultCallback = plugin;
+ }
+ /**
+ * Launch an activity for which you would like a result when it finished. When this activity exits,
+ * your onActivityResult() method is called.
+ *
+ * @param command The command object
+ * @param intent The intent to start
+ * @param requestCode The request code that is passed to callback to identify the activity
+ */
+ public void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode) {
+ this.activityResultCallback = command;
+ this.activityResultKeepRunning = this.keepRunning;
+
+ // If multitasking turned on, then disable it for activities that return results
+ if (command != null) {
+ this.keepRunning = false;
+ }
+
+ // Start activity
+ super.startActivityForResult(intent, requestCode);
+ }
+
+ @Override
+ /**
+ * Called when an activity you launched exits, giving you the requestCode you started it with,
+ * the resultCode it returned, and any additional data from it.
+ *
+ * @param requestCode The request code originally supplied to startActivityForResult(),
+ * allowing you to identify who this result came from.
+ * @param resultCode The integer result code returned by the child activity through its setResult().
+ * @param data An Intent, which can return result data to the caller (various data can be attached to Intent "extras").
+ */
+ protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
+ super.onActivityResult(requestCode, resultCode, intent);
+ CordovaPlugin callback = this.activityResultCallback;
+ if (callback != null) {
+ callback.onActivityResult(requestCode, resultCode, intent);
+ }
+ }
+
+
+最後，請記住，添加執行緒池，否則外掛程式有沒有線程上運行：
+
+ @Override
+ public ExecutorService getThreadPool() {
+ return threadPool;
+ }
+
+
+1. 將您的應用程式的 HTML 和 JavaScript 檔案複製到您的亞馬遜火 OS 專案 `/assets/www` 目錄。
+
+2. 複製 `config.xml` 從 `/framework/res/xml` 到您的專案的 `/res/xml` 目錄。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/dev/guide/platforms/android/config.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/android/config.md b/www/docs/zh-cn/dev/guide/platforms/android/config.md
new file mode 100644
index 0000000..02ca6b1
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/android/config.md
@@ -0,0 +1,95 @@
+---
+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.
+
+title: Android 系統組態
+---
+
+# Android 系統組態
+
+`config.xml`檔控制應用於每個應用程式和 CordovaWebView 實例的應用程式的基本設置。 本節詳細說明僅適用于 android 系統生成的首選項。 有關全域配置選項的資訊，請參閱[config.xml 檔][1]。
+
+ [1]: config_ref_index.md.html#The%20config.xml%20File
+
+* `KeepRunning`(boolean 類型的值，預設值為 `true` ）： 確定應用程式是否保持甚至後在後臺運行 `[pause](../../../cordova/events/events.pause.html)` 事件火災。 將此設置為 `false` 不會殺死後的 app `[pause](../../../cordova/events/events.pause.html)` 事件，但只是暫停執行代碼內科爾多瓦 web 視圖應用程式時在背景中。
+
+ <preference name="KeepRunning" value="false"/>
+
+
+* `LoadUrlTimeoutValue`(以毫秒為單位的數位，預設為 `20000` ，20 秒)： 當載入一個頁面，在引發逾時錯誤之前等待的時間量。 此示例指定 10 秒，而不是 20：
+
+ <preference name="LoadUrlTimeoutValue" value="10000"/>
+
+
+* `SplashScreen`（字串，預設值為 `splash` ）： 包括其副檔名的檔的名稱 `res/drawable` 目錄。 各種資產必須共用此各子目錄中的共同名稱。
+
+ <preference name="SplashScreen" value="mySplash"/>
+
+
+* `SplashScreenDelay`(編號以毫秒為單位，預設值為 `3000` ）： 所需的時間初始螢幕圖像顯示。
+
+ <preference name="SplashScreenDelay" value="10000"/>
+
+
+* `InAppBrowserStorageEnabled`(boolean 類型的值，預設值為 `true` ）： 控制項是否在 InAppBrowser 內打開的頁可以訪問同一認為和 WebSQL 存儲作為預設瀏覽器打開的頁面。
+
+ <preference name="InAppBrowserStorageEnabled" value="true"/>
+
+
+* `LoadingDialog`（字串，預設值為 `null` ）： 如果設置，顯示一對話方塊中指定的標題和消息，和一個微調框，載入的應用程式中的第一頁時。 由在此值字串中的逗號分隔的標題和消息，那逗號刪除之前顯示的對話方塊。
+
+ <preference name="LoadingDialog" value="My Title,My Message"/>
+
+
+* `LoadingPageDialog`（字串，預設值為 `null` ）： 相同， `LoadingDialog` ，但用於在應用程式中的第一頁後載入的每個頁面。
+
+ <preference name="LoadingPageDialog" value="My Title,My Message"/>
+
+
+* `ErrorUrl`（URL，預設為 `null` ）： 如果設置，將顯示而不是以"應用程式錯誤"標題對話方塊的應用程式中的錯誤時所引用的網頁。
+
+ <preference name="ErrorUrl" value="myErrorPage.html"/>
+
+
+* `ShowTitle`(boolean 類型的值，預設值為 `false` ）： 顯示在螢幕頂部的標題。
+
+ <preference name="ShowTitle" value="true"/>
+
+
+* `LogLevel`（字串，預設值為 `ERROR` ）： 將通過哪些日誌將過濾郵件從您的應用程式的最小日誌級別設置。 有效的值為 `ERROR` ， `WARN` ， `INFO` ， `DEBUG` ，和`VERBOSE`.
+
+ <preference name="LogLevel" value="VERBOSE"/>
+
+
+* `SetFullscreen`(boolean 類型的值，預設值為 `false` ）： 同樣作為 `Fullscreen` 在此 xml 檔的全域配置參數。 此 Android 特定元素支援全球否決 `Fullscreen` 元素，並將在未來版本中移除。
+
+* `AndroidLaunchMode`（字串，預設值為 `singleTop` ）： 設置活動 `android:launchMode` 屬性。 這將更改該應用程式從應用程式圖示或意圖啟動的是已經在運行的過程中會發生什麼。 有效的值是 `standard` ， `singleTop` ， `singleTask` ，`singleInstance`.
+
+ <preference name="AndroidLaunchMode" value="singleTop"/>
+
+
+* `DefaultVolumeStream`（字串，預設值為 `default` ，加在科爾多瓦 android 3.7.0): 設置的音量按鈕連結到的硬體音量。 預設情況下這是"叫"手機和平板電腦的"媒體"。 將此設置為"媒體"有您的應用程式卷按鈕總是改變媒體卷。 請注意，當使用科爾多瓦的媒體外掛程式時，音量按鈕將動態地更改為任何媒體物件處於活動狀態時，控制的媒體卷。
+
+* `OverrideUserAgent`(字串，預設情況下未設置): 如果設置，值將替換舊使用者代理的 web 視圖。 它有利於從應用程式或瀏覽器請求時請求遠端頁面，識別。 使用持謹慎態度，這可能導致與 web 伺服器的 compitiable 問題。 對於大多數情況下，改用 AppendUserAgent。
+
+ <preference name="OverrideUserAgent" value="Mozilla/5.0 My Browser" />
+
+
+* `AppendUserAgent`(字串，預設情況下未設置): 如果設置，值將附加到年底老使用者代理的 web 視圖。 當使用 OverrideUserAgent，此值將被忽略。
+
+ <preference name="AppendUserAgent" value="My Browser" />
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/dev/guide/platforms/android/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/android/index.md b/www/docs/zh-cn/dev/guide/platforms/android/index.md
new file mode 100644
index 0000000..7c103e0
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/android/index.md
@@ -0,0 +1,275 @@
+---
+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.
+
+title: Android 平臺指南
+---
+
+# Android 平臺指南
+
+本指南演示如何設置您的 SDK 環境部署科爾多瓦的 Android 設備的應用程式以及如何在您的開發工作流中 （可選） 使用 Android 居中的命令列工具。 您需要安裝 Android SDK 無論是否你想要使用這些平臺為中心的外殼工具或跨平臺 Cordova CLI 的發展。 兩條發展路徑的比較，請參見概述。 CLI 的詳細資訊，請參閱命令列介面。
+
+## 要求和支援
+
+科爾多瓦安卓系統要求可以在 OS X、 Linux 或 Windows 作業系統安裝 Android SDK。 請參閱 Android SDK[的系統要求][1].
+
+ [1]: http://developer.android.com/sdk/index.html#Requirements
+
+科爾多瓦支援 Android 4.0.x (入手 Android API 級別 14） 和更高。 作為一般規則，Android 版本成為受科爾多瓦作為他們低於 5%的谷歌的[分佈的儀表板][2]。 Android 版本早于 API 級別 10，和 3.x 版本 （蜂窩，API 級別 11 13） 顯著低於那 5%的門檻。
+
+ [2]: http://developer.android.com/about/dashboards/index.html
+
+## 安裝科爾多瓦殼工具
+
+如果您想要使用科爾多瓦的 Android 居中外殼工具與 SDK 一起，從[cordova.apache.org][3]下載科爾多瓦。 如果您計畫使用所述的命令列介面的跨平臺 CLI 工具，否則忽略此節。
+
+ [3]: http://cordova.apache.org
+
+科爾多瓦下載包含單獨的檔案，為每個平臺。 一定要展開相應的存檔， `android` 在這種情況下，在一個空的目錄內。 有關 executible 實用程式可用在頂級 `bin` 目錄。 (參閱**自述**檔，如果有必要作更詳細的指示）。
+
+這些外殼工具允許您創建、 構建和運行 Android 應用程式。 額外的命令列介面，可以跨所有平臺的外掛程式功能的資訊，請參閱使用 Plugman 到管理外掛程式。 有關如何開發外掛程式的詳細資訊，請參閱應用程式外掛程式。
+
+## 安裝 JAVA 開發工具箱 （JDK）
+
+安裝[JAVA 開發工具箱 （JDK） 7][4]或更高版本。
+
+ [4]: http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html
+
+在 Windows 上安裝時您還需要設置`JAVA_HOME`環境變數根據 JDK 安裝路徑 （例如，C:\Program Files\JAVA\jdk1.7.0_75）。
+
+## 安裝 Android SDK
+
+安裝[獨立的 Android SDK 工具][5]或[Android 的工作室][6]。 如果您計畫開發新科爾多瓦為 Android 外掛程式或使用本機工具來運行和調試 Android 平臺`Android 工作室`水墨畫之發展。 否則， `Android 獨立 SDK 工具`就足以構建和部署 Android 應用程式。
+
+ [5]: http://developer.android.com/sdk/installing/index.html?pkg=tools
+ [6]: http://developer.android.com/sdk/installing/index.html?pkg=studio
+
+詳細的安裝說明，請參見上面的安裝連結的一部分。
+
+科爾多瓦的命令列工具來工作，或者基於他們的 CLI，您需要在您的`路徑`中包括 SDK 的`工具`和`平臺工具`目錄。 在 Mac 或 Linux 上，你可以使用一個文字編輯器來創建或修改`~/.bash_profile`檔，添加行，如下，根據 SDK 安裝的位置:
+
+ export PATH=${PATH}:/Development/android-sdk/platform-tools:/Development/android-sdk/tools
+
+
+這條線在`~/.bash_profile`公開這些工具在新打開的終端視窗。 如果您的終端視窗已經打開在 OSX，或避免在 Linux 上的登出/登錄，運行此工具以使他們在當前的終端視窗中可用：
+
+ $ source ~/.bash_profile
+
+
+若要修改`PATH`在窗戶上的環境：
+
+1. 在桌面的左下角的**開始**功能表上按一下，在**電腦**上，按右鍵，然後選擇**屬性**.
+
+2. 在左邊的列中選擇**高級系統設置**。
+
+3. 在結果對話方塊中，按下**環境變數**.
+
+4. 選擇**PATH**變數，然後按**編輯**.
+
+5. 追加到以下 `PATH` 基於在安裝 SDK，例如：
+
+ ;C:\Development\android-sdk\platform-tools;C:\Development\android-sdk\tools
+
+
+6. 將值保存並關閉這兩個對話方塊。
+
+## 安裝 SDK 套裝程式
+
+打開 Android SDK 管理器 （例如，通過終端： `android`） 並安裝：
+
+1. Android 5.1.1 （API 22） 平臺 SDK
+2. Android SDK 生成工具版本 19.1.0 或更高版本
+3. Android 支援存儲庫 （額外）
+
+有關更多詳細資訊，請參閱[安裝 SDK 包][7]。
+
+ [7]: http://developer.android.com/sdk/installing/adding-packages.html
+
+## 配置模擬器
+
+預設情況下，android sdk 並不提供任何預設模擬程式實例。 您可以創建一個新的通過在命令列上運行`android` 。 新聞**工具 → 管理 AVDs** （Android 的虛擬裝置），然後從**裝置定義**在隨後出現的對話方塊中選擇任何項：
+
+![][8]
+
+ [8]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_device.png
+
+按**創建 AVD**，（可選） 修改該名稱，然後按**確定**以接受這些更改：
+
+![][9]
+
+ [9]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_newAVD.png
+
+AVD 然後出現在**虛擬的 Android 設備**清單中：
+
+![][10]
+
+ [10]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_avds.png
+
+若要打開模擬器作為單獨的應用程式，請選擇 AVD，然後按**開始**。它推出一樣在設備上，使用其他控制項可用的硬體按鈕:
+
+![][11]
+
+ [11]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_emulator.png
+
+為獲得更快的體驗，你可以使用`虛擬機器加速`以提高執行速度。 許多現代的 Cpu 提供擴展外掛程式，以更有效地執行虛擬機器。 嘗試使用這種類型的加速度之前，您需要確定是否您當前的開發系統 CPU 支援一種以下的虛擬化技術：
+
+* **英特爾虛擬化技術**(VT-x，vmx) →[英特爾 VT-x 支援的處理器清單][12]
+* **AMD 虛擬化**（AMD-V，支援向量機），只支援 Linux （自 2006 年 5 月以來所有 Cpu AMD 都包括 AMD-V，閃龍除外）。
+
+ [12]: http://ark.intel.com/products/virtualizationtechnology
+
+另一種方法來找出是否您的英特爾處理器支援 VT x 技術、 它是由執行`英特爾處理器識別實用程式`、 `Windows`為您可以從英特爾[下載中心][13]，下載它或您可以使用[booteable 實用程式][14]，它是`獨立于作業系統`.
+
+ [13]: https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7838
+ [14]: https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7840&lang=eng
+
+後安裝和執行的`英特爾處理器識別實用程式`在 Windows 中，你會得到下面的視窗，以檢查是否您的 CPU 支援虛擬化技術：
+
+![][15]
+
+ [15]: {{ site.baseurl }}/static/img/guide/platforms/android/intel_pid_util_620px.png
+
+為了加快模擬程式，您需要下載並安裝一個或多個`Intel x86 原子`系統映射，以及`英特爾硬體加速執行經理 (HAXM)`.
+
+打開你的 Android SDK 經理，並選擇`Intel x86 原子`系統的形象，為任何一個你想要測試的版本。 然後轉到`臨時演員`和選擇`Intel x86 模擬器加速器 （HAXM）`，並安裝這些套裝軟體：
+
+![][16]
+
+ [16]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_man_intel_image_haxm.png
+
+下載後，運行英特爾安裝程式時，這是你 Android SDK 在`臨時演員/英特爾/Hardware_Accelerated_Execution_Manager`中可用。 **注意**：`如果您有任何問題，安裝套裝軟體，你可以找到更多的資訊和一步一步指導檢查這` [篇文章英特爾][17].
+
+ [17]: http://software.intel.com/en-us/android/articles/speeding-up-the-android-emulator-on-intel-architecture
+
+1. 安裝一個或多個`Intel x86 原子`系統映射，以及`英特爾硬體加速執行管理器`，可根據**臨時演員**.
+
+2. 運行英特爾安裝程式時，這是你 Android SDK 在`臨時演員/英特爾/Hardware_Accelerated_Execution_Manager`中可用.
+
+3. 目標設置為英特爾圖像創建新的 AVD。
+
+4. 當啟動模擬程式，確保有沒有錯誤訊息，指示載入 HAX 模組失敗。
+
+## 創建一個新的專案
+
+在這一點上，要創建一個新的專案你可以選擇之間跨平臺 CLI 工具的命令列介面或一組特定于 Android 的 shell 工具中所述。 從在原始程式碼目錄中，這裡是 CLI 的方法：
+
+ $ cordova create hello com.example.hello HelloWorld
+ $ cd hello
+ $ cordova platform add android
+ $ cordova prepare # or "cordova build"
+
+
+這裡是 Unix 和 Windows 的相應較低級別 shell 工具方法：
+
+ $ /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
+
+
+## 生成專案
+
+如果您在開發中使用 CLI，專案目錄頂級`www`目錄中包含的原始程式碼檔。運行任何這些專案目錄重新生成該應用程式中：
+
+ $ cordova build # build all platforms that were added
+ $ cordova build android # build debug for only Android
+ $ cordova build android --debug # build debug for only Android
+ $ cordova build android --release # build release for only Android
+
+
+如果使用的特定于 Android 的 shell 工具在發展中，還有一個不同的方法。 一旦您生成專案時，預設的應用程式的來源是可用的`資產/www`子目錄中。 後續的命令，可在其`科爾多瓦`子目錄。
+
+`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
+
+
+## 部署應用程式
+
+`科爾多瓦`CLI 實用程式可用於應用程式部署到模擬器或設備從命令列：
+
+ $ cordova emulate android #to deploy the app on a default android emulator
+ $ cordova run android --device #to deploy the app on a connected device
+
+
+否則，請使用備用殼介面：
+
+ $ /path/to/project/cordova/run --emulator
+ $ /path/to/project/cordova/run --device
+
+
+您可以使用**cordova run android --list**看到所有可用的目標和**cordova run android --target=target_name**在一個特定的設備或模擬器上運行應用程式 （例如，`cordova run android --target="Nexus4_emulator"`).
+
+您還可以使用**cordova run --help**查看附加的生成和運行選項。
+
+這將應用程式推送至主畫面，啟動它：
+
+![][18]
+
+ [18]: {{ site.baseurl }}/static/img/guide/platforms/android/emulator2x.png
+
+當您`run`該應用程式，您還`build`它。 您可以附加額外`--debug`， `--release`，和`--nobuild`標誌來控制它如何構建的或甚至是否重建是必需的：
+
+ $ /path/to/project/cordova/run --emulator --nobuild
+
+
+## 其他命令
+
+下列生成詳細的日誌，該應用程式的運行時：
+
+ $ /path/to/project/cordova/log
+ C:\path\to\project\cordova\log.bat
+
+
+以下清理的專案檔案：
+
+ $ /path/to/project/cordova/clean
+ C:\path\to\project\cordova\clean.bat
+
+
+## 在 SDK 中打開一個新專案
+
+一旦 android 平臺添加到專案中，你可以打開它從[Android Studio][6]內：
+
+1. 推出**Android 工作室**中的應用。
+
+2. 選擇**導入專案 （Eclipse ADT，Gradle 等）**.
+
+ ![][19]
+
+3. 選擇存儲 （`你/專案/platforms/android` android 平臺的位置).
+
+ ![][20]
+
+4. `Gradle Sync`問題你可以乾脆的回答**是**.
+
+ [19]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_import_project.png
+ [20]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_import_select_location.png
+
+你現在有所有的和可以從生成並運行該應用程式直接`Android 工作室`.
+
+![][21]
+
+ [21]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_import_done.png
+
+請參閱[Android 工作室概述][22][生成並運行從 Android 工作室][23]為更多的細節。
+
+ [22]: http://developer.android.com/tools/studio/index.html
+ [23]: http://developer.android.com/tools/building/building-studio.html
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org