cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dblot...@apache.org
Subject [30/51] [partial] docs commit: Adding both Chinese versions.
Date Wed, 06 Apr 2016 09:27:46 GMT
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.5.0/guide/platforms/amazonfireos/webview.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.5.0/guide/platforms/amazonfireos/webview.md b/www/docs/zh-cn/3.5.0/guide/platforms/amazonfireos/webview.md
new file mode 100644
index 0000000..8bca8ed
--- /dev/null
+++ b/www/docs/zh-cn/3.5.0/guide/platforms/amazonfireos/webview.md
@@ -0,0 +1,122 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: 亞馬遜火 OS WebViews
+---
+
+# 亞馬遜火 OS WebViews
+
+從 3.0.0 開始,你可以使用科爾多瓦作為亞馬遜火 OS 應用程式中的一個元件。 亞馬遜火 OS 是指這種元件 `CordovaWebView` 。 `CordovaWebView`擴展建立在開放原始碼鉻專案的亞馬遜 web 視圖。 通過利用此功能,您的 web 應用程式可以利用最新的 HTML5 web 標準在現代 web 運行時引擎中運行。
+
+## 系統必備元件
+
+*   科爾多瓦 3.0.0 或更大
+
+*   Android SDK 更新到最新的 SDK
+
+*   亞馬遜 web 視圖 SDK
+
+## 在亞馬遜火 OS 專案中使用 CordovaWebView 的指南
+
+1.  下載並展開[亞馬遜 web 視圖 SDK][1] ,然後複製到 awv_interface.jar `/framework/libs` 目錄。 創建庫 / 資料夾如果它不存在。
+
+2.  `cd`到 `/framework` 並運行 `ant jar` 打造科爾多瓦 jar。 它創建時所形成的.jar 檔 `cordova-x.x.x.jar` 在 `/framework` 目錄。
+
+3.  編輯您的應用程式的 `main.xml` 檔 (根據 `/res/layout` ),看起來像下面這樣,與 `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());
+            }
+        
+
+ [1]: https://developer.amazon.com/sdk/fire/IntegratingAWV.html#installawv
+
+如果您使用的相機,你應該也可以實現這:
+
+        @Override
+        public void setActivityResultCallback(CordovaPlugin plugin) {
+            this.activityResultCallback = plugin;
+        }
+        /**
+         * Launch an activity for which you would like a result when it finished. When this activity exits,
+         * your onActivityResult() method is called.
+         *
+         * @param command           The command object
+         * @param intent            The intent to start
+         * @param requestCode       The request code that is passed to callback to identify the activity
+         */
+        public void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode) {
+            this.activityResultCallback = command;
+            this.activityResultKeepRunning = this.keepRunning;
+    
+            // If multitasking turned on, then disable it for activities that return results
+            if (command != null) {
+                this.keepRunning = false;
+            }
+    
+            // Start activity
+            super.startActivityForResult(intent, requestCode);
+        }
+    
+        @Override
+        /**
+         * Called when an activity you launched exits, giving you the requestCode you started it with,
+         * the resultCode it returned, and any additional data from it.
+         *
+         * @param requestCode       The request code originally supplied to startActivityForResult(),
+         *                          allowing you to identify who this result came from.
+         * @param resultCode        The integer result code returned by the child activity through its setResult().
+         * @param data              An Intent, which can return result data to the caller (various data can be attached to Intent "extras").
+         */
+        protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
+            super.onActivityResult(requestCode, resultCode, intent);
+            CordovaPlugin callback = this.activityResultCallback;
+            if (callback != null) {
+                callback.onActivityResult(requestCode, resultCode, intent);
+            }
+        }
+    
+
+最後,請記住,添加執行緒池,否則外掛程式有沒有線程上運行:
+
+        @Override
+        public ExecutorService getThreadPool() {
+            return threadPool;
+        }
+    
+
+1.  將您的應用程式的 HTML 和 JavaScript 檔案複製到您的亞馬遜火 OS 專案 `/assets/www` 目錄。
+
+2.  複製 `config.xml` 從 `/framework/res/xml` 到您的專案的 `/res/xml` 目錄。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.5.0/guide/platforms/android/config.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.5.0/guide/platforms/android/config.md b/www/docs/zh-cn/3.5.0/guide/platforms/android/config.md
new file mode 100644
index 0000000..a6d44db
--- /dev/null
+++ b/www/docs/zh-cn/3.5.0/guide/platforms/android/config.md
@@ -0,0 +1,77 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: Android 系統組態
+---
+
+# Android 系統組態
+
+`config.xml`檔控制應用於每個應用程式和 CordovaWebView 實例的應用程式的基本設置。 本節詳細說明僅適用于 android 系統生成的首選項。 有關全域配置選項,請參閱 config.xml 檔的資訊。
+
+*   `KeepRunning`(boolean 類型的值,預設值為 `true` ): 確定應用程式是否保持甚至後在後臺運行 `pause` 事件火災。 注意: 將此設置為 false 不會殺了這款應用程式暫停事件之後,該應用程式時在後臺只將停止執行科爾多瓦 web 視圖中的代碼。
+    
+        <preference name="KeepRunning" value="false"/>
+        
+
+*   `LoadUrlTimeoutValue`(以毫秒為單位的數位,預設為 `20000` ,20 秒): 當載入一個頁面,在引發逾時錯誤之前等待的時間量。 此示例指定 10 秒,而不是 20:
+    
+        <preference name="LoadUrlTimeoutValue" value="10000"/>
+        
+
+*   `SplashScreen`(字串,預設值為 `splash` ): 包括其副檔名的檔的名稱 `res/drawable` 目錄。 各種資產必須共用此各子目錄中的共同名稱。
+    
+        <preference name="SplashScreen" value="mySplash"/>
+        
+
+*   `SplashScreenDelay`(編號以毫秒為單位,預設值為 `3000` ): 所需的時間初始螢幕圖像顯示。
+    
+        <preference name="SplashScreenDelay" value="10000"/>
+        
+
+*   `InAppBrowserStorageEnabled`(boolean 類型的值,預設值為 `true` ): 控制項是否在 InAppBrowser 內打開的頁可以訪問同一認為和 WebSQL 存儲作為預設瀏覽器打開的頁面。
+    
+        <preference name="InAppBrowserStorageEnabled" value="true"/>
+        
+
+*   `LoadingDialog`(字串,預設值為 `null` ): 如果設置,顯示一對話方塊中指定的標題和消息,和一個微調框,載入的應用程式中的第一頁時。 由在此值字串中的逗號分隔的標題和消息,那逗號刪除之前顯示的對話方塊。
+    
+        <preference name="LoadingDialog" value="My Title,My Message"/>
+        
+
+*   `LoadingPageDialog`(字串,預設值為 `null` ): 相同, `LoadingDialog` ,但用於在應用程式中的第一頁後載入的每個頁面。
+    
+        <preference name="LoadingPageDialog" value="My Title,My Message"/>
+        
+
+*   `ErrorUrl`(URL,預設為 `null` ): 如果設置,將顯示而不是以"應用程式錯誤"標題對話方塊的應用程式中的錯誤時所引用的網頁。
+    
+        <preference name="ErrorUrl" value="myErrorPage.html"/>
+        
+
+*   `ShowTitle`(boolean 類型的值,預設值為 `false` ): 顯示在螢幕頂部的標題。
+    
+        <preference name="ShowTitle" value="true"/>
+        
+
+*   `LogLevel`(字串,預設值為 `ERROR` ): 將通過哪些日誌將過濾郵件從您的應用程式的最小日誌級別設置。 有效的值為 `ERROR` , `WARN` , `INFO` , `DEBUG` ,和`VERBOSE`.
+    
+        <preference name="LogLevel" value="VERBOSE"/>
+        
+
+*   `SetFullscreen`(boolean 類型的值,預設值為 `false` ): 同樣作為 `Fullscreen` 在此 xml 檔的全域配置參數。 此 Android 特定元素支援全球否決 `Fullscreen` 元素,並將在未來版本中移除。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.5.0/guide/platforms/android/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.5.0/guide/platforms/android/index.md b/www/docs/zh-cn/3.5.0/guide/platforms/android/index.md
new file mode 100644
index 0000000..101f665
--- /dev/null
+++ b/www/docs/zh-cn/3.5.0/guide/platforms/android/index.md
@@ -0,0 +1,200 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: Android 平臺指南
+---
+
+# Android 平臺指南
+
+本指南介紹如何設置您的 SDK 開發環境部署科爾多瓦的 Android 設備的應用程式。 它引導您通過安裝 Android SDK,在 Eclipse SDK 中打開 Android 專案和部署到模擬器或設備的過程。 您將需要按照本指南,請至少在安裝 Android SDK,無論哪個工作流如下。 ( *Web 專案開發*和*本機平臺開發*工作流需要預先安裝並在您的路徑通過讀取了 Android SDK。
+
+請參閱下列特定于平臺的詳細資訊:
+
+*   [Android 系統組態](config.html)
+*   [Android WebViews](webview.html)
+*   [Android 外掛程式](plugin.html)
+*   [升級 Android](upgrading.html)
+*   [Android 系統的命令列工具](tools.html)
+
+上面的命令列工具請參閱科爾多瓦 3.0 以前的版本。關於當前介面的資訊,請參閱命令列介面。
+
+## 要求和支援
+
+Android SDK,請參閱[系統要求][1]。
+
+ [1]: http://developer.android.com/sdk/index.html
+
+科爾多瓦支援 Android 2.2、 2.3 和 4.x。作為一般規則,平臺已棄用作為他們低於 5%的谷歌的[分佈的儀表板][2].
+
+ [2]: http://developer.android.com/about/dashboards/index.html
+
+<!--
+NOTE, doc said:
+- Android 2.1 (Deprecated May 2013)
+- Android 3.x (Deprecated May 2013)
+-->
+
+開發人員應使用 `cordova` 實用程式與 Android SDK 一起。 命令列介面資訊,請參閱如何安裝它,添加專案,然後生成和部署專案。
+
+請在安裝 Android SDK 從 [developer.android.com/sdk][3].作為分發,android sdk ' adt-捆綁-<os>-<arch>-<ver>' 檔。在 windows 上,adt 捆綁打包用安裝程式安裝。在 OSX 和 Linux,只需打開包裝 'adt 捆綁' 中的位置,您將存儲的開發工具。 [關於 Android SDK 安裝程式的詳細的資訊可以在這裡找到][4]
+
+ [3]: http://developer.android.com/sdk/
+ [4]: http://developer.android.com/sdk/installing/bundle.html
+
+科爾多瓦命令列工具來工作,您需要包括 SDK 的 `tools` 和 `platform-tools` 的路徑環境中目錄。 在 Mac 上可以使用文字編輯器來創建或修改 `~/.bash_profile` 檔中,添加行,如下,根據 SDK 的安裝位置:
+
+    匯出路徑 = ${路徑}:/開發/adt-捆綁/sdk/平臺-工具:/開發/adt-捆綁/sdk/工具
+    
+
+這暴露了 SDK 工具在新打開的終端視窗。否則運行這使它們在當前會話中可用:
+
+    元源 ~/.bash_profile
+    
+
+若要修改路徑上 Windows 7 的環境:
+
+*   在桌面的左下角的**開始**功能表上按一下,在**電腦**上,按右鍵,然後按一下**屬性**.
+
+*   在左側列中,按一下**高級系統設置**。
+
+*   在結果對話方塊中,按下**環境變數**.
+
+*   選擇**PATH**變數,然後按**編輯**.
+
+*   將以下內容追加到基於例如安裝 SDK 的位置的路徑:
+    
+        ;C:\Development\adt-bundle\sdk\platform-tools;C:\Development\adt-bundle\sdk\tools
+        
+
+*   將值保存並關閉這兩個對話方塊。
+
+您可能還需要啟用 JAVA 和螞蟻打開一個命令提示符並鍵入 `java` ,然後還鍵入 `ant` 。將追加到該路徑無法運行的日期為准:
+
+        ;%JAVA_HOME%\bin;%ANT_HOME%\bin
+    
+
+## 在 SDK 中打開的專案
+
+使用 `cordova` 實用程式設置了一個新的專案,如所述在科爾多瓦命令列介面。例如,在原始程式碼中的目錄:
+
+        $ cordova create hello com.example.hello "HelloWorld"
+        $ cd hello
+        $ cordova platform add android
+        $ cordova build
+    
+
+一旦創建了,這裡是如何使用 SDK 來修改它:
+
+*   啟動**Eclipse**應用程式。
+
+*   選擇**新建專案**功能表項目。
+
+*   從結果對話方塊中,選擇**從現有代碼的 Android 專案**並按**下一步**: ![][5]
+
+*   定位到 `hello` ,或無論你創建目錄的專案,然後到 `platforms/android` 子目錄。
+
+*   請確保兩個 `hello` 和 `hello-CordovaLib` 專案被選定要導入。 `hello-CordovaLib`專案需要到科爾多瓦 3.3.0,因為科爾多瓦現在用作 Android 庫而不是.jar 檔。
+
+*   按**完成**.
+
+ [5]: {{ site.baseurl }}/static/img/guide/platforms/android/eclipse_new_project.png
+
+一旦日食視窗將打開,一個紅色的**X**可能似乎表明未解決的問題。如果是這樣,執行這些額外的步驟:
+
+*   按右鍵專案目錄。
+
+*   在出現的**屬性**對話方塊中,選擇**Android**從功能窗格。
+
+*   為專案生成目標,選擇您已安裝的最高的 Android API 級別。
+
+*   按一下**確定**.
+
+*   從**專案**功能表中選擇**清潔**。這應該更正該專案中的所有錯誤。
+
+## 部署到模擬程式
+
+您可以使用 `cordova` 實用程式在一個模擬程式,或你運行一個應用程式可以在 SDK 內運行它。 不管怎樣,SDK 必須首先配置以顯示至少一個設備。 若要這樣做,請使用 Android SDK 經理,從 Eclipse 獨立運行的 JAVA 應用程式。 有兩種方法來打開它:
+
+*   運行 `android` 命令列上。
+
+*   從內日食,按此工具列圖示:
+    
+    ![][6]
+
+ [6]: {{ site.baseurl }}/static/img/guide/platforms/android/eclipse_android_sdk_button.png
+
+一旦打開,Android SDK 管理器將顯示不同的運行時庫:
+
+![][7]
+
+ [7]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_window.png
+
+選擇**工具 → 管理 AVDs** (Android 的虛擬裝置),然後從**裝置定義**在隨後出現的對話方塊中選擇任何項:
+
+![][8]
+
+ [8]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_device.png
+
+新聞**創建 AVD**,(可選) 修改該名稱,然後按**確定**以接受這些更改:
+
+![][9]
+
+ [9]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_newAVD.png
+
+AVD 然後出現在**虛擬的 Android 設備**清單中:
+
+![][10]
+
+ [10]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_avds.png
+
+若要打開模擬器作為單獨的應用程式,選擇 AVD 然後按**開始**。它發射將在設備上,與其他控制項可用的硬體按鈕:
+
+![][11]
+
+ [11]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_emulator.png
+
+此時你可以使用 `cordova` 實用程式將應用部署到模擬程式從命令列:
+
+        $ cordova emulate android
+    
+
+如果改為您在 Eclipse 內工作,用滑鼠右鍵按一下該專案,並選擇**作為 → 運行 Android 應用程式**。可能要求您指定 AVD,如果都已經打開。
+
+為獲得更快的體驗,使用基於英特爾的模擬程式映射:
+
+*   安裝一個或多個 `Intel x86 Atom` 的系統映射,以及 `Intel Hardware Accelerated Execution Manager` 下**的額外**的可用.
+
+*   運行英特爾安裝程式時,這是在您 Android SDK 內可用`extras/intel/Hardware_Accelerated_Execution_Manager`.
+
+*   設置為英特爾圖像的目標來創建新的 AVD。
+
+*   當啟動模擬程式,確保沒有任何錯誤訊息,指示未能載入 HAX 模組。
+
+## 將部署到設備
+
+要將應用程式推直接到設備,請確保您的設備上的[Android 開發者網站][12],所述上啟用 USB 調試和使用一個迷你 USB 電纜,將其插入您的系統。
+
+ [12]: http://developer.android.com/tools/device.html
+
+從命令列,可以將應用程式推送到設備:
+
+        $ cordova run android
+    
+
+交替內日食,按右鍵該專案並選擇**作為 → 運行 Android 應用程式**.

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.5.0/guide/platforms/android/plugin.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.5.0/guide/platforms/android/plugin.md b/www/docs/zh-cn/3.5.0/guide/platforms/android/plugin.md
new file mode 100644
index 0000000..8b1f7af
--- /dev/null
+++ b/www/docs/zh-cn/3.5.0/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` 和 `resume` 事件,以及任何外掛程式之間傳遞的消息。 外掛程式需要長時間運行的請求,後臺活動媒體重播、 聽眾或內部狀態等應執行 `onReset()` ,以及方法。 它執行時 `WebView` 定位到新的一頁或刷新,重新載入 JavaScript。
+
+## 外掛程式類映射
+
+外掛程式的 JavaScript 介面使用 `cordova.exec` 方法,如下所示:
+
+        exec(<successFunction>, <failFunction>, <service>, <action>, [<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 調用觸發外掛程式請求到本機的一邊,和 correspoinding 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/3.5.0/guide/platforms/android/tools.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.5.0/guide/platforms/android/tools.md b/www/docs/zh-cn/3.5.0/guide/platforms/android/tools.md
new file mode 100644
index 0000000..a0034e7
--- /dev/null
+++ b/www/docs/zh-cn/3.5.0/guide/platforms/android/tools.md
@@ -0,0 +1,74 @@
+---
+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 系統的命令列工具
+
+`cordova`命令列實用程式是一個高級別的工具,允許您在一次跨幾個平臺生成的應用程式。 舊版本的科爾多瓦框架提供了特定于每個平臺的命令列工具集。 若要使用它們作為 CLI 的替代,您需要從[cordova.apache.org][1]下載此版本的科爾多瓦。 下載檔案中包含單獨的檔案,為每個平臺。 展開您想要的目標平臺。 這裡描述的工具,通常可用在頂級 `bin` 目錄中,否則為諮詢**自述**檔,瞭解有關更多詳細的指示。
+
+ [1]: http://cordova.apache.org
+
+低級命令列介面,它使外掛程式的資訊,請參閱使用 Plugman 到管理外掛程式。有關概述,請參見應用程式外掛程式。
+
+## 創建一個專案
+
+運行 `create` 命令,指定的現有路徑的專案、 反向域式包識別碼和應用程式的顯示名稱。這裡是 Mac 和 Windows 的語法:
+
+    $ /path/to/cordova-android/bin/create /path/to/project com.example.project_name ProjectName
+    $ C:\path\to\cordova-android\bin\create.bat C:\path\to\project com.example.project_name ProjectName
+    
+
+## 生成
+
+此清理,然後生成專案。
+
+在 Mac 或 Windows 上調試:
+
+    $ /path/to/project/cordova/build --debug
+    $ C:\path\to\project\cordova\build.bat --debug
+    
+
+釋放,Mac 或 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 $ C:\path\to\project\cordova\run.bat \[目標\] \[生成\]
+
+請確保您創建至少一個 Android 虛擬裝置,否則為系統會提示您這樣與做 `android` 命令。 如果多個 AVD 可用作為目標,提示您選擇一個。 預設情況下 `run` 命令檢測連接的設備或當前正在運行的模擬程式,如果沒有設備發現。
+
+## 日誌記錄
+
+    $ /path/to/project/cordova/log $ C:\path\to\project\cordova\log.bat
+    
+
+### 清洗
+
+    $ /path/to/project/cordova/clean $ C:\path\to\project\cordova\clean.bat
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.5.0/guide/platforms/android/upgrading.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.5.0/guide/platforms/android/upgrading.md b/www/docs/zh-cn/3.5.0/guide/platforms/android/upgrading.md
new file mode 100644
index 0000000..335a4b5
--- /dev/null
+++ b/www/docs/zh-cn/3.5.0/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/3.5.0/guide/platforms/android/webview.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.5.0/guide/platforms/android/webview.md b/www/docs/zh-cn/3.5.0/guide/platforms/android/webview.md
new file mode 100644
index 0000000..b9b2a22
--- /dev/null
+++ b/www/docs/zh-cn/3.5.0/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/3.5.0/guide/platforms/blackberry/config.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.5.0/guide/platforms/blackberry/config.md b/www/docs/zh-cn/3.5.0/guide/platforms/blackberry/config.md
new file mode 100644
index 0000000..b66e781
--- /dev/null
+++ b/www/docs/zh-cn/3.5.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.5.0/guide/platforms/blackberry/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.5.0/guide/platforms/blackberry/index.md b/www/docs/zh-cn/3.5.0/guide/platforms/blackberry/index.md
new file mode 100644
index 0000000..5519e8b
--- /dev/null
+++ b/www/docs/zh-cn/3.5.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 平臺指南。 請參閱下列特定于平臺的詳細資訊:
+
+*   [黑莓手機配置](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/3.5.0/guide/platforms/blackberry/plugin.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.5.0/guide/platforms/blackberry/plugin.md b/www/docs/zh-cn/3.5.0/guide/platforms/blackberry/plugin.md
new file mode 100644
index 0000000..75f813c
--- /dev/null
+++ b/www/docs/zh-cn/3.5.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.5.0/guide/platforms/blackberry/tools.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.5.0/guide/platforms/blackberry/tools.md b/www/docs/zh-cn/3.5.0/guide/platforms/blackberry/tools.md
new file mode 100644
index 0000000..7ed7127
--- /dev/null
+++ b/www/docs/zh-cn/3.5.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


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


Mime
View raw message