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:57 UTC
[41/51] [partial] docs commit: Adding both Chinese versions.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/guide/platforms/android/webview.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/android/webview.md b/www/docs/zh-cn/3.1.0/guide/platforms/android/webview.md
new file mode 100644
index 0000000..adc3403
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/guide/platforms/android/webview.md
@@ -0,0 +1,120 @@
+---
+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
+
+協助下開始在科爾多瓦 1.9， `CordovaActivity` ，你可以使用科爾多瓦作為一個更大的本機 Android 應用程式中的一個元件。 Android 是指這種元件 `CordovaWebView` 。 新的基於科爾多瓦的應用程式從 1.9 起使用 `CordovaWebView` 作為其主要的視圖，無論是否遺留下來 `CordovaActivity` 使用方法。
+
+如果你熟悉 Android 應用程式的開發，請閱讀 [Android 平臺指南](index.html) 》 嘗試前，包括 web 視圖開發科爾多瓦的應用程式。 它不是作者科爾多瓦 Android 應用程式的主要途徑。 這些指令是目前手動，但最終可能會實現自動化。
+
+## 系統必備元件
+
+* 科爾多瓦 1.9 或更大
+
+* Android SDK 更新到最新的 SDK
+
+## 在 android 系統的專案中使用 CordovaWebView 的指南
+
+1. `cd`到 `/framework` 並運行 `ant jar` 打造科爾多瓦 jar。 它創建時所形成的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `cordova-x.x.x.jar` 在 `/framework` 目錄。
+
+2. 科爾多瓦 jar 複製到您的 Android 專案 `/libs` 目錄。
+
+3. 編輯您的應用程式的 `main.xml` [檔](../../../cordova/file/fileobj/fileobj.html) (根據 `/res/xml` )，看起來像下面這樣，與 `layout_height` ， `layout_width` 和 `id` 修改，以適合您的應用程式：
+
+ <org.apache.cordova.CordovaWebView
+ android:id="@+id/tutorialView"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent" />
+
+
+4. 修改您的活動，使它實現了 `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());
+ }
+
+
+如果您使用的相機，你應該也可以實現這：
+
+ @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 檔案複製到您的 Android 專案 `/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/3.1.0/guide/platforms/blackberry/config.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/blackberry/config.md b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry/config.md
new file mode 100644
index 0000000..b66e781
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/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/3.1.0/guide/platforms/blackberry/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/blackberry/index.md b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry/index.md
new file mode 100644
index 0000000..9455658
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/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 平臺指南。 請參閱下列特定于平臺的詳細資訊：
+
+* [黑莓手機配置](../blackberry10/config.html)
+* [升級黑莓手機](../blackberry10/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/3.1.0/guide/platforms/blackberry/plugin.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/blackberry/plugin.md b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry/plugin.md
new file mode 100644
index 0000000..75f813c
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/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/3.1.0/guide/platforms/blackberry/tools.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/blackberry/tools.md b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry/tools.md
new file mode 100644
index 0000000..7ed7127
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/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
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/guide/platforms/blackberry/upgrading.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/blackberry/upgrading.md b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry/upgrading.md
new file mode 100644
index 0000000..292efc5
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry/upgrading.md
@@ -0,0 +1,421 @@
+---
+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 實用程式。 命令列介面資訊，請參閱如何更新的 CLI 版本。
+
+## 升級 2.8.0 專案到 2.9.0
+
+黑莓 10：
+
+1. 下載並解壓縮到您的硬碟磁碟機上永久位置的科爾多瓦 2.9.0 源，例如到`~/Cordova-2.9.0`.
+
+2. 退出任何正在運行的 SDK 工具： 日食、 Momentics 和類似。
+
+3. 導航到您放在上面，使用的 unix 像終端的下載的源的目錄： 終端程式，Bash，這個軟體，等等。
+
+4. 創建一個新專案，黑莓手機的命令列工具中所述。這將成為您更新的專案的家中。
+
+5. 從舊專案複製您的專案源 `/www` 目錄到新的專案的 `/www` 目錄。
+
+6. 更新中的科爾多瓦腳本引用您 `www/index.html` [檔](../../../cordova/file/fileobj/fileobj.html) （以及包含該腳本引用的任何其他檔） 以指向新 `cordova.js` 檔。
+
+### BlackBerryOS/操作手冊
+
+1. 下載並解壓縮到您的硬碟磁碟機上永久位置的科爾多瓦 2.9.0 源，例如到`~/Cordova-2.9.0`.
+
+2. 退出任何正在運行的 SDK 工具： 日食、 Momentics 和類似。
+
+3. 導航到您放在上面，使用的 unix 像終端的下載的源的目錄： 終端程式，Bash，這個軟體，等等。
+
+4. 創建一個新專案，如 iOS 命令列工具中所述。您需要從這個新的專案資產。
+
+5. 複製 `www/cordova.js` 到新專案中的檔您 `www` 目錄中，並刪除您 `www/cordova.js` 檔。
+
+6. 更新中的科爾多瓦腳本引用您 `www/index.html` [檔](../../../cordova/file/fileobj/fileobj.html) （以及包含該腳本引用的任何其他檔） 以指向新 `cordova.js` 檔。
+
+7. 複製 `native` 到現有專案中，並覆蓋舊從新專案目錄 `native` 目錄。
+
+8. 複製 `lib` 到現有專案中，並覆蓋舊從新專案目錄 `lib` 目錄。
+
+9. 複製 `cordova` 到現有專案中，並覆蓋舊從新專案目錄 `cordova` 目錄。
+
+## 升級 2.7.0 專案到 2.8.0
+
+黑莓 10：
+
+黑莓 10 使用新的 CLI 模具和管理核心作為外掛程式的 Api。 說明將您的專案遷移到新的專案，而不是更新現有的專案，由於更新一個舊的專案的複雜性。 此外注意到科爾多瓦 js 指令檔現在被稱為 'cordova.js' 和不再包含版本的字串。
+
+1. 下載並解壓縮到您的硬碟磁碟機上永久位置的科爾多瓦 2.8.0 源，例如到`~/Cordova-2.8.0`.
+
+2. 退出任何正在運行的 SDK 工具： 日食、 Momentics 和類似。
+
+3. 導航到您放在上面，使用的 unix 像終端的下載的源的目錄： 終端程式，Bash，這個軟體，等等。
+
+4. 創建一個新專案，黑莓手機的命令列工具中所述。這將成為您更新的專案的家中。
+
+5. 從舊專案複製您的專案源 `/www` 目錄到新的專案的 `/www` 目錄。
+
+6. 更新中的科爾多瓦腳本引用您 `www/index.html` [檔](../../../cordova/file/fileobj/fileobj.html) （以及包含該腳本引用的任何其他檔） 以指向新 `cordova.js` 檔。
+
+BlackBerryOS/行動手冊：
+
+1. 下載並解壓縮到您的硬碟磁碟機上永久位置的科爾多瓦 2.8.0 源，例如到`~/Cordova-2.8.0`.
+
+2. 退出任何正在運行的 SDK 工具： 日食、 Momentics 和類似。
+
+3. 導航到您放在上面，使用的 unix 像終端的下載的源的目錄： 終端程式，Bash，這個軟體，等等。
+
+4. 創建一個新專案，如 iOS 命令列工具中所述。您需要從這個新的專案資產。
+
+5. 複製 `www/cordova.js` 到新專案中的檔您 `www` 目錄中，並刪除您 `www/cordova.js` 檔。
+
+6. 更新中的科爾多瓦腳本引用您 `www/index.html` [檔](../../../cordova/file/fileobj/fileobj.html) （以及包含該腳本引用的任何其他檔） 以指向新 `cordova.js` 檔。
+
+7. 複製 `native` 到現有專案中，並覆蓋舊從新專案目錄 `native` 目錄。
+
+8. 複製 `lib` 到現有專案中，並覆蓋舊從新專案目錄 `lib` 目錄。
+
+9. 複製 `cordova` 到現有專案中，並覆蓋舊從新專案目錄 `cordova` 目錄。
+
+## 升級 2.6.0 專案到 2.7.0
+
+1. 下載並解壓縮到您的硬碟磁碟機上永久位置的科爾多瓦 2.7.0 源，例如到`~/Cordova-2.7.0`.
+
+2. 退出任何正在運行的 SDK 工具： 日食、 Momentics 和類似。
+
+3. 導航到您放在上面，使用的 unix 像終端的下載的源的目錄： 終端程式，Bash，這個軟體，等等。
+
+4. 創建一個新專案，黑莓手機的命令列工具中所述。您需要從這個新的專案資產。
+
+5. 複製 `www/cordova-2.7.0.js` 到新專案中的檔您 `www` 目錄中，並刪除您 `www/cordova-2.6.0.js` 檔。
+
+6. 更新中的科爾多瓦腳本引用您 `www/index.html` [檔](../../../cordova/file/fileobj/fileobj.html) （以及包含該腳本引用的任何其他檔） 以指向新 `cordova-2.7.0.js` 檔。
+
+7. 複製 `native` 到現有專案中，並覆蓋舊從新專案目錄 `native` 目錄。
+
+8. 複製 `lib` 到現有專案中，並覆蓋舊從新專案目錄 `lib` 目錄。
+
+9. 複製 `cordova` 到現有專案中，並覆蓋舊從新專案目錄 `cordova` 目錄。
+
+## 從 2.5.0 升級到 2.6.0
+
+更新 PhoneGap 下載目錄：
+
+建議你下載整個目錄的新副本。
+
+但是，在這裡是零敲碎打更新所需的新零件：
+
+1. 更新中的 cordova.blackberry.js [檔](../../../cordova/file/fileobj/fileobj.html) `Phonegap-2.6.0/lib/blackberry/javascript` 目錄。
+
+2. 更新 `ext` ， `ext-air` ，和 `ext-qnx` 在 `Phonegap-2.6.0/lib/blackberry/framework` 目錄。
+
+3. 更新 `build.xml` 檔在 `Phonegap-2.6.0/lib/blackberry` 目錄。
+
+4. 更新 `Phonegap-2.6.0/lib/blackberry/bin` 目錄。
+
+5. 更新 `VERSION` 檔在 `Phonegap-2.6.0/lib/blackberry` 目錄。
+
+更新 `example/` 目錄或遷移現有的專案：
+
+1. 打開您 `www/` 目錄，其中包含您的應用程式。
+
+2. 刪除和更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `ext/` 目錄。
+
+3. 更新的內容 `ext-air/` 目錄。
+
+4. 更新的內容 `ext-qnx/` 目錄。
+
+5. 複製新 `cordova-2.6.0.js` 到您的專案。
+
+6. 更新您的 html 代碼，使用新的 `cordova-2.6.0.js` 檔。
+
+## 從 2.4.0 升級到 2.5.0
+
+更新 PhoneGap 下載目錄：
+
+建議你下載整個目錄的新副本。
+
+但是，在這裡是零敲碎打更新所需的新零件：
+
+1. 更新中的 cordova.blackberry.js [檔](../../../cordova/file/fileobj/fileobj.html) `Phonegap-2.5.0/lib/blackberry/javascript` 目錄。
+
+2. 更新 `ext` ， `ext-air` ，和 `ext-qnx` 在 `Phonegap-2.5.0/lib/blackberry/framework` 目錄。
+
+3. 更新 `build.xml` 檔在 `Phonegap-2.5.0/lib/blackberry` 目錄。
+
+4. 更新 `Phonegap-2.5.0/lib/blackberry/bin` 目錄。
+
+5. 更新 `VERSION` 檔在 `Phonegap-2.5.0/lib/blackberry` 目錄。
+
+更新示例 / 目錄或遷移現有的專案：
+
+1. 打開您 `www/` 目錄，其中包含您的應用程式。
+
+2. 刪除和更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `ext/` 目錄。
+
+3. 更新的內容 `ext-air/` 目錄。
+
+4. 更新的內容 `ext-qnx/` 目錄。
+
+5. 複製新 `cordova-2.5.0.js` 到您的專案。
+
+6. 更新您的 html 代碼，使用新的 `cordova-2.5.0.js` 檔。
+
+## 從 2.3.0 升級到 2.4.0
+
+更新只是 `www` 目錄：
+
+1. 打開您 `www/` 目錄，其中包含您的應用程式。
+
+2. 刪除和更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `ext/` 目錄。
+
+3. 更新的內容 `ext-air/` 目錄。
+
+4. 複製新 `cordova-2.4.0.js` 到您的專案。
+
+ * 如果行動手冊，然後更新.js 檔在 `playbook/` 目錄。
+ * 如果黑莓 10，然後更新中的.js 檔 `qnx/` 目錄。
+
+5. 更新您的 html 代碼，使用新的 `cordova-2.4.0.js` 檔。
+
+更新 （ie，更新使用 ant 工具） 的示例目錄：
+
+1. 打開 `sample/lib/` 目錄。
+
+2. 更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `cordova.2.3.0/ext/` 目錄。
+
+3. 更新的內容 `cordova.2.3.0/ext-air/` 目錄。
+
+4. 更新的內容 `cordova.2.3.0/ext-qnx/` 目錄。
+
+5. 更新中的.js [檔](../../../cordova/file/fileobj/fileobj.html) `cordova.2.3.0/javascript/` 目錄。
+
+6. 打開 `sample/lib/` 目錄和重命名 `cordova.2.3.0/` 到目錄`cordova.2.4.0/`.
+
+7. 類型 `ant blackberry build` 或 `ant playbook build` 來更新 `www/` 目錄與更新科爾多瓦。
+
+8. 打開 `www/` 目錄和更新您的 html 代碼，使用新的 `cordova-2.4.0.js` 檔。
+
+## 從 2.2.0 升級到 2.3.0
+
+更新只是 `www` 目錄：
+
+1. 打開您 `www/` 目錄，其中包含您的應用程式。
+
+2. 刪除和更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `ext/` 目錄。
+
+3. 更新的內容 `ext-air/` 目錄。
+
+4. 複製新 `cordova-2.3.0.js` 到您的專案。
+
+ * 如果行動手冊，然後更新.js 檔在 `playbook/` 目錄。
+ * 如果黑莓 10，然後更新中的.js 檔 `qnx/` 目錄。
+
+5. 更新您的 html 代碼，使用新的 `cordova-2.3.0.js` 檔。
+
+更新 （ie，更新使用 ant 工具） 的示例目錄：
+
+1. 打開 `sample/lib/` 目錄。
+
+2. 更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `cordova.2.2.0/ext/` 目錄。
+
+3. 更新的內容 `cordova.2.2.0/ext-air/` 目錄。
+
+4. 更新的內容 `cordova.2.2.0/ext-qnx/` 目錄。
+
+5. 更新中的.js [檔](../../../cordova/file/fileobj/fileobj.html) `cordova.2.2.0/javascript/` 目錄。
+
+6. 打開 `sample/lib/` 目錄和重命名 `cordova.2.2.0/` 到目錄`cordova.2.3.0/`.
+
+7. 類型 `ant blackberry build` 或 `ant playbook build` 來更新 `www/` 目錄與更新科爾多瓦。
+
+8. 打開 `www/` 目錄和更新您的 html 代碼，使用新的 `cordova-2.3.0.js` 檔。
+
+## 從 2.1.0 升級到 2.2.0
+
+更新只是 www 目錄：
+
+1. 打開您 `www/` 目錄，其中包含您的應用程式。
+
+2. 刪除和更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `ext/` 目錄。
+
+3. 更新的內容 `ext-air/` 目錄。
+
+4. 複製新 `cordova-2.2.0.js` 到您的專案。
+
+ * 如果行動手冊，然後更新.js 檔在 `playbook/` 目錄。
+ * 如果黑莓 10，然後更新中的.js 檔 `qnx/` 目錄。
+
+5. 更新您的 html 代碼，使用新的 `cordova-2.2.0.js` 檔。
+
+更新 （ie，更新使用 ant 工具） 的示例目錄：
+
+1. 打開 `sample/lib/` 目錄。
+
+2. 更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `cordova.2.1.0/ext/` 目錄。
+
+3. 更新的內容 `cordova.2.1.0/ext-air/` 目錄。
+
+4. 更新的內容 `cordova.2.1.0/ext-qnx/` 目錄。
+
+5. 更新中的.js [檔](../../../cordova/file/fileobj/fileobj.html) `cordova.2.1.0/javascript/` 目錄。
+
+6. 打開 `sample/lib/` 目錄和重命名 `cordova.2.1.0/` 到目錄`cordova.2.2.0/`.
+
+7. 類型 `ant blackberry build` 或 `ant playbook build` 來更新 `www/` 目錄與更新科爾多瓦。
+
+8. 打開 `www/` 目錄和更新您的 html 代碼，使用新的 `cordova-2.2.0.js` 檔。
+
+## 從 2.0.0 升級到 2.1.0
+
+更新只是 `www` 目錄：
+
+1. 打開您 `www/` 目錄，其中包含您的應用程式。
+
+2. 刪除和更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `ext/` 目錄。
+
+3. 更新的內容 `ext-air/` 目錄。
+
+4. 複製新 `cordova-2.1.0.js` 到您的專案。
+
+ * 如果行動手冊，然後更新.js 檔在 `playbook/` 目錄。
+
+5. 更新您的 html 代碼，使用新的 `cordova-2.1.0.js` 檔。
+
+更新 （ie，更新使用 ant 工具） 的示例目錄：
+
+1. 打開 `sample/lib/` 目錄。
+
+2. 更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `cordova.2.0.0/ext/` 目錄。
+
+3. 更新的內容 `cordova.2.0.0/ext-air/` 目錄。
+
+4. 更新中的.js [檔](../../../cordova/file/fileobj/fileobj.html) `cordova.2.0.0/javascript/` 目錄。
+
+5. 打開 `sample/lib/` 目錄和重命名 `cordova.2.0.0/` 到目錄`cordova.2.1.0/`.
+
+6. 類型 `ant blackberry build` 或 `ant playbook build` 來更新 `www/` 目錄與更新科爾多瓦。
+
+7. 打開 `www/` 目錄和更新您的 html 代碼，使用新的 `cordova-2.1.0.js` 檔。
+
+## 從 1.9.0 升級到 2.0.0
+
+更新只是 `www` 目錄：
+
+1. 打開您 `www/` 目錄，其中包含您的應用程式。
+
+2. 刪除和更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `ext/` 目錄。
+
+3. 更新的內容 `ext-air/` 目錄。
+
+4. 複製新 `cordova-2.0.0.js` 到您的專案。
+
+ * 如果行動手冊，然後更新.js 檔在 `playbook/` 目錄。
+
+5. 更新您的 html 代碼，使用新的 `cordova-2.0.0.js` 檔。
+
+6. 更新您 `www/plugins.xml` 檔。兩個外掛程式更改其命名空間/服務標籤。更改為的捕獲和連絡人的外掛程式，從舊的條目：
+
+ < 外掛程式名稱 ="捕獲"value="org.apache.cordova.media.MediaCapture"/ >< 外掛程式名稱 ="連絡人"value="org.apache.cordova.pim.Contact"/ >
+
+ 自：
+
+ < 外掛程式名稱 ="捕獲"value="org.apache.cordova.capture.MediaCapture"/ >< 外掛程式名稱 ="連絡人"value="org.apache.cordova.pim.Contact"/ >
+
+
+更新 （ie，更新使用 ant 工具） 的示例目錄：
+
+1. 打開 `sample/lib/` 目錄。
+
+2. 更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `cordova.1.9.0/ext/` 目錄。
+
+3. 更新的內容 `cordova.1.9.0/ext-air/` 目錄。
+
+4. 更新中的.js [檔](../../../cordova/file/fileobj/fileobj.html) `cordova.1.9.0/javascript/` 目錄。
+
+5. 打開 `sample/lib/` 目錄和重命名 `cordova.1.9.0/` 到目錄`cordova.2.0.0/`.
+
+6. 類型 `ant blackberry build` 或 `ant playbook build` 來更新 `www/` 目錄與更新科爾多瓦。
+
+7. 打開 `www/` 目錄和更新您的 html 代碼，使用新的 `cordova-2.0.0.js` 檔。
+
+8. 打開 `www/` 目錄和更新 `plugins.xml` 檔。兩個外掛程式更改其命名空間/服務標籤。更改為的捕獲和連絡人的外掛程式，從舊的條目：
+
+ < 外掛程式名稱 ="捕獲"value="org.apache.cordova.media.MediaCapture"/ >< 外掛程式名稱 ="連絡人"value="org.apache.cordova.pim.Contact"/ >
+
+ 自：
+
+ < 外掛程式名稱 ="捕獲"value="org.apache.cordova.capture.MediaCapture"/ >< 外掛程式名稱 ="連絡人"value="org.apache.cordova.pim.Contact"/ >
+
+
+* 要升級到 1.8.0，請轉從 1.7.0
+
+## 從 1.7.0 升級到 1.8.0
+
+更新只是 `www` 目錄：
+
+1. 打開您 `www/` 目錄，其中包含您的應用程式。
+
+2. 刪除和更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `ext/` 目錄。
+
+3. 更新的內容 `ext-air/` 目錄。
+
+4. 複製新 `cordova-1.8.0.js` 到您的專案。
+
+ * 如果行動手冊，然後更新.js 檔在 `playbook/` 目錄。
+
+5. 更新您的 html 代碼，使用新的 `cordova-1.8.0.js` 檔。
+
+6. 更新您 `www/plugins.xml` 檔。兩個外掛程式更改其命名空間/服務標籤。更改為的捕獲和連絡人的外掛程式，從舊的條目：
+
+ < 外掛程式名稱 ="捕獲"value="org.apache.cordova.media.MediaCapture"/ >< 外掛程式名稱 ="連絡人"value="org.apache.cordova.pim.Contact"/ >
+
+ 自：
+
+ < 外掛程式名稱 ="捕獲"value="org.apache.cordova.capture.MediaCapture"/ >< 外掛程式名稱 ="連絡人"value="org.apache.cordova.pim.Contact"/ >
+
+
+更新 （ie，更新使用 ant 工具） 的示例目錄：
+
+1. 打開 `sample/lib/` 目錄。
+
+2. 更新中的.jar [檔](../../../cordova/file/fileobj/fileobj.html) `cordova.1.7.0/ext/` 目錄。
+
+3. 更新的內容 `cordova.1.7.0/ext-air/` 目錄。
+
+4. 更新中的.js [檔](../../../cordova/file/fileobj/fileobj.html) `cordova.1.7.0/javascript/` 目錄。
+
+5. 打開 `sample/lib/` 目錄和重命名 `cordova.1.7.0/` 到目錄`cordova.1.8.0/`.
+
+6. 類型 `ant blackberry build` 或 `ant playbook build` 來更新 `www/` 目錄與更新科爾多瓦。
+
+7. 打開 `www/` 目錄和更新您的 html 代碼，使用新的 `cordova-1.8.0.js` 檔。
+
+8. 打開 `www/` 目錄和更新 `plugins.xml` 檔。兩個外掛程式更改其命名空間/服務標籤。更改為的捕獲和連絡人的外掛程式，從舊的條目：
+
+ < 外掛程式名稱 ="捕獲"value="org.apache.cordova.media.MediaCapture"/ >< 外掛程式名稱 ="連絡人"value="org.apache.cordova.pim.Contact"/ >
+
+ 自：
+
+ < 外掛程式名稱 ="捕獲"value="org.apache.cordova.capture.MediaCapture"/ >< 外掛程式名稱 ="連絡人"value="org.apache.cordova.pim.Contact"/ >
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/config.md b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/config.md
new file mode 100644
index 0000000..5d37a28
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/config.md
@@ -0,0 +1,39 @@
+---
+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: 黑莓手機配置
+---
+
+# 黑莓手機配置
+
+`config.xml`檔控制應用於每個應用程式和 CordovaWebView 實例的應用程式的基本設置。 僅適用于黑莓 10 此節的詳細資訊偏好生成。 有關全域配置選項，請參閱 config.xml 檔的資訊。
+
+* `ChildBrowser`( `disable` 或預設的 `enable` ）： 禁用兒童瀏覽器視窗。 預設情況下，應用程式啟動一個輔助瀏覽器視窗以顯示資源通過訪問 `[window.open](../../../cordova/inappbrowser/window.open.html)()` 或通過指定 `_blank` 錨點目標。 指定 `disable` 重寫此預設行為。
+
+ <preference name="ChildBrowser" value="disable"/>
+
+
+* `PopupBlocker`( `enable` 或預設的 `disable` ）： 啟用快顯視窗阻止程式，這樣可以防止對調用 `[window.open](../../../cordova/inappbrowser/window.open.html)()` 。 預設情況下，快顯視窗在兒童瀏覽器視窗中顯示。 將首選項設置為 `enable` 防止它顯示在所有。
+
+ <preference name="PopupBlocker" value="enable"/>
+
+
+* `WebSecurity`( `disable` 或預設的 `enable` ）： 設置為 `disable` 重寫 web 安全設置，允許訪問遠端內容從未知的來源。 此首選項的目的是作為發展方便只，所以之前將它刪除包裝分發您的應用程式。 發佈應用程式，所有 Uri 都應已知和白名單使用 `<access>` 元素，域白名單指南中所述。
+
+ <preference name="WebSecurity" value="disable"/>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/index.md b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/index.md
new file mode 100644
index 0000000..4d31896
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/index.md
@@ -0,0 +1,180 @@
+---
+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 黑莓平臺指南
+---
+
+# 10 黑莓平臺指南
+
+本指南介紹如何設置您的開發環境，以生成和部署科爾多瓦的黑莓 10 設備的應用程式。 對於以前版本的黑莓手機，你需要使用一組不同的命令列工具，黑莓平臺指南中所述。
+
+## 要求
+
+在 Windows、 Mac 和 Linux 上提供的開發環境。
+
+開發人員應使用 `cordova` 實用程式與黑莓手機本機 SDK 一起。 命令列介面資訊，請參閱如何安裝 `cordova` ，添加專案，然後生成和部署每個平臺。
+
+## 安裝黑莓手機本機 SDK
+
+黑莓手機本機 SDK 是可用的[developer.blackberry.com][1]。 安裝完成後，您需要將其命令列工具添加到您的系統路徑。
+
+ [1]: http://developer.blackberry.com/native/download/
+
+關於視窗：
+
+* 轉到**我的電腦 → 屬性 → 高級 → 環境變數**.
+
+* 追加本機 SDK 安裝目錄的路徑，例如：
+
+ ;C:\bbndk\host\_10\_1\_0\_132\darwin\x86\usr\bin\
+
+關於 Mac 和 Linux：
+
+* 編輯 `~/.bash_profile` 檔，添加如下所示，根據安裝本機的 SDK 了一行：
+
+ $ 匯出路徑 = ${路徑}：/應用程式/bbndk/host\_10\_1\_0\_132 達爾文/x 86 usr/bin /
+
+ 或為 10.2 本機 SDK：
+
+ $ 出口 PATH=${PATH}:/Applications/Momentics.app/host\_10\_2\_0\_15/darwin/x86/usr/bin/
+
+* 運行下面的命令將在當前會話中的更改應用：
+
+ 元源 ~/.bash_profile
+
+## 為簽章設定
+
+如果您希望在設備上測試或發佈通過黑莓應用程式，您的系統必須設置為代碼簽名。
+
+若要獲取簽名金鑰，轉到黑莓手機網站和請確保保留您指定的密碼。 然後運行 `blackberry-signer` 黑莓手機本機 SDK 中包含的實用程式。
+
+可以在這裡找到詳細的說明：
+
+* [註冊您的代碼簽名金鑰。][2]
+
+* [設置您的系統的代碼簽名。][3]
+
+ [2]: https://www.blackberry.com/SignedKeys/codesigning.html
+ [3]: https://developer.blackberry.com/html5/documentation/signing_setup_bb10_apps_2008396_11.html
+
+## 創建一個專案
+
+使用 `cordova` 實用程式設置了一個新的專案，如所述的命令列介面。例如，在原始程式碼中的目錄：
+
+ $ 科爾多瓦創建你好 com.example.hello $ cd 你好 $ 科爾多瓦平臺添加 blackberry10 $ 科爾多瓦生成
+
+
+## 部署到模擬程式
+
+如果您想要運行的設備模擬程式，下載並安裝黑莓手機 10 模擬器。
+
+* [下載][1]
+* [入門][4]
+
+ [4]: http://developer.blackberry.com/devzone/develop/simulator/blackberry_10_simulator_start.html
+
+在測試之前在模擬器或設備上的應用程式，您需要將*目標*添加到您的專案。 每個是以唯一的名稱，確定並與 IP 位址關聯。 您需要在您使用它來查看應用程式之前從模擬程式獲取的 IP 位址。
+
+啟動模擬程式映射，然後從主畫面中選擇**設置**：
+
+![][5]
+
+ [5]: {{ site.baseurl }}/static/img/guide/platforms/blackberry10/bb_home.png
+
+導航到**的安全和隱私 → 發展模式**節、 啟用選項，和獲得的 IP 位址：
+
+![][6]
+
+ [6]: {{ site.baseurl }}/static/img/guide/platforms/blackberry10/bb_devel.png
+
+當您設置黑莓 10 平臺為您的專案包含一組額外的命令列實用程式。 下面的命令，在這種情況下調用從專案的頂級目錄，將目標命名*動車組*與上面顯示的 IP 位址相關聯。
+
+* 關於視窗：
+
+ $ platforms\blackberry10\cordova\target.bat 添加鴯鶓 169.254.0.1-t 模擬器
+
+* 關於 Mac/Linux：
+
+ $ 平臺/blackberry10/科爾多瓦/目標添加鴯鶓 169.254.0.1-t 模擬器
+
+然後，運行 `emulate` 命令來查看該應用程式：
+
+ $ 科爾多瓦效仿 blackberry10
+
+
+## 將部署到設備
+
+若要部署到一個設備，請確保它插入到您的電腦。 啟用發展模式和獲得的 IP 位址為 desribed 以上的模擬程式部分中。 您還需要獲得從 PIN**設置**應用程式下的**關於 → 硬體**：
+
+![][7]
+
+ [7]: {{ site.baseurl }}/static/img/guide/platforms/blackberry10/bb_pin.png
+
+運行目標命令列實用程式將一個名稱與一個 IP 位址、 裝置密碼和 PIN 相關聯。
+
+* 關於視窗：
+
+ $ platforms\blackberry10\cordova\target.bat 添加差異 169.254.0.1-t 設備 — — 密碼 123456 — — pin FFFF972E
+
+* 關於 Mac/Linux：
+
+ $ 平臺/blackberry10/科爾多瓦/目標添加差異 169.254.0.1-t 設備 — — 密碼 123456 — — pin FFFF972E
+
+地點：
+
+* `--password`是指密碼來解鎖設備。
+
+* `--pin`是指設備從**設置**應用程式獲得的 PIN。
+
+然後，運行 `run` 命令來查看該應用程式：
+
+ 運行 blackberry10 $ 科爾多瓦
+
+
+如果調試權杖未尚未設置的設備，一條錯誤訊息會提示您使用與您的簽名金鑰提供註冊時的密碼運行腳本的平臺。
+
+* 關於視窗：
+
+ $ platforms\blackberry10\cordova\run.bat — — 設備 — — keystorepass mysecret
+
+* 關於 Mac/Linux：
+
+ $ 平臺/blackberry10/科爾多瓦/運行 — — 設備 — — keystorepass mysecret
+
+## WebInspector 的調試
+
+在調試時在設備或模擬程式上，您可以運行 WebInspector 遠端來查看應用程式的內部狀態。 使您可以連接到您的應用程式使用標準 web 瀏覽器的 URL 顯示一個提示。 有關詳細資訊，請參見[調試使用 WebInspector][8].
+
+ [8]: http://developer.blackberry.com/html5/documentation/web_inspector_overview_1553586_11.html
+
+## 生成發佈版本
+
+預設情況下，運行 `cordova build` 命令創建一個無符號的*.bar*包檔適用于設備或模擬器上測試。
+
+您需要運行一個不同 `build` 命令來創建一個發佈版本適合通過黑莓手機世界分佈。 它不依賴于 `cordova` CLI 的工具，而是使用下面的語法：
+
+* 關於視窗：
+
+ $ platforms\blackberry10\cordova\build.bat — — 釋放 — — keystorepass mysecret
+
+* 關於 Mac/Linux：
+
+ $ 平臺/blackberry10/科爾多瓦/生成 — — 釋放 — — keystorepass mysecret
+
+`--keystorepass`選項指定定義配置您的電腦登錄時的密碼的應用程式。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/plugin.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/plugin.md b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/plugin.md
new file mode 100644
index 0000000..4bf185f
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/plugin.md
@@ -0,0 +1,140 @@
+---
+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 外掛程式
+---
+
+# 黑莓 10 外掛程式
+
+這是延續科爾多瓦的外掛程式開發指南。 一旦您已經檢查過這些內容，現在讓我們看看我們需要有黑莓 10 平臺的回聲外掛程式的事情。 召回的回聲外掛程式基本上返回任何字串使用者提供的 `window.echo` 函數：
+
+ window.echo = function(str, callback) {
+ cordova.exec(callback, function(err) {
+ callback('Nothing to echo.');
+ }, "Echo", "echo", [str]);
+ };
+
+
+科爾多瓦本機的黑莓 10 外掛程式包含 JavaScript 代碼，還可能包含本機代碼。 Echo 外掛程式示例演示如何調用本機功能從 JavaScript。 本機和 JavaScript 代碼相互通信通過一個由 JNEXT 提供的框架。 每個外掛程式還必須包含 `plugin.xml` 檔。
+
+## 創建你的外掛程式的本機部分
+
+若要創建的本機部分你的外掛程式，打開黑莓 10 NDK IDE 並選擇檔 > 新 > 黑莓專案 > 本機擴展 > 黑莓手機 WebWorks。 請輸入您的所需的專案名稱 / 位置，然後按一下完成。
+
+由 IDE 創建的專案包含一個記憶體外掛程式的示例代碼。您可以替換或修改這些檔以包括您自己的功能。
+
+* `*name*_js.hpp`： JNEXT 代碼 c + + 頭。
+
+* `*name*_js.cpp`： JNEXT 的 c + + 代碼。
+
+JNEXT 擴展的本機介面可以查看外掛程式標頭檔位於公共的目錄中，您的專案中。 它還包含常量和可以在本機代碼中使用的實用程式函數。 你的外掛程式必須從 JSExt 在 plugin.h 中定義的派生。這就是，你必須實現下面的類：
+
+ 類 JSExt {公共： 虛擬 ~JSExt() {} ；虛擬字串 InvokeMethod (const 字串 & strCommand) = 0 ；虛擬 bool CanDelete （無效） = 0 ；私人： std::string m_id ；};
+
+
+因此，您的擴展應包含 plugin.h 標頭檔。在回波的示例中，您使用 JSExt，如下所示在 echo_js.hpp 檔中：
+
+ #include"....../ public/plugin.h"< 字串 > #ifndef ECHO_JS_H_ #define ECHO_JS_H_ #include 類回聲： 公共 JSExt {公共： 顯式回聲 (const std::string & id) ；虛擬 ~ echo () ；虛擬 std::string InvokeMethod (const std::string & 命令) ；虛擬 bool CanDelete() ；私人： std::string m_id ；};#endif / / ECHO_JS_H_
+
+
+`m_id`是一個包含此物件的 JNEXT id 的屬性。 Id 作為建構函式的參數傳遞到類。 它被需要觸發 JavaScript 邊從本機上的事件。 JNEXT 規定的 CanDelete 方法用於確定是否可以刪除您的本機物件的方法。 從 JavaScript 調用此特定物件的方法的請求結果調用 InvokeMethod 函數。 此函數的唯一參數是從這種方法應分析以確定應該執行哪種方法的本機物件的 JavaScript 傳遞的字串。 現在我們在 echo_js.cpp 中實現這些功能。對於回聲的示例，我們執行了 InvokeMethod 函數，如下所示：
+
+ 字串 Echo::InvokeMethod (const 字串和命令） {//parse 命令，並從字串 int 索引 args = command.find_first_of("") ；字串 strCommand = command.substr （0，索引） ；字串 strValue = command.substr (指數 + 1，command.length()) ；/ / 確定應該執行哪些函數如果 (strCommand = ="回聲") {返回 strValue;} 其他 {返回"不支援方法"；}
+ }
+
+
+你本機的外掛程式還必須實現以下回呼函數：
+
+* `extern char * onGetObjList （無效） ；`
+
+* `extern JSExt * onCreateObject (const 字串 & strClassName、 const 字串 & strObjId) ；`
+
+`onGetObjList`函數返回支援的 JNEXT 類的逗號分隔清單。 JNEXT 使用此函數來確定的 JNEXT 可以具現化的類的集合。 在我們回波的外掛程式，我們有以下 `echo_js.cpp` ：
+
+ char * onGetObjList() {靜態 char 名稱 [] ="回聲"；返回的名稱 ；}
+
+
+`onCreateObject`函數採用兩個參數。 第一個參數是類的請求將從 JavaScript 側創建的名稱。 有效的名稱就是那些在中返回 `onGetObjList` 。 第二個參數是類的唯一的物件 id。 此方法返回創建的外掛程式物件的指標。 在我們回波的外掛程式，我們有以下 `echo_js.cpp` ：
+
+ JSExt * onCreateObject (const 字串與類名、 常量字串 & id) {如果 (className = ="回聲") {返回新 Echo(id) ；} 返回 Null ；}
+
+
+## 創建你的外掛程式的 JavaScript 部分
+
+你的外掛程式的 JavaScript 部分必須包含以下檔：
+
+* `client.js`: 這被認為是在用戶端，並包含科爾多瓦應用程式可以調用的 API。 中的 API `client.js` 調用程式調用 `index.js` 。 中的 API `client.js` 也連接到火，回檔的事件的回呼函數。
+
+* `index.js`： 科爾多瓦載入 `index.js` 並使其可通過 cordova.exec 橋。 `client.js`檔程式中的 API 呼叫 `index.js` 檔中，從而使打電話到 JNEXT 與本機端進行通信。
+
+用戶端和伺服器端 ( `client.js` 和 `index.js` ) 進行交互，通過 `Cordova.exec` 函數。 所以，在 `client.js` 調用 `exec` 函數並提供必要的參數。 在回聲外掛程式，我們有以下 `client.js` 檔：
+
+ var service = "org.apache.cordova.blackberry.echo",
+ exec = cordova.require("cordova/exec");
+
+ module.exports = {
+ echo: function (data, success, fail) {
+ exec(success, fail, service, "echo", { data: data });
+ }
+ };
+
+
+現在， `index.js` 與本機的一面，用 JNEXT 進行交互。 所以您附加命名回顯到 JNEXT 的建構函式。 在建構函式內您執行下列關鍵操作使用 init 函數：
+
+* 指定匯出的本機方面所需的模組。所需的模組的名稱必須匹配的共用的庫檔 （.so 檔） 的名稱。
+
+`JNEXT.require("libecho")`
+
+* 通過使用獲得的模組創建一個物件並保存調用所返回的 ID。 self.m_id = JNEXT.createObject ("libecho。Echo"） ；當您的應用程式調用中的回波函數 `client.js` ，調用反過來調用的回波函數中 `index.js` 、 凡 PluginResult 物件將 （資料） 的回應發送回 `client.js` 。 由於傳遞到函數的 args 參數是由 JSON.stringfy() 轉換和編碼為 URIcomponent，您必須調用以下內容：
+
+`資料 = JSON.parse(decodeURIComponent(args.data)) ；`
+
+現在，您可以發送回來的資料。讓我們把它都放在一起：
+
+ module.exports = {
+
+ echo: function (success, fail, args, env) {
+
+ var result = new PluginResult(args, env),
+ data = JSON.parse(decodeURIComponent(args.data)),
+ response = echo.getInstance().echo(data);
+ result.ok(response, false);
+ }
+ };
+
+
+## 該外掛程式的體系結構
+
+您可以放置的工件的外掛程式，其中包括 `plugin.xml` 檔、 原始檔案 （JavaScript、 c + +） 和二進位檔案 ( `.so` ) 在任何目錄結構內，只要你正確地指定了檔位置在 `plugin.xml` 檔。 典型的結構看起來像這樣：
+
+***your\_project\_directory***(> 通過)
+
+* **www**(> client.js)
+* **src**
+ * **blackberry10**(> index.js 的**本機**> *.cpp、 *.hpp)
+ * **設備**(>*二進位檔案**.so)
+ * **模擬器**(>*二進位檔案**.so)
+
+（此清單顯示的頂層目錄之間的層次關係。 在括弧顯示給定目錄的內容。 所有目錄名稱都顯示為粗體文本。 檔的名稱前面有 `>` [標誌](../../../cordova/file/flags/flags.html).)
+
+## 內容的 `plugin.xml` 檔
+
+`plugin.xml`檔中包含的命名空間的擴展和其他中繼資料。定義的命名空間和指定的 Echo 外掛程式的其他中繼資料，如下所示：
+
+ < 外掛程式 xmlns ="HTTP://www.phonegap.com/ns/plugins/1.0"id="org.apache.cordova.blackberry.echo"版本 ="1.0.0">< js 模組 src ="www/client.js">< 合併目標 ="導航"/ >< / js 模組 >< 平臺名稱 ="blackberry10">< 原始檔案 src="src/blackberry10/index.js"/ >< lib 檔 src="src/blackberry10/native/device/libecho.so"拱 ="設備"/ >< lib 檔 src="src/blackberry10/native/simulator/libecho.so"拱 ="模擬器"/ >< 設定檔目標 ="www/config.xml"父 ="/ widget">< 功能 name="org.apache.cordova.blackberry.echo"value="org.apache.cordova.blackberry.echo"/ >< / 設定檔 >< /平臺 >< / 外掛程式 >
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/tools.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/tools.md b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/tools.md
new file mode 100644
index 0000000..d3bc781
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/tools.md
@@ -0,0 +1,146 @@
+---
+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 命令列工具
+---
+
+# 黑莓 10 命令列工具
+
+`cordova`命令列實用程式是一個高級別的工具，允許您在一次跨幾個平臺生成的應用程式。 舊版本的科爾多瓦框架提供了特定于每個平臺的命令列工具集。 若要使用它們作為 CLI 的替代，您需要從[cordova.apache.org][1]下載此版本的科爾多瓦。 下載檔案中包含單獨的檔案，為每個平臺。 展開您想要的目標平臺。 這裡描述的工具，通常可用在頂級 `bin` 目錄中，否則為諮詢**自述**檔，瞭解有關更多詳細的指示。
+
+ [1]: http://cordova.apache.org
+
+如果您需要幫助與下面列出的任何命令，請鍵入命令沿與 `-h` 或 `-help` 參數，所支援的所有命令並提供為每個可用的參數說明。
+
+## 創建
+
+`create`命令將創建一個新的專案：
+
+ bin/創建 < 路徑到專案 >< 專案-包 >< 專案名稱 >
+
+
+在哪裡
+
+* `<path-to-project>`指定您想要的專案中創建的目錄
+
+* `<project-package>`指定一個反向功能變數名稱樣式識別碼
+
+* `<project-name>`指定應用程式的顯示名稱
+
+**注：** `create` 命令引導其依賴項安裝通過 `npm install` 命令。 根據安裝的目錄和系統許可權，這可能需要管理員特權。 如果在 OSX/Linux 上有問題，請運行 `sudo npm install` 之前使用 `create` 命令。 在 Windows 上，運行 `npm install` 命令列實用程式中打開具有管理員許可權。
+
+## 目標
+
+`target`命令允許您管理模擬器或您使用來測試您的應用程式的黑莓設備。您可以添加或刪除一個目標，或將目標設置為的預設目標。
+
+### 添加目標
+
+ < 路徑到專案 >/科爾多瓦/目標添加 < 名稱 >< 的 ip 位址 > [-t |-類型 < 設備 | 模擬器 >] [-p |-< 密碼 >] [— — pin < 設備針 >]
+
+
+在哪裡
+
+* `<name>`指定目標的唯一名稱。
+
+* `<ip-address>`指定的 ip 位址的黑莓設備或模擬器。
+
+* `-p | --password <password>`指定的設備或模擬程式的密碼。只有在設備或模擬器是受密碼保護，這是必需的。
+
+* `--pin <device-pin>`指定的黑莓設備，作為一個有效的主機調試標記標識該設備的 PIN。 此參數是必需的只有當您要創建一個調試標記。
+
+### 刪除目標
+
+ < 路徑到專案 >/科爾多瓦/目標刪除 < 名稱 >
+
+
+### 將目標設置為預設值
+
+ < 路徑到專案 >/科爾多瓦/目標預設 < 名稱 >
+
+
+## 生成
+
+`build`命令將生成作為.bar 檔的專案。 您可以建立您的應用程式中任何一種釋放模式 （會產生一個簽名的.bar 檔） 或在偵錯模式下 （會產生一個無符號的.bar 檔）。
+
+### 生成您在發佈模式下的專案
+
+ < 路徑到專案 >/科爾多瓦/生成釋放 [-k |-keystorepass < 密碼 >] [-b |-buildId < 數量 >] [-p |-params < params JSON 檔 >]
+
+
+在哪裡
+
+* `-k | --keystorepass <password>`指定當您配置您的電腦以簽名的應用程式定義的密碼。
+
+* `-b | --buildId <number>`指定您的應用程式的內部版本號。 通常情況下，這個數位應從以前的已簽名版本遞增。 此參數是可選的。
+
+* `-p | --params <params-JSON-file>`指定包含要傳遞給下游工具的額外參數的 JSON 檔。此參數是可選的。
+
+### 生成您在偵錯模式下的專案
+
+ < 路徑到專案 >/科爾多瓦/生成調試 [< 目標 >] [-k |-keystorepass < 密碼 >] [-p |-params < params JSON 檔 >] [-ll | — — loglevel < error|warn|verbose >]
+
+
+在哪裡
+
+* `<target>`指定以前添加的目標的名稱。 如果 `<target>` 不指定，則預設的目標使用，如果其中一個已創建。 此參數才是必需的如果你想要的腳本，以將您的應用程式部署到黑莓設備或模擬程式和你沒有創建一個預設目標。 此外，如果 `<target>` 是一個設備，然後該設備必須連接到您的電腦的 USB 連接或連接到您的電腦位於同一 Wi-Fi 網路。
+
+* `-k | --keystorepass <password>`指定當您配置您的電腦以簽名的應用程式定義的密碼。 此密碼還用於創建您的調試權杖。 此參數才是必需如果你想要創建並為您安裝調試權杖的腳本。
+
+* `-p | --params <params-JSON-file>`指定包含要傳遞給下游工具的額外參數的 JSON 檔。
+
+* `-ll | --loglevel <level>`指定的日誌級別。日誌級別可能是 `error` ， `warn` ，或`verbose`.
+
+如果你有以前定義一個預設目標 （和以前安裝調試的標記，如果這一目標是黑莓設備），你可以不帶任何參數運行該腳本，該腳本將打包您的應用程式並將它部署到預設的目標。 例如：
+
+ < 路徑到專案 >/科爾多瓦/生成調試
+
+
+## 運行
+
+`run`命令部署該應用程式指定的黑莓設備或模擬程式上。 在部署之前您的應用程式，您必須首先創建一個目標設備或模擬程式您想要將您的應用程式部署到使用目標的腳本。 部署腳本將部署您的應用程式的最新版本。
+
+ < 路徑到專案 >/科爾多瓦/運行 < 目標 >
+
+
+在哪裡
+
+* `<target>`指定以前添加的目標的名稱。 如果 `<target>` 是一個設備，然後該設備必須連接到您的電腦的 USB 連接或連接到您的電腦位於同一 Wi-Fi 網路。
+
+## 外掛程式
+
+`target`命令允許您添加和刪除外掛程式
+
+### 獲取本地承載的外掛程式
+
+ < 路徑到專案 >/科爾多瓦/外掛程式 fetch < 路徑到外掛程式 >
+
+
+### 查看已安裝的外掛程式的清單
+
+ < 路徑到專案 >/科爾多瓦/外掛程式 ls
+
+
+### 添加外掛程式
+
+ < 路徑到專案 >/科爾多瓦/外掛程式添加 < 名稱 >
+
+
+### 刪除某個外掛程式
+
+ < 路徑到專案 >/科爾多瓦/外掛程式 rm < 名稱 >
\ 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