cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dblot...@apache.org
Subject [05/51] [partial] docs commit: Adding both Chinese versions.
Date Wed, 06 Apr 2016 09:27:21 GMT
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/dev/guide/platforms/android/plugin.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/android/plugin.md b/www/docs/zh-cn/dev/guide/platforms/android/plugin.md
new file mode 100644
index 0000000..8b341e6
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/android/plugin.md
@@ -0,0 +1,179 @@
+---
+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 外掛程式
+
+此部分提供了如何在 Android 平臺上實現本機外掛程式代碼的詳細資訊。 之前讀這篇文章,請參閱應用程式外掛程式外掛程式的結構和其共同的 JavaScript 介面的概述。 這一節繼續表明通信從科爾多瓦 web 視圖的本機平臺和後面的示例*回聲*外掛程式。 另一個示例,請參閱還在[CordovaPlugin.java][1]的評論.
+
+ [1]: https://github.com/apache/cordova-android/blob/master/framework/src/org/apache/cordova/CordovaPlugin.java
+
+Android 外掛程式基於科爾多瓦-Android,Android 的 web 視圖包括與附加到它上面的鉤子。 外掛程式被表示為類映射的 `config.xml` 檔。 外掛程式包括至少一個擴展的 JAVA 類的 `CordovaPlugin` 類,重寫的一個其 `execute` 方法。 作為最佳實踐,該外掛程式還應處理 `[pause](../../../cordova/events/events.pause.html)` 和 `[resume](../../../cordova/events/events.resume.html)` 事件,以及任何外掛程式之間傳遞的消息。 外掛程式需要長時間運行的請求,後臺活動媒體重播、 聽眾或內部狀態等應執行 `onReset()` ,以及方法。 它執行時 `WebView` 定位到新的一頁或刷新,重新載入 JavaScript。
+
+## 外掛程式類映射
+
+外掛程式的 JavaScript 介面使用 `cordova.exec` 方法,如下所示:
+
+        exec (< successFunction > < failFunction >、 < 服務 >、 < 行動 > [< args >]) ;
+    
+
+這封送請求從 web 視圖到 Android 的本機對岸,有效地調用 `action` 方法 `service` 具有額外的參數中傳遞的類 `args` 陣列。
+
+是否您分發外掛程式作為 JAVA 檔或作為它自己的一個*jar*檔,必須在科爾多瓦 Android 應用程式中指定外掛程式 `res/xml/config.xml` 檔。 有關如何使用的詳細資訊,請參閱應用程式外掛程式 `plugin.xml` 檔,把這個注射 `feature` 元素:
+
+        <feature name="<service_name>">
+            <param name="android-package" value="<full_name_including_namespace>" />
+        </feature>
+    
+
+服務名稱匹配在 JavaScript 中使用 `exec` 調用。 值是 JAVA 類的完全限定命名空間識別碼。 否則為該外掛程式可能會編譯,但仍不能使用到科爾多瓦。
+
+## 外掛程式初始化和存留期
+
+外掛程式物件的一個實例創建為生活的每個 `WebView` 。 外掛程式不會具現化之前他們第一次引用通過調用從 JavaScript,除非 `<param>` 與 `onload` `name` 屬性設置為 `"true"` 的 `config.xml` 。 例如:
+
+    <feature name="Echo">
+        <param name="android-package" value="<full_name_including_namespace>" />
+        <param name="onload" value="true" />
+    </feature>
+    
+
+外掛程式應使用 `initialize` 方法為他們的創業邏輯。
+
+    @Override
+    public void initialize(CordovaInterface cordova, CordovaWebView webView) {
+        super.initialize(cordova, webView);
+        // your init code here
+    }
+    
+
+## 編寫一個 Android JAVA 外掛程式
+
+JavaScript 調用觸發外掛程式請求到本機的一邊,和相應的 JAVA 外掛程式映射正確地在 `config.xml` 檔中,但最後的 Android JAVA 外掛程式類看起來不會像什麼? 無論派往與 JavaScript 的外掛程式 `exec` 函數傳遞到外掛程式類的 `execute` 方法。 大多數 `execute` 實現看起來像這樣:
+
+        @Override 公共 boolean 類型的值執行 CallbackCoNtext callbackCoNtext JSONArray args 字串操作) 將引發 JSONException {如果 ("beep".equals(action)) {this.beep(args.getLong(0));callbackCoNtext.success() ;則返回 true ;} 返回 false ;/ / 返回 false 結果的"MethodNotFound"錯誤。
+        }
+    
+
+JavaScript `exec` 函數的 `action` 參數對應于一個類的私有類方法派遣了可選參數。
+
+當捕獲異常,並返回錯誤,重要的是為了明確起見,錯誤返回給 JavaScript 匹配 JAVA 異常名稱盡可能多。
+
+## 執行緒
+
+外掛程式的 JavaScript 並*不*在主執行緒中運行 `WebView` 介面 ; 相反,它會運行 `WebCore` 執行緒,一樣 `execute` 方法。 如果您需要與使用者介面進行交互,則應使用以下變化:
+
+        @Override
+        public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException {
+            if ("beep".equals(action)) {
+                final long duration = args.getLong(0);
+                cordova.getActivity().runOnUiThread(new Runnable() {
+                    public void run() {
+                        ...
+                        callbackContext.success(); // Thread-safe.
+                    }
+                });
+                return true;
+            }
+            return false;
+        }
+    
+
+使用以下如果你不需要在主介面上運行的執行緒,但不是想阻止 `WebCore` 執行緒或者:
+
+        @Override
+        public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException {
+            if ("beep".equals(action)) {
+                final long duration = args.getLong(0);
+                cordova.getThreadPool().execute(new Runnable() {
+                    public void run() {
+                        ...
+                        callbackContext.success(); // Thread-safe.
+                    }
+                });
+                return true;
+            }
+            return false;
+        }
+    
+
+## 回聲 Android 外掛程式示例
+
+若要匹配的 JavaScript 介面*回波*特徵描述的應用程式外掛程式,使用 `plugin.xml` 來注入 `feature` 到本地平臺規範 `config.xml` 檔:
+
+        <platform name="android">
+            <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.");
+                }
+            }
+        }
+    
+
+必要的進口商品在檔的頂部延伸中的類 `CordovaPlugin` ,其 `execute()` 方法,它將覆蓋從其接收郵件 `exec()` 。 `execute()`方法第一次測試的值 `action` ,在這種情況下有有效期的只有一個 `echo` 的值。 任何其他行動返回 `false` ,並導致 `INVALID_ACTION` 錯誤,會轉換為調用的 JavaScript 一邊錯誤回檔。
+
+下一步,該方法檢索 echo 字串使用 `args` 物件的 `getString` 方法,指定的第一個參數傳遞給該方法。 值傳遞給一個私人後 `echo` 的方法,它是參數檢查,以確保它不是 `null` 或空字串,這種情況下的 `callbackContext.error()` 調用 JavaScript 的錯誤回檔。 如果通過各種檢查, `callbackContext.success()` 將傳遞原始 `message` 回 JavaScript 的成功回檔作為參數的字串。
+
+## Android 系統集成
+
+Android 功能 `Intent` 允許進程互相溝通的系統。 外掛程式可以訪問 `CordovaInterface` 物件,可以訪問 Android `Activity` ,運行應用程式。 這是 `Context` 啟動新的 android 系統所需 `Intent` 。 `CordovaInterface`允許外掛程式啟動 `Activity` 一個結果,並設置回檔外掛程式時 `Intent` 返回到應用程式。
+
+到科爾多瓦 2.0 外掛程式可以不再直接存取 `Context` ,和遺產 `ctx` 成員已被否決。 所有 `ctx` 的方法上存在 `Context` ,所以這兩個 `getContext()` 和 `getActivity()` 可以返回所需的物件。
+
+## 調試 Android 外掛程式
+
+Eclipse 允許您調試外掛程式作為 JAVA 原始程式碼包含在專案中。 只有最新版本的 Android 開發者工具允許您將原始程式碼附加到*JAR*的依賴關係,所以此功能尚不完全支援。
\ 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/tools.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/android/tools.md b/www/docs/zh-cn/dev/guide/platforms/android/tools.md
new file mode 100644
index 0000000..b1fdbba
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/android/tools.md
@@ -0,0 +1,205 @@
+---
+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 殼工具指南
+
+本指南演示如何使用平臺為中心的外殼工具科爾多瓦的一整套開發 Android 應用程式。 這種發展道路,概述中討論可能會為您提供比所述的命令列介面的跨平臺 CLI 工具更大範圍的發展方案。 例如,您需要部署一個科爾多瓦 web 視圖自訂旁邊的本機組件時使用外殼程式工具。 在使用之前要麼發展路徑,您必須首先配置 Android SDK 環境 Android 平臺指南中所述。
+
+要為 android 系統啟用外殼工具,請從[cordova.apache.org][1]下載科爾多瓦。 下載檔案中包含單獨的檔案,為每個平臺。 展開每個您想要的目標, `android` 在這種情況下。 相關的工具,通常可用在頂級 `bin` 目錄中,否則為諮詢**自述**檔,瞭解有關更多詳細的指示。
+
+ [1]: http://cordova.apache.org
+
+這些工具允許您創建、 構建和運行 Android 應用程式。 額外的命令列介面,可以跨所有平臺的外掛程式功能的資訊,請參閱使用 Plugman 到管理外掛程式。 有關如何開發外掛程式的詳細資訊,請參閱應用程式外掛程式。
+
+## 創建一個專案
+
+運行 `create` 命令,指定的現有路徑的專案、 反向域風格包識別碼和應用程式的顯示名稱。 這裡是 Mac/Linux 和 Windows 的語法:
+
+        $ /path/to/cordova-android/bin/create /path/to/project com.example.project_name ProjectName
+    
+        C:\>\path\to\cordova-android\bin\create.bat \path\to\project com.example.project_name ProjectName
+    
+
+## 生成
+
+此清理,然後生成專案。
+
+在 Mac/Linux 或 Windows 上調試:
+
+        $ /path/to/project/cordova/build --debug
+    
+        C:\>\path\to\project\cordova\build.bat --debug
+    
+
+釋放,Mac/Linux 或 Windows 上:
+
+        $ /path/to/project/cordova/build --release
+    
+        C:\>\path\to\project\cordova\build.bat --release
+    
+
+## 運行應用程式
+
+`run`命令接受下列*可選*的參數:
+
+*   目標規範。這包括 `--emulator` , `--device` ,或`--target=<targetID>`.
+
+*   生成規范。這包括 `--debug` , `--release` ,或`--nobuild`.
+    
+        $ /path/to/project/cordova/run [Target] [Build]
+        
+        C:\>\path\to\project\cordova\run.bat [Target] [Build]
+        
+
+請確保您創建至少一個 Android 虛擬裝置,否則為系統會提示您這樣與做 `android` 命令。 如果多個 AVD 可用作為目標,提示您選擇一個。 預設情況下 `run` 命令檢測連接的設備或當前正在運行的模擬程式,如果沒有設備發現。
+
+## 簽署應用程式
+
+您可以查看簽名要求在這裡的安卓應用程式: HTTP://developer.android.com/tools/publishing/app-signing.html
+
+要簽名的應用程式,您需要以下參數:
+
+*   金鑰庫 (`--keystore`): 可容納一套鑰匙的二進位檔案的路徑。
+
+*   金鑰庫口令 (`-storePassword`): 到金鑰庫的密碼
+
+*   別名 (`--alias`): 指定私密金鑰用於唱歌的 id。
+
+*   * 密碼 (`--password`): 為指定的私密金鑰的密碼。
+
+*   金鑰庫 (`--keystoreType`) 類型: pkcs12 jks (預設: 自動檢測基於檔副檔名)
+
+可以使用`build`或`run`腳本上面的命令列參數指定這些參數。
+
+或者,您可以指定它們在組建組態檔 (build.json) 中使用 ( `--buildConfig` ) 參數。這裡是組建組態檔的一個示例:
+
+    {
+         "android": {
+             "debug": {
+                 "keystore": "..\android.keystore",
+                 "storePassword": "android",
+                 "alias": "mykey1",
+                 "password" : "password",
+                 "keystoreType": ""
+             },
+             "release": {
+                 "keystore": "..\android.keystore",
+                 "storePassword": "",
+                 "alias": "mykey2",
+                 "password" : "password",
+                 "keystoreType": ""
+             }
+         }
+     }
+    
+
+對於發佈簽名,可以排除密碼和構建系統會發出提示要求輸入密碼。
+
+此外,它還支援以混合和匹配的命令列參數和 build.json 檔中的參數。 從命令列參數的值將會得到優先。 這可用於在命令列上指定的密碼。
+
+## 日誌記錄
+
+        $ /path/to/project/cordova/log
+    
+        C:\>\path\to\project\cordova\log.bat
+    
+
+## 清洗
+
+        $ /path/to/project/cordova/clean
+    
+        C:\>\path\to\project\cordova\clean.bat
+    
+
+## Gradle 建築
+
+截至 cordova-android@4.0.0,專案生成使用[Gradle][2]。 關於建設與螞蟻的說明,請參閱文檔的舊版本。
+
+ [2]: http://www.gradle.org/
+
+### Gradle 屬性
+
+可以設置這些[屬性][3]以自訂生成:
+
+ [3]: http://www.gradle.org/docs/current/userguide/tutorial_this_and_that.html
+
+*   **cdvBuildMultipleApks**(預設: false)
+    
+    如果設置此值,則將生成多個 APK 檔: 庫專案所支援的本機平臺每一個 (x 86,ARM,等)。 這可能是重要的如果您的專案使用大型的本機庫,可以大幅增加生成 apk 檔的大小。
+    
+    如果未設置,然後將生成單個 APK,可以在所有設備上使用。
+
+*   **cdvVersionCode**
+    
+    VersionCode 在`AndroidManifest.xml`中設置將重寫
+
+*   **cdvReleaseSigningPropertiesFile**(預設: release-signing.properties)
+    
+    包含簽名發佈的資訊進行.properties 檔路徑生成。 該檔應該看起來像:
+    
+        storeFile=relative/path/to/keystore.p12
+        storePassword=SECRET1
+        storeType=pkcs12
+        keyAlias=DebugSigningKey
+        keyPassword=SECRET2
+        
+    
+    `storePassword`和`keyPassword`是可選的如果省略將提示輸入。
+
+*   **cdvDebugSigningPropertiesFile**(預設: debug-signing.properties)
+    
+    同樣作為 cdvReleaseSigningPropertiesFile,但用於調試生成。當您需要與其他開發人員共用的簽名金鑰時有用。
+
+*   **cdvMinSdkVersion**
+    
+    重寫`minSdkVersion`在`AndroidManifest.xml`中設置的值。有用的當創建多個 APKs 基於 SDK 版本。
+
+*   **cdvBuildToolsVersion**
+    
+    重寫自動檢測到的`android.buildToolsVersion`值。
+
+*   **cdvCompileSdkVersion**
+    
+    重寫自動檢測到的`android.compileSdkVersion`值。
+
+### 擴展 build.gradle
+
+如果您需要自訂`build.gradle`,而不是直接編輯,您應該創建一個名為`build-extras.gradle`的同級檔。 此檔將包含由主要的`build.gradle`時本。 下面是一個示例:
+
+    # Example build-extras.gradle
+    # This file is included at the beginning of `build.gradle`
+    ext.cdvDebugSigningPropertiesFile = '../../android-debug-keys.properties'
+    # When set, this function allows code to run at the end of `build.gradle`
+    ext.postBuildExtras = {
+        android.buildTypes.debug.applicationIdSuffix = '.debug'
+    }
+    
+
+請注意,外掛程式也可以包括通過`build-extras.gradle`檔:
+
+    <framework src="some.gradle" custom="true" type="gradleReference" />
+    
+
+### 示例生成
+
+    export ORG_GRADLE_PROJECT_cdvMinSdkVersion=14
+    cordova build android -- --gradleArg=-PcdvBuildMultipleApks=true
\ 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/upgrade.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/android/upgrade.md b/www/docs/zh-cn/dev/guide/platforms/android/upgrade.md
new file mode 100644
index 0000000..12a1d12
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/android/upgrade.md
@@ -0,0 +1,500 @@
+---
+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
+
+本指南演示如何修改 Android 專案從科爾多瓦的舊版本進行升級。 大多數這些說明適用于與舊集的前面的命令列工具創建的專案 `cordova` CLI 實用程式。 資訊,請參閱命令列介面如何更新的 CLI 版本。
+
+## 升級到 4.0.0
+
+有利用 4.0.0 的重大變化所需的特定升級步驟。第一,常見的升級步驟,如下所示。
+
+對於非 CLI 專案,運行:
+
+        bin/update path/to/project
+    
+
+對於 CLI 專案:
+
+1.  更新 `cordova` CLI 版本。請參閱命令列介面。
+
+2.  在你現有的專案中運行 `cordova platform update android`。
+
+### 升級白名單
+
+現在通過外掛程式實現所有的白名單功能。 無外掛程式升級到 4.0.0 後您的應用程式不再卻是白名單的保護。科爾多瓦有兩個白名單外掛程式,提供不同的保護層級。
+
+1.  `cordova-plugin-whitelist` 外掛程式 *(推薦)*
+    
+    *   這個外掛程式被推薦的是更加安全和可配置比在以前的版本中白
+    *   在所需的配置更改上看到 [cordova-plugin-whitelist][1] 的詳細資訊
+    *   兼營: `cordova plugin add cordova-plugin-crosswalk-webview`
+
+2.  `cordova-plugin-legacy-whitelist` 外掛程式
+    
+    *   這個外掛程式提供了相同的白名單中行為,作為以前的版本。請參閱 [cordova-plugin-legacy-whitelist][2]
+    *   沒有配置更改是必需的但它提供了比推薦外掛程式的保護較少
+    *   兼營: `cordova-plugin-legacy-whitelist`
+
+ [1]: https://github.com/apache/cordova-plugin-whitelist
+ [2]: https://github.com/apache/cordova-plugin-legacy-whitelist
+
+### 使用人行橫道上 web 視圖
+
+預設情況下,您的應用程式將繼續使用 web 視圖提供的設備的系統。如果你想要改用人行橫道上 web 視圖,只需添加人行橫道上的外掛程式:
+
+    cordova plugin add cordova-plugin-crosswalk-webview
+    
+
+後添加的外掛程式,您的應用程式會得到人行橫道上 web 視圖正確安裝和配置。
+
+### 升級到閃屏外掛程式
+
+如果您的應用程式使用一個閃屏功能已被轉移到一個外掛程式。 用於初始螢幕的配置選項是不變的。 所需的只有升級步驟是要添加的外掛程式:
+
+    cordova plugin add cordova-plugin-splashscreen
+    
+
+## 從 3.6.0 版升級到 3.7.1
+
+對於非 CLI 專案,運行:
+
+        bin/update path/to/project
+    
+
+對於 CLI 專案:
+
+1.  更新 `cordova` CLI 版本。請參閱命令列介面。
+
+2.  運行 `cordova platform update android` 在你現有的專案中。
+
+## 從 3.2.0 升級到 3.3.0
+
+按照關於 `3.2.0` 相同的說明.
+
+入手 3.3.0,科爾多瓦運行時現在被編譯為 Android 的庫,而不是一個罐子裡。 這都不應該影響為命令列用法,但 IDE 使用者將需要新增的 `MyProject CordovaLib` 專案導入到他們的工作區。
+
+## 從 3.1.0 升級到 3.2.0
+
+為專案創建的科爾多瓦 CLI:
+
+1.  更新 `cordova` CLI 版本。請參閱命令列介面。
+
+2.  運行 `cordova platform update android`
+
+不創建與科爾多瓦 CLI 的專案,請運行:
+
+        bin/update <project_path>
+    
+
+**警告:**關於 Android 4.4-Android 4.4.3,創建檔輸入具有類型的元素 ="檔"將不會打開檔選取器對話方塊。 這是鉻對 Android 的回歸和能重現該問題在 Android 上獨立 Chrome 瀏覽器 (見 HTTP://code.google.com/p/android/issues/detail?id=62220) 建議的解決方法是使用的檔案傳輸和檔的外掛程式為 Android 4.4。您可以偵聽 onClick 事件從輸入類型 ="檔",然後彈出一個檔選擇器 UI。 為了打領帶表單資料的上傳,你可以使用 JavaScript 將表單值附加到多個部分的 POST 請求所使。
+
+## 從 3.0.0 升級到 3.1.0
+
+為專案創建的科爾多瓦 CLI:
+
+1.  更新 `cordova` CLI 版本。請參閱命令列介面。
+
+2.  運行 `cordova platform update android`
+
+不創建與科爾多瓦 CLI 的專案,請運行:
+
+        bin/update <project_path>
+    
+
+## 從 2.9.0 升級到 CLI (3.0.0)
+
+1.  創建一個新的 Apache 科爾多瓦 3.0.0 專案使用 CLI,科爾多瓦在命令列介面所述。
+
+2.  添加您的平臺的科爾多瓦的專案,例如: `cordova platform add android`.
+
+3.  將您的專案 `www` 目錄中的內容複寫到您剛剛創建的科爾多瓦專案根本 `www` 目錄。
+
+4.  將本機的任何資產從舊專案複製到相應的目錄下 `平臺/android`: 此目錄是您的本機科爾多瓦 android 專案所在。
+
+5.  使用科爾多瓦 CLI 工具來安裝您需要的任何外掛程式。注意,CLI 處理所有核心 Api 作為外掛程式,所以他們可能需要添加。只有 3.0.0 外掛程式是與 CLI 相容。
+
+## 從 2.9.0 升級到 3.0.0
+
+1.  創建一個新的 Apache 科爾多瓦 Android 專案。
+
+2.  將 `www` 目錄中的內容複寫到新專案中。
+
+3.  將任何原生的 Android 資產從 `res` 目錄複寫到新的專案。
+
+4.  複製您安裝到新專案的 `src` 子目錄中的任何外掛程式。
+
+5.  請務必升級任何棄用 `<plugin>` 從你舊的 `config.xml` 檔到新的 `<feature>` 規範的引用。
+
+6.  更新到 `org.apache.cordova.api` 包是 `org.apache.cordova` 的任何引用.
+    
+    **注**: 所有的核心 Api 已被刪除,並且必須作為外掛程式安裝。請有關詳細資訊,參閱使用 Plugman 管理外掛程式指南。
+
+## 從 2.8.0 升級到 2.9.0
+
+1.  運行 `bin/update <project_path>`.
+
+## 從 2.7.0 升級到 2.8.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-2.7.0.jar`。
+
+2.  將 `cordova-2.8.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+<!-- SS Eclipse -->
+
+1.  將新的 `cordova.js` 複製到您的專案。
+
+2.  更新你的 html 代碼,使用新的 `cordova.js` 檔。
+
+3.  要匹配 `framework/res/xml/config.xml` 的 `res/xml/config.xml` 檔的副本.
+
+4.  更新 `framework/res/xml/config.xml` 以前一樣有類似的設置。
+
+5.  將檔從複製 `bin/templates/cordova` 到專案的 `cordova` 目錄。
+
+## 從 2.6.0 升級到 2.7.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-2.6.0.jar`。
+
+2.  將 `cordova-2.7.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  將新的 `cordova-2.7.0.js` 複製到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-2.7.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+7.  更新 `framework/res/xml/config.xml` 以前一樣有類似的設置。
+
+8.  將檔從複製 `bin/templates/cordova` 到專案的 `cordova` 目錄。
+
+## 從 2.5.0 升級到 2.6.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-2.5.0.jar`。
+
+2.  將 `cordova-2.6.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.6.0.js` 到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-2.6.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+7.  更新 `framework/res/xml/config.xml` 以前一樣有類似的設置。
+
+8.  將檔從複製 `bin/templates/cordova` 到專案的 `cordova` 目錄。
+
+科爾多瓦原始目錄中列出的專案路徑與運行 `bin/update < 專案 >`。
+
+## 從 2.4.0 升級到 2.5.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-2.4.0.jar`。
+
+2.  將 `cordova-2.5.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.5.0.js` 到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-2.5.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+7.  更新 `framework/res/xml/config.xml` 以前一樣有類似的設置。
+
+8.  將檔從複製 `bin/templates/cordova` 到專案的 `cordova` 目錄。
+
+## 從 2.3.0 升級到 2.4.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-2.3.0.jar`。
+
+2.  將 `cordova-2.4.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.4.0.js` 到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-2.4.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+7.  將檔從複製 `bin/templates/cordova` 到專案中的 `cordova` 目錄。
+
+## 從 2.2.0 升級到 2.3.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-2.2.0.jar`。
+
+2.  將 `cordova-2.3.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.3.0.js` 到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-2.3.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+7.  將檔從複製 `bin/templates/cordova` 到專案的 `cordova` 目錄。
+
+## 從 2.1.0 升級到 2.2.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-2.1.0.jar`。
+
+2.  將 `cordova-2.2.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.2.0.js` 到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-2.2.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 相匹配`framework/res/xml/config.xml`.
+
+7.  將檔從複製 `bin/templates/cordova` 到專案的 `cordova` 目錄。
+
+## 從 2.0.0 升級到 2.1.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-2.0.0.jar`。
+
+2.  將 `cordova-2.1.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.1.0.js` 到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-2.1.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+7.  將檔從複製 `bin/templates/cordova` 到專案的 `cordova` 目錄。
+
+## 從 1.9.0 升級到 2.0.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-1.9.0.jar`。
+
+2.  將 `cordova-2.0.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.0.0.js` 到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-2.0.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+在 2.0.0 釋放,`config.xml` 檔相結合,並取代了 `cordova.xml` 和 `plugins.xml`。 舊的檔已被否決,和當他們仍然在 2.0.0,工作就會停止工作在將來的版本中。
+
+## 從 1.8.1 升級到 1.9.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-1.8.0.jar`。
+
+2.  將 `cordova-1.9.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  將新的 `cordova-1.9.0.js` 複製到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-1.9.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+由於引入了 `CordovaWebView` 在 1.9.0 釋放,協力廠商外掛程式可能無法工作。 這些外掛程式需要從 `CordovaInterface` 使用 `getContext()` 或 `getActivity()` 獲取上下文。 如果你不是一個經驗豐富的 Android 開發者,請聯繫外掛程式的維護者,並將該任務添加到其 bug 追蹤器。
+
+## 從 1.8.0 升級到 1.8.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-1.8.0.jar`。
+
+2.  將 `cordova-1.8.1.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  將新的 `cordova-1.8.1.js` 複製到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-1.8.1.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 相匹配`framework/res/xml/plugins.xml`.
+
+## 從 1.7.0 以來升級到 1.8.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-1.7.0.jar`。
+
+2.  將 `cordova-1.8.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-1.8.0.js` 到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-1.8.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+## 從 1.7.0 以來升級到 1.8.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-1.7.0.jar`。
+
+2.  將 `cordova-1.8.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-1.8.0.js` 到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-1.8.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+## 從 1.6.1 升級到 1.7.0 以來
+
+1.  從專案的 `libs` 目錄刪除 `cordova-1.6.1.jar`。
+
+2.  將 `cordova-1.7.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案和做清潔。
+
+4.  將新的 `cordova-1.7.0.js` 複製到您的專案。
+
+5.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+## 從 1.6.0 升級到 1.6.1
+
+1.  從專案的 `libs` 目錄刪除 `cordova-1.6.0.jar`。
+
+2.  將 `cordova-1.6.1.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  將新的 `cordova-1.6.1.js` 複製到您的專案。
+
+5.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+## 從 1.5.0 版升級到 1.6.0
+
+1.  從專案的 `libs` 目錄刪除 `cordova-1.5.0.jar`。
+
+2.  將 `cordova-1.6.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  將新的 `cordova-1.6.0.js` 複製到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-1.6.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+7.  替換 `res/xml/cordova.xml` 以匹配 `framework/res/xml/cordova.xml` `res/xml/phonegap.xml`.
+
+## 從 1.4.0 升級到 1.5.0 版
+
+1.  從專案的 `libs` 目錄刪除 `phonegap-1.4.0.jar`。
+
+2.  將 `cordova-1.5.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  將新的 `cordova-1.5.0.js` 複製到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `cordova-1.5.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+7.  替換 `res/xml/cordova.xml` 以匹配 `framework/res/xml/cordova.xml` `res/xml/phonegap.xml`.
+
+## 從 1.3.0 升級到 1.4.0
+
+1.  從專案的 `libs` 目錄刪除 `phonegap-1.3.0.jar`。
+
+2.  將 `phonegap-1.4.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  將新 `phonegap-1.4.0.js` 複製到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `phonegap-1.4.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+7.  更新 `res/xml/phonegap.xml` 相匹配`framework/res/xml/phonegap.xml`.
+
+## 從 1.2.0 升級到 1.3.0
+
+1.  從專案的 `libs` 目錄刪除 `phonegap-1.2.0.jar`。
+
+2.  將 `phonegap-1.3.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  將新 `phonegap-1.3.0.js` 複製到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `phonegap-1.2.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 相匹配`framework/res/xml/plugins.xml`.
+
+7.  更新 `res/xml/phonegap.xml` 以匹配`framework/res/xml/phonegap.xml`.
+
+## 請升級到 1.2.0 從 1.1.0
+
+1.  從專案的 `libs` 目錄刪除 `phonegap-1.1.0.jar`。
+
+2.  將 `phonegap-1.2.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案和做清潔。
+
+4.  將新 `phonegap-1.2.0.js` 複製到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `phonegap-1.2.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+7.  更新 `res/xml/phonegap.xml` 以匹配`framework/res/xml/phonegap.xml`.
+
+## 從 1.0.0 升級到 1.1.0
+
+1.  從專案的 `libs` 目錄刪除 `phonegap-1.0.0.jar`。
+
+2.  將 `phonegap-1.1.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果你使用 Eclipse,請刷新您的 Eclipse 專案和做清潔。
+
+4.  將新 `phonegap-1.1.0.js` 複製到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `phonegap-1.1.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+## 從 0.9.6 升級到 1.0.0
+
+1.  從專案的 `libs` 目錄刪除 `phonegap-0.9.6.jar`。
+
+2.  將 `phonegap-1.0.0.jar` 添加到專案的 `libs` 目錄。
+
+3.  如果你使用 Eclipse,請刷新您的 Eclipse 專案和做清潔。
+
+4.  將新 `phonegap-1.0.0.js` 複製到您的專案。
+
+5.  更新你的 html 代碼,使用新的 `phonegap-1.0.0.js` 檔。
+
+6.  添加 `res/xml/plugins.xml` 以匹配 `framework/res/xml/plugins.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/upgrading.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/android/upgrading.md b/www/docs/zh-cn/dev/guide/platforms/android/upgrading.md
new file mode 100644
index 0000000..335a4b5
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/android/upgrading.md
@@ -0,0 +1,436 @@
+---
+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
+
+本指南演示如何修改 Android 專案從科爾多瓦的舊版本進行升級。 大多數這些說明適用于與舊集的前面的命令列工具創建的專案 `cordova` CLI 實用程式。 命令列介面資訊,請參閱如何更新的 CLI 版本。
+
+## 從 3.2.0 升級到 3.3.0
+
+遵循相同的 instructinos`3.2.0`.
+
+從 3.3.0 開始,科爾多瓦運行時是現在作為編譯 Android 的庫,而不是 Jar。 這都不應該影響對於命令列用法,但 IDE 使用者將需要導入到新添加的 `MyProject-CordovaLib` 到其工作區中的專案。
+
+## 從 3.1.0 升級到 3.2.0
+
+為創建的科爾多瓦 CLI 的專案:
+
+1.  更新 `cordova` CLI 版本。請參閱命令列介面。
+
+2.  運行`cordova platform update android`
+
+對於不使用 CLI 科爾多瓦創建的專案,請運行:
+
+        bin/update <project_path>
+    
+
+## 從 3.0.0 升級到 3.1.0
+
+為創建的科爾多瓦 CLI 的專案:
+
+1.  更新 `cordova` CLI 版本。請參閱命令列介面。
+
+2.  運行`cordova platform update android`
+
+對於不使用 CLI 科爾多瓦創建的專案,請運行:
+
+        bin/update <project_path>
+    
+
+## 從 2.9.0 升級到 CLI (3.0.0)
+
+1.  創建新的 Apache 科爾多瓦 3.0.0 專案使用 CLI,科爾多瓦,如所述的命令列介面。
+
+2.  添加您的平臺的科爾多瓦專案,例如:`cordova
+platform add android`.
+
+3.  您的專案的內容複寫 `www` 到目錄 `www` 目錄在您剛剛創建的科爾多瓦專案的根目錄。
+
+4.  將本機的任何資產從舊專案複製到相應的目錄下 `platforms/android` : 此目錄是您的本機科爾多瓦 android 專案存在的地方。
+
+5.  使用科爾多瓦 CLI 工具來安裝您需要的任何外掛程式。請注意 CLI 處理所有核心 Api 作為外掛程式,所以他們可能需要添加。只有 3.0.0 外掛程式是與 CLI 相容。
+
+## 從 2.9.0 升級到 3.0.0
+
+1.  創建一個新的 Apache 科爾多瓦 Android 專案。
+
+2.  將複製的內容你 `www` 目錄到新的專案。
+
+3.  複製任何本機的 Android 資產從您 `res` 目錄到新的專案。
+
+4.  複製在你安裝從任何外掛程式 `src` 子目錄到新專案。
+
+5.  請確保要升級任何棄用 `<plugin>` 從你的舊的引用 `config.xml` 到新檔 `<feature>` 規範。
+
+6.  更新對任何引用 `org.apache.cordova.api` 包被`org.apache.cordova`.
+    
+    **注**: 所有核心 Api 已被移除,必須作為外掛程式安裝。請有關詳細資訊,參閱管理外掛程式指南的使用 Plugman。
+
+## 從 2.8.0 升級到 2.9.0
+
+1.  運行`bin/update <project_path>`.
+
+## 從 2.7.0 升級到 2.8.0
+
+1.  刪除 `cordova-2.7.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-2.8.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+<!-- SS Eclipse -->
+
+1.  複製新 `cordova.js` 到您的專案。
+
+2.  更新您的 html 代碼,使用新的 `cordova.js` 檔。
+
+3.  複製 `res/xml/config.xml` 檔,以匹配`framework/res/xml/config.xml`.
+
+4.  更新 `framework/res/xml/config.xml` 以前一樣有類似的設置。
+
+5.  將檔從複製 `bin/templates/cordova` 到專案中的 `cordova` 目錄。
+
+## 從 2.6.0 升級到 2.7.0
+
+1.  刪除 `cordova-2.6.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-2.7.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.7.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-2.7.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+7.  更新 `framework/res/xml/config.xml` 以前一樣有類似的設置。
+
+8.  將檔從複製 `bin/templates/cordova` 到專案中的 `cordova` 目錄。
+
+## 從 2.5.0 升級到 2.6.0
+
+1.  刪除 `cordova-2.5.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-2.6.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.6.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-2.6.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+7.  更新 `framework/res/xml/config.xml` 以前一樣有類似的設置。
+
+8.  將檔從複製 `bin/templates/cordova` 到專案中的 `cordova` 目錄。
+
+運行 `bin/update <project>` 的專案路徑與科爾多瓦原始目錄中列出。
+
+## 從 2.4.0 升級到 2.5.0
+
+1.  刪除 `cordova-2.4.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-2.5.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.5.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-2.5.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+7.  更新 `framework/res/xml/config.xml` 以前一樣有類似的設置。
+
+8.  將檔從複製 `bin/templates/cordova` 到專案中的 `cordova` 目錄。
+
+## 從 2.3.0 升級到 2.4.0
+
+1.  刪除 `cordova-2.3.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-2.4.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.4.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-2.4.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+7.  將檔從複製 `bin/templates/cordova` 到專案中的 `cordova` 目錄。
+
+## 從 2.2.0 升級到 2.3.0
+
+1.  刪除 `cordova-2.2.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-2.3.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.3.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-2.3.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+7.  將檔從複製 `bin/templates/cordova` 到專案中的 `cordova` 目錄。
+
+## 從 2.1.0 升級到 2.2.0
+
+1.  刪除 `cordova-2.1.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-2.2.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.2.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-2.2.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+7.  將檔從複製 `bin/templates/cordova` 到專案中的 `cordova` 目錄。
+
+## 從 2.0.0 升級到 2.1.0
+
+1.  刪除 `cordova-2.0.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-2.1.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.1.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-2.1.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+7.  將檔從複製 `bin/templates/cordova` 到專案中的 `cordova` 目錄。
+
+## 從 1.9.0 升級到 2.0.0
+
+1.  刪除 `cordova-1.9.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-2.0.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-2.0.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-2.0.0.js` 檔。
+
+6.  複製 `res/xml/config.xml` 以匹配`framework/res/xml/config.xml`.
+
+在 2.0.0 版、 `config.xml` 檔結合和替換 `cordova.xml` 和 `plugins.xml` 。 舊的檔已被否決,,雖然他們仍工作在 2.0.0,將停止在將來的版本中工作。
+
+## 從 1.8.1 升級到 1.9.0
+
+1.  刪除 `cordova-1.8.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-1.9.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-1.9.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-1.9.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+由於採用了 `CordovaWebView` 的 1.9.0 版本中,協力廠商外掛程式可能無法工作。 這些外掛程式需要獲取上下文從 `CordovaInterface` 使用 `getContext()` 或 `getActivity()` 。 如果您不是一個經驗豐富的 Android 開發者,請聯繫外掛程式的維護者和將這項任務添加到其 bug 跟蹤工具。
+
+## 從 1.8.0 升級到 1.8.0
+
+1.  刪除 `cordova-1.8.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-1.8.1.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-1.8.1.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-1.8.1.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+## 從 1.7.0 升級到 1.8.0
+
+1.  刪除 `cordova-1.7.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-1.8.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-1.8.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-1.8.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+## 從 1.7.0 升級到 1.8.0
+
+1.  刪除 `cordova-1.7.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-1.8.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-1.8.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-1.8.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+## 從 1.6.1 升級到 1.7.0
+
+1.  刪除 `cordova-1.6.1.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-1.7.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-1.7.0.js` 到您的專案。
+
+5.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+## 從 1.6.0 升級到 1.6.1
+
+1.  刪除 `cordova-1.6.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-1.6.1.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-1.6.1.js` 到您的專案。
+
+5.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+## 從 1.5.0 版升級到 1.6.0
+
+1.  刪除 `cordova-1.5.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-1.6.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-1.6.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-1.6.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+7.  替換 `res/xml/phonegap.xml` 與 `res/xml/cordova.xml` 進行匹配`framework/res/xml/cordova.xml`.
+
+## 從 1.4.0 升級到 1.5.0 版
+
+1.  刪除 `phonegap-1.4.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `cordova-1.5.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `cordova-1.5.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `cordova-1.5.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+7.  替換 `res/xml/phonegap.xml` 與 `res/xml/cordova.xml` 進行匹配`framework/res/xml/cordova.xml`.
+
+## 從 1.3.0 升級到 1.4.0
+
+1.  刪除 `phonegap-1.3.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `phonegap-1.4.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `phonegap-1.4.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `phonegap-1.4.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+7.  更新 `res/xml/phonegap.xml` 以匹配`framework/res/xml/phonegap.xml`.
+
+## 從 1.2.0 升級到 1.3.0
+
+1.  刪除 `phonegap-1.2.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `phonegap-1.3.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `phonegap-1.3.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `phonegap-1.2.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+7.  更新 `res/xml/phonegap.xml` 以匹配`framework/res/xml/phonegap.xml`.
+
+## 從 1.1.0 升級到 1.2.0
+
+1.  刪除 `phonegap-1.1.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `phonegap-1.2.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `phonegap-1.2.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `phonegap-1.2.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+7.  更新 `res/xml/phonegap.xml` 以匹配`framework/res/xml/phonegap.xml`.
+
+## 從 1.0.0 升級到 1.1.0
+
+1.  刪除 `phonegap-1.0.0.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `phonegap-1.1.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `phonegap-1.1.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `phonegap-1.1.0.js` 檔。
+
+6.  更新 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.xml`.
+
+## 從 0.9.6 升級到 1.0.0
+
+1.  刪除 `phonegap-0.9.6.jar` 從專案的 `libs` 目錄。
+
+2.  添加 `phonegap-1.0.0.jar` 到專案中的 `libs` 目錄。
+
+3.  如果您使用 Eclipse,請刷新您的 Eclipse 專案,做清潔。
+
+4.  複製新 `phonegap-1.0.0.js` 到您的專案。
+
+5.  更新您的 html 代碼,使用新的 `phonegap-1.0.0.js` 檔。
+
+6.  添加 `res/xml/plugins.xml` 以匹配`framework/res/xml/plugins.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/webview.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/android/webview.md b/www/docs/zh-cn/dev/guide/platforms/android/webview.md
new file mode 100644
index 0000000..9d51f46
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/android/webview.md
@@ -0,0 +1,116 @@
+---
+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 WebViews
+---
+
+# Android WebViews
+
+本指南說明如何將嵌入在較大型的 Android 應用程式內的科爾多瓦啟用 web 視圖元件。這些元件可以如何與對方溝通的詳細資訊,請參閱應用程式外掛程式。
+
+如果你熟悉 Android,你應首先熟悉 Android 平臺指南和之前你嘗試更不尋常發展嵌入 web 視圖的選項,安裝了最新 Android sdk。 從開始科爾多瓦 1.9,Android 平臺依靠 `CordovaWebView` 元件,生成遺留下來 `CordovaActivity` 預日期 1.9 版本的元件。
+
+1.  要按照這些說明進行操作,請確保您有最新的科爾多瓦分佈。從[cordova.apache.org][1]下載和解壓縮其 android 系統的套裝軟體。
+
+2.  導航到 Android 包 `/framework` 目錄並運行 `ant jar` 。它創建了科爾多瓦 `.jar` 檔中,形成了作為`/framework/cordova-x.x.x.jar`.
+
+3.  複製 `.jar` 到 Android 專案檔案 `/libs` 目錄。
+
+4.  將以下內容添加到應用程式的 `/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" />
+        
+
+5.  修改活動,使它實現了 `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());
+            }
+        
+
+6.  如果應用程式需要使用相機,實現以下內容:
+    
+        @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);
+            }
+        }
+        
+
+7.  最後,請記住,添加執行緒池,否則外掛程式有沒有線程在其上運行:
+    
+        @Override
+        public ExecutorService getThreadPool() {
+            return threadPool;
+        }
+        
+
+8.  將應用程式的 HTML 和 JavaScript 檔案複製到 Android 專案 `/assets/www` 目錄。
+
+9.  複製 `config.xml` 檔從 `/framework/res/xml` 到專案中的 `/res/xml` 目錄。
+
+ [1]: http://cordova.apache.org
\ 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/blackberry/config.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/blackberry/config.md b/www/docs/zh-cn/dev/guide/platforms/blackberry/config.md
new file mode 100644
index 0000000..b66e781
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/blackberry/config.md
@@ -0,0 +1,28 @@
+---
+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: 黑莓手機配置
+---
+
+# 黑莓手機配置
+
+黑莓手機完全支援[W3C 構件規範][1]以及專有的 RIM 擴展。 請全面[黑莓 WebWorks 檔關於 config.xml][2]的詳細資訊,參閱。
+
+ [1]: http://www.w3.org/TR/widgets/
+ [2]: https://developer.blackberry.com/html5/documentation/working_with_config_xml_file_1866970_11.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/blackberry/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/blackberry/index.md b/www/docs/zh-cn/dev/guide/platforms/blackberry/index.md
new file mode 100644
index 0000000..5519e8b
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/blackberry/index.md
@@ -0,0 +1,164 @@
+---
+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: 黑莓平臺指南
+---
+
+# 黑莓平臺指南
+
+本指南介紹了如何設置用於目標應用程式的版本 10 之前的黑莓平臺 SDK 環境。 如果你想要的目標的最新版本,請參閱黑莓 10 平臺指南。 請參閱下列特定于平臺的詳細資訊:
+
+*   [黑莓手機配置](config.html)
+*   [升級黑莓手機](upgrading.html)
+*   [黑莓手機的外掛程式](plugin.html)
+*   [黑莓手機的命令列工具](tools.html)
+
+上面的命令列工具請參閱科爾多瓦 3.0 以前的版本。關於當前介面的資訊,請參閱命令列介面。
+
+## 要求和支援
+
+此版本的黑莓手機不支援由 `cordova` 所述的命令列介面,而是由一組單獨的命令列工具的實用程式。 從[cordova.apache.org][1]下載的科爾多瓦分佈.
+
+ [1]: http://cordova.apache.org/#download
+
+科爾多瓦的黑莓手機依賴于[黑莓 WebWorks 框架][2],這是可用於 Windows XP (32 位),Windows 7 (32 位和 64 位) 和 Mac (OS X 10.6.4+)。 WebWorks 應用程式可以*只*在以下黑莓平臺上部署:
+
+ [2]: https://bdsc.webapps.blackberry.com/html5
+
+*   黑莓 OS 5.0 和更高
+*   黑莓 PlayBook
+*   黑莓 10 (QNX)
+
+WebWorks 需要 JAVA 開發工具組 (JDK)。 對於 Windows,使用 32 位版本的[Oracle JDK][3]。 JAVA 中的預設安裝的 Mac OS X 上最新支援版本 10.7,這需要[單獨安裝][4]。 它還要求 Apache Ant 在 Mac 上是 JAVA 安裝的一部分安裝。 Windows 版本,從[ant.apache.org][5].
+
+ [3]: http://www.oracle.com/technetwork/java/javase/downloads/index.html#jdk
+ [4]: http://support.apple.com/kb/DL1421
+ [5]: http://ant.apache.org/bindownload.cgi
+
+## 安裝 SDK
+
+下載並安裝適當的 WebWorks SDK,為您的發展。可以從以下位置下載黑莓 PlayBook 和黑莓智慧手機 WebWorks Sdk。
+
+*   \[黑莓 PlayBook SDK\](HTTPs://developer.blackberry.com/html5/download/#playbook) 和[Adobe Air SDK][6]
+
+*   \[黑莓智慧手機 SDK\]() HTTPs://developer.blackberry.com/html5/download/#smartphones
+
+ [6]: http://www.adobe.com/devnet/air/air-sdk-download.html
+
+## 登記冊的簽名金鑰
+
+如果您希望發佈黑莓應用程式商店上的應用程式或在實際設備上,您會需要註冊一套免費的代碼簽名金鑰。 要這樣做,請完成[黑莓鍵訂單表單][7]。 一旦您收到你簽署的鑰匙,他們需要進行設置。 請參閱[黑莓 HTML5/WebWorks 網站][8]的資訊。
+
+ [7]: https://www.blackberry.com/SignedKeys
+ [8]: https://developer.blackberry.com/html5/documentation/signing_setup_bb10_apps_2008396_11.html
+
+## 安裝科爾多瓦
+
+下載並解壓縮[科爾多瓦][1]的最新副本.
+
+## 設立了一個新的專案
+
+*   打開一個命令列終端並導航到您解壓縮科爾多瓦。
+
+*   那裡是科爾多瓦支援每個平臺的目錄。導航到 `blackberry` 目錄。
+
+*   `blackberry`目錄中包含幾個子目錄。 `example`目錄中包含一個完整的科爾多瓦專案。 複製 `example` 目錄到您的電腦上的另一個位置和導航到那裡。
+
+*   編輯 `project.properties` 檔,以指定您使用的 WebWorks SDK。 例如,下面是黑莓 PlayBook,黑莓智慧手機 (OS5-7) 或黑莓 10 (QNX) 的各自設置:
+    
+        playbook.bbwp.dir=C:\\Program Motion\\BlackBerry WebWorks SDK 中 Files\\Research 為 TabletOS 2.1.0.6\\bbwp blackberry.bbwp.dir=C:\\Program Motion\\BlackBerry WebWorks Packager 在 Files\\Research qnx.bbwp.dir=C:\\Program 檔 (86) \\Research In Motion\\BlackBerry 10 WebWorks SDK 1.0.2.9
+        
+
+這些參數對應于參數指定在生成您的專案時。首次運行這些命令,它們生成一個"HelloWorld"應用程式:
+
+        科爾多瓦/生成 playbook 科爾多瓦/生成黑莓科爾多瓦/生成 qnx
+    
+
+和 SDK,您還需要註冊的代碼簽名金鑰和調試標記。 簽名金鑰允許您分發通過黑莓應用程式。 調試標記使您可以測試黑莓手機模擬器或設備上未簽名的應用程式。 您不需要創建和安裝調試標記自己 ;如果你提供的金鑰庫的密碼,生成腳本創建,並為您安裝調試標記。 若要設置簽名金鑰,請轉到黑莓手機網站來得到它,確保保留您指定的密碼。 然後運行 `blackberry-signer` 實用套裝程式含的 SDK。 黑莓手機提供了更多的資訊在這裡:
+
+*   [註冊您的代碼簽名金鑰][9]
+
+*   [設置您的電腦代碼簽名][10]
+
+*   [設置您的 SDK 環境的綜合指南][11]
+
+ [9]: https://www.blackberry.com/SignedKeys/codesigning.html
+ [10]: http://developer.blackberry.com/html5/documentation/set_up_for_signing.html
+ [11]: http://developer.blackberry.com/native/documentation/bb10/com.qnx.doc.native_sdk.quickstart/topic/set_up_your_environment.html
+
+## 部署到模擬程式
+
+在 Windows 上,黑莓智慧手機模擬器,才可用。 黑莓 PlayBook 模擬器需要 VMWare 播放機 (Windows) 或 VMWare 融合 (Mac OS X)。 WebWorks SDK 提供了一個預設模擬器,但額外的模擬程式都[可以通過黑莓手機][12].
+
+ [12]: http://us.blackberry.com/developers/resources/simulators.jsp
+
+從專案目錄中,鍵入 `./cordova/run <target>` ,更換 `<target>` 或 `qnx` , `playbook` ,或 `blackberry` 。 請注意對於黑莓 10 和行動手冊,必須已經啟動模擬程式虛擬映射。
+
+請參閱下列內容的詳細資訊:
+
+*   [黑莓 PlayBook][13]
+
+*   [黑莓智慧手機][14]
+
+ [13]: https://developer.blackberry.com/html5/documentation/using_the_tablet_simulator_1866980_11.html
+ [14]: https://developer.blackberry.com/html5/documentation/run_your_app_on_smartphone_sim_1876976_11.html
+
+對於黑莓 Playbook 編輯 `project.properties` 檔以自訂 `playbook.sim.ip` 和 `playbook.sim.password` 的屬性。 可通過**設置**應用程式主畫面上模擬程式的 IP 位址。 啟用**的安全和隱私 → 發展模式**選項,以顯示該位址。 此外可以在**安全和隱私**選項卡中設置密碼。
+
+對於黑莓智慧手機,編輯 `project.properties` 檔以自訂 `blackberry.sim.dir` 和 `blackberry.sim.bin` 的屬性。 您需要在 Windows 上,例如指定目錄路徑時逃脫的路徑分隔符號:`C:\\Program
+Files\\BlackBerry\\Simulator`.
+
+一旦該模擬程式已安裝並運行,運行任一以下操作以安裝到主畫面的應用程式:
+
+        科爾多瓦/運行 playbook 科爾多瓦/運行黑莓
+    
+
+如果設備連接到您的電腦是否提示您時,回答否。
+
+**注:**上黑莓 OS 5,該應用程式安裝在 `Downloads` 目錄。
+
+## 將部署到設備
+
+要將您的應用程式部署到一個設備,它必須連接,和您必須註冊為代碼簽名金鑰,如上文所述。 也、 要部署應用程式對黑莓 PlayBook**設置 → 安全 → 發展模式**必須啟用選項。
+
+在黑莓 PlayBook 上編輯 `project.properties` 檔和修改以下以反映該設備的 IP 和密碼作為配置上面,一直以來與您設置的簽名私密金鑰密碼:
+
+從專案目錄中,鍵入 `./cordova/run <target>` ,更換 `<target>` 或 `qnx` , `playbook` ,或`blackberry`.
+
+在黑莓智慧手機 (OS5-7),指定 `blackberry.sigtool.password` 屬性作為簽名的私密金鑰密碼。
+
+然後從該專案的目錄,運行你會在模擬程式中查看該應用程式的命令之一:
+
+        科爾多瓦/運行 playbook 科爾多瓦/運行黑莓
+    
+
+如果設備連接到您的電腦是否提示您時,回答是。
+
+**注:**上黑莓 OS 5,該應用程式安裝在 `Downloads` 目錄。
+
+## 附加資訊
+
+下面的文章可能説明您解決常見的問題,開發的黑莓 WebWorks 框架生成的應用程式時:
+
+*   [黑莓 WebWorks 發展陷阱][15]
+
+*   [包裝 WebWorks 應用程式的最佳做法][16]
+
+ [15]: http://supportforums.blackberry.com/t5/Web-and-WebWorks-Development/Common-BlackBerry-WebWorks-development-pitfalls-that-can-be/ta-p/624712
+ [16]: https://bdsc.webapps.blackberrycom/html5/documentation/ww_developing/bestpractice_compiling_ww_apps_1873324_11.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/blackberry/plugin.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/blackberry/plugin.md b/www/docs/zh-cn/dev/guide/platforms/blackberry/plugin.md
new file mode 100644
index 0000000..75f813c
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/blackberry/plugin.md
@@ -0,0 +1,108 @@
+---
+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: 黑莓手機的外掛程式
+---
+
+# 黑莓手機的外掛程式
+
+本指南介紹了如何開發回聲外掛程式在黑莓手機上。 外掛程式開發指南提供廣泛概述,你應該已經是熟悉的和本指南撿起它的留下。 此外,下載[科爾多瓦黑莓手機存儲庫][1].
+
+ [1]: https://git-wip-us.apache.org/repos/asf?p=cordova-blackberry-webworks.git;a=summary
+
+`Cordova-BlackBerry`專案允許您將部署到黑莓火炬、 加粗和操作手冊等。 Playbook 使用不同的代碼基比其他黑莓手持設備,您需要為其重複你的發展努力。 本指南著重于手持設備,而不是平板電腦。 (在將來,本指南應包括這兩個平臺)。
+
+Echo 外掛程式基本上是返回使用者不管消息提供給 `window.echo` 函數:
+
+    window.echo = function(str, callback) {
+        cordova.exec(callback, function(err) {
+            callback('Nothing to echo.');
+        }, "Echo", "echo", [str]);
+    };
+    
+
+## 修改 plugins.xml
+
+您的專案的 `www/plugins.xml` 目錄中包含的所有必要引用到科爾多瓦專案的外掛程式。 添加一個額外的引用,這樣,當 `cordova.exec` 是科爾多瓦叫,知道如何映射 `Echo` 參數的 `cordova.exec` 到 `Echo` 我們想要寫本機的類:
+
+    <feature name="Echo">
+        <param name="blackberry-package" value="org.apache.cordova.echo.Echo" />
+    </feature>
+    
+
+## 添加 Echo.java
+
+如果您注意到結構的值屬性,您將看到已定義的路徑,導致回聲外掛程式。 在科爾多瓦黑莓 WebWorks 回購的根目錄中,查找名為的目錄 `framework` 。 此目錄包含所有的原始程式碼在黑莓手機上本機運行。 導航到 `framework/ext/src/org/apache/cordova` 。 此時,您將看到所有的外掛程式目錄,所是的原始程式碼。 因此,添加目錄回顯到 `framework/ext/src/org/apache/cordova/echo` ,並創建一個檔稱為 `Echo.java` 在`framework/ext/src/org/apache/cordova/echo/Echo.java`.
+
+## 書寫 Echo.java
+
+在編寫外掛程式背後的基本思想是,創建一個擴展外掛程式類的類調用的方法 `execute` 返回 `PluginResult` 類。 任何調用 `cordova.exec` 將傳遞給要在類中,以及參數內執行的操作中。 在這種情況下,"回聲"是我們想要執行的類中"回聲"和 [乙方] 的行動是我們在中傳遞的參數。
+
+    package org.apache.cordova.echo;
+    
+    import org.apache.cordova.api.Plugin;
+    import org.apache.cordova.api.PluginResult;
+    import org.apache.cordova.json4j.JSONArray;
+    import org.apache.cordova.json4j.JSONException;
+    import org.apache.cordova.json4j.JSONObject;
+    /**
+     * A simple plugin to demonstrate how to build a plugin for BlackBerry
+     * Basically echos back the msg that a user calls to this plugin
+     */
+    public final class Echo extends Plugin {
+    
+        public static final String echo = "echo";
+    
+        public PluginResult execute(String action, JSONArray args, String callbackId) {
+            PluginResult result = new PluginResult(PluginResult.Status.INVALID_ACTION, "Echo: Invalid action:" + action);
+            if(action.equals(echo)){
+                try {
+                    String theMsg = args.getString(0);
+                    if(theMsg!= null || theMsg.length()>0){
+                        result = new PluginResult(PluginResult.Status.OK, theMsg);
+                    }else{
+                        result = new PluginResult(PluginResult.Status.ERROR, "Nothing to echo.");
+                    }
+                } catch (JSONException e) {
+                    result = new PluginResult(PluginResult.Status.JSON_EXCEPTION, e.getMessage());
+                }
+            }
+    
+            return result;
+        }
+    
+    }
+    
+
+所以如果我們看看上面的代碼,我們可以看到在 execute 方法中,我們第一次尋找行動來。 Echo 外掛程式,只有一種操作, `echo` ,因此,我們將只檢查的。 如果我們的外掛程式有更多的行動,它是簡單的添加更多條件的測試,以檢查這些操作。
+
+然後我們拿進來從參數 args 參數由提供的消息。 我們可以抓住的只在做第一個參數`String theMsg = args.getString(0);`.
+
+我們將做一些錯誤檢查和郵件看起來很好,如果我們將具現化新的 PluginResult 與好的狀態: `PluginResult.Status.OK` ,並返回該郵件: `theMsg` 。 在此之後,我們返回的結果,要傳遞回給 JavaScript 可以在回檔中成功發射。 如果事情失敗,我們可以返回各種狀態異常,像 `PluginResult.Status.ERROR` , `PluginResult.Status.JSON_EXCEPTION` ,或 `PluginResult.Status.INVALID_ACTION` 。 當傳遞回來時,這些類型的結果火中 JavaScript 的失敗回檔。
+
+## 更新您的專案 www 目錄中.jar
+
+添加的 `Echo.java` 需要更新您的專案中。 若要生成 `.jar` 檔,定位到黑莓 WebWorks 回購根目錄下並運行 `ant` 命令:
+
+    ant update -Dproject.path="~/path_to_my_project"
+    
+
+這將生成新的 `.jar` 檔在 `build/ext` 目錄。複製 `build/ext/cordova.jar` 檔到您 `project/www/ext` 目錄。
+
+如果一切順利,允許您在黑莓手機中使用 Echo 外掛程式。
\ 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/blackberry/tools.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/dev/guide/platforms/blackberry/tools.md b/www/docs/zh-cn/dev/guide/platforms/blackberry/tools.md
new file mode 100644
index 0000000..7ed7127
--- /dev/null
+++ b/www/docs/zh-cn/dev/guide/platforms/blackberry/tools.md
@@ -0,0 +1,66 @@
+---
+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: 黑莓手機的命令列工具
+---
+
+# 黑莓手機的命令列工具
+
+`cordova`命令列實用程式是一個高級別的工具,允許您在一次跨幾個平臺生成的應用程式。 舊版本的科爾多瓦框架提供了特定于每個平臺的命令列工具集。 若要使用它們作為 CLI 的替代,您需要從[cordova.apache.org][1]下載此版本的科爾多瓦。 下載檔案中包含單獨的檔案,為每個平臺。 展開您想要的目標平臺。 這裡描述的工具,通常可用在頂級 `bin` 目錄中,否則為諮詢**自述**檔,瞭解有關更多詳細的指示。
+
+ [1]: http://cordova.apache.org
+
+## 創建一個專案
+
+運行 `create` 命令,指定的現有路徑的專案、 反向域式包識別碼和應用程式的顯示名稱。這裡是 Mac 和 Windows 的語法:
+
+    $ /path/to/cordova-blackberry-webworks/bin/create /path/to/my_new_project com.example.project_name ProjectName
+    $ /path/to/cordova-blackberry-webworks/bin/create.bat /path/to/my_new_project com.example.project_name ProjectName
+    
+
+**注:**黑莓平臺忽略套裝軟體名稱的預留位置 ( `com.example.project_name` ),但它已仍需使用的跨平臺的工具。
+
+## 生成專案
+
+對於黑莓手機的專案,請確保您自訂 `project.properties` 在科爾多瓦專案的根目錄中的檔。 你需要提供你的黑莓手機簽名金鑰的密碼,這樣做並指定黑莓 WebWorks SDK 和黑莓模擬程式的可執行檔的位置。
+
+    $ /path/to/my_new_project/cordova/build <platform>
+    $ /path/to/my_new_project/cordova/build.bat <platform>
+    
+
+## 啟動模擬程式
+
+對於黑莓手機的專案,請確保您自訂 `project.properties` 科爾多瓦專案目錄的根目錄中的檔。 你需要提供你的黑莓手機簽名金鑰的密碼,這樣做並指定黑莓 WebWorks SDK 和黑莓模擬程式的可執行檔的位置。
+
+    $ /path/to/my_new_project/cordova/run <platform>
+    
+
+然後選擇 '否' 時提示您:
+
+    你有一個黑莓設備連接到您的電腦嗎?(y/n) $ /path/to/my_new_project/cordova/run < 平臺 >
+    
+
+然後選擇 '否' 時提示您:
+
+    你有一個黑莓設備連接到您的電腦嗎?(y /) n
+    
+
+## 日誌記錄
+
+不幸的是,流直接從設備日誌是目前不支援的。 然而,黑莓手機提供了內置 Web 檢查器支援 Playbook 和黑莓智慧手機設備運行黑莓 OS 7.0 及以上。 您還可以訪問您的應用程式日誌 (包括對任何調用 `console.log` ) 在您的設備,在按住 ALT 鍵從主畫面和鍵入 lglg 鍵上。
\ No newline at end of file


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


Mime
View raw message