cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dblot...@apache.org
Subject [40/51] [partial] docs commit: Adding both Chinese versions.
Date Wed, 06 Apr 2016 09:27:56 GMT
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/upgrading.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/upgrading.md b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/upgrading.md
new file mode 100644
index 0000000..3ed51d4
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/upgrading.md
@@ -0,0 +1,457 @@
+---
+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 版本。
+
+## 從 3.0.0 升級到 3.1.0
+
+1.  創建新的 Apache 科爾多瓦 3.1.0 專案使用 CLI,科爾多瓦,如所述的命令列介面。
+
+2.  添加您的平臺到科爾多瓦專案中,例如:`cordova
+platform add blackberry10`.
+
+3.  複製的原始專案內容 `www` 目錄到 `www` 目錄在您剛剛創建的科爾多瓦專案的根目錄。
+
+4.  複製或覆蓋原始專案中的任何本機資產 ( `Resources` ,等等.)
+
+5.  複製您 `config.xml` 到 `www` 目錄中,並刪除任何外掛程式定義。您將修改此處的設置而不是平臺目錄。
+
+6.  使用科爾多瓦 CLI 工具來安裝您需要的任何外掛程式。 請注意 CLI 處理所有核心 Api 作為外掛程式,所以他們可能需要添加。 只有外掛程式標記 3.0.0 和上文與 CLI 相容。
+
+7.  生成並測試。
+
+請注意,CLI 完全支援 BlackBerry10 平臺。PlayBook 和 BBOS,請參閱版本 2.9.0 科爾多瓦和下方。
+
+## 從 2.9.0 升級到 CLI (3.0.0)
+
+1.  創建新的 Apache 科爾多瓦 3.0.0 專案使用 CLI,科爾多瓦,如所述的命令列介面。
+
+2.  添加您的平臺的科爾多瓦專案,例如:`cordova
+platform add blackberry10`.
+
+3.  複製的原始專案內容 `www` 目錄到 `www` 目錄在您剛剛創建的科爾多瓦專案的根目錄。
+
+4.  複製或覆蓋原始專案中的任何本機資產 ( `Resources` ,等等.)
+
+5.  複製您 `config.xml` 到 `www` 目錄中,並刪除任何外掛程式定義。您將修改此處的設置而不是平臺目錄。
+
+6.  使用科爾多瓦 CLI 工具來安裝您需要的任何外掛程式。請注意 CLI 處理所有核心 Api 作為外掛程式,所以他們可能需要添加。只有 3.0.0 外掛程式是與 CLI 相容。
+
+7.  生成並測試。
+
+## 升級 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` 目錄。
+
+更新示例 / 目錄或遷移現有的專案:
+
+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` 檔。
+
+更新 (即,更新使用 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` 檔。
+
+更新 (即,更新使用 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` 檔。
+
+更新 (即,更新使用 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` 檔。
+
+更新 (即,更新使用 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"/ >
+        
+
+更新 (即,更新使用 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"/ >
+        
+
+更新 (即,更新使用 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/firefoxos/config.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/firefoxos/config.md b/www/docs/zh-cn/3.1.0/guide/platforms/firefoxos/config.md
new file mode 100644
index 0000000..b56a61b
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/guide/platforms/firefoxos/config.md
@@ -0,0 +1,23 @@
+---
+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: FirefoxOS 配置
+---
+
+# FirefoxOS 配置
\ 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/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/index.md b/www/docs/zh-cn/3.1.0/guide/platforms/index.md
new file mode 100644
index 0000000..0a453ca
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/guide/platforms/index.md
@@ -0,0 +1,79 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: 平臺指南
+---
+
+# 平臺指南
+
+在開發之前為任何下面列出的平臺,安裝科爾多瓦的命令列介面 (CLI)。(有關詳細資訊,見命令列介面)。
+
+要開發科爾多瓦的應用程式,您必須為您的目標每個移動平臺安裝 Sdk。 這種安裝是工作的必要無論你做你在 SDK 中多數還是為您組建循環使用 CLI 的。
+
+下面列出每個*平臺指南*告訴您您需要知道要設置的每個平臺的開發環境: 在何處獲取 SDK、 如何設置設備模擬程式、 如何連接設備進行直接測試和如何管理簽署的關鍵要求。 附加指南提供了每個平臺特有的配置選項,說明添加外掛程式,資訊如何升級每個平臺,以及特定于平臺的命令列工具,作為一個較低級別的替代 `cordova` 命令列實用程式。
+
+## Android 系統
+
+*   [Android 平臺指南](android/index.html)
+*   [Android 系統組態](android/config.html)
+*   [Android WebViews](android/webview.html)
+*   [Android 外掛程式](android/plugin.html)
+*   [Android 系統的命令列工具](android/tools.html)
+*   [升級 Android](android/upgrading.html)
+
+## 黑莓手機
+
+*   [黑莓平臺指南](blackberry/index.html)
+*   [黑莓手機配置](blackberry10/config.html)
+*   [黑莓手機的命令列工具](blackberry/tools.html)
+*   [升級黑莓手機](blackberry10/upgrading.html)
+
+## 黑莓 10
+
+*   [10 黑莓平臺指南](blackberry10/index.html)
+*   黑莓 10 [配置](../../cordova/media/capture/ConfigurationData.html)
+*   [黑莓 10 外掛程式](blackberry10/plugin.html)
+*   [黑莓 10 命令列工具](blackberry10/tools.html)
+
+## iOS
+
+*   [iOS 平臺指南](ios/index.html)
+*   [iOS 配置](ios/config.html)
+*   [WebViews iOS](ios/webview.html)
+*   [iOS 外掛程式](ios/plugin.html)
+*   [iOS 命令列工具](ios/tools.html)
+*   [升級 iOS](ios/upgrading.html)
+
+## Windows Phone
+
+*   [Windows Phone 8 平臺指南](wp8/index.html)
+*   [Windows Phone 7 平臺指南](wp7/index.html)
+*   Windows Phone [配置](../../cordova/media/capture/ConfigurationData.html)
+*   [Windows Phone 的命令列工具](wp8/tools.html)
+*   [升級 Windows Phone](wp8/upgrading.html)
+
+## Windows 8
+
+*   [Windows 8 平臺指南](win8/index.html)
+*   [Windows 8 的命令列工具](win8/tools.html)
+*   [升級 Windows 8](win8/upgrading.html)
+
+## Tizen
+
+*   [Tizen 平臺指南](tizen/index.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/ios/config.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/ios/config.md b/www/docs/zh-cn/3.1.0/guide/platforms/ios/config.md
new file mode 100644
index 0000000..4b25401
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/guide/platforms/ios/config.md
@@ -0,0 +1,99 @@
+---
+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: iOS 配置
+---
+
+# iOS 配置
+
+`config.xml`檔控制應用於每個應用程式和 CordovaWebView 實例的應用程式的基本設置。 本節詳細說明僅適用于 iOS 版本的首選項。 有關全域配置選項,請參閱 config.xml 檔的資訊。
+
+*   `EnableViewportScale`(boolean 類型的值,預設值為 `false` ): 設置為 `true` 使用視區的元標記來禁用或限制的使用者縮放的範圍。
+    
+        <preference name="EnableViewportScale" value="true"/>
+        
+
+*   `MediaPlaybackRequiresUserAction`(boolean 類型的值,預設值為 `false` ): 設置為 `true` 以防止 HTML5 視頻自動播放的 `autoplay` 屬性。 調用時,不適用 `play()` 視頻物件上。
+    
+        <preference name="MediaPlaybackRequiresUserAction" value="true"/>
+        
+
+*   `AllowInlineMediaPlayback`(boolean 類型的值,預設值為 `false` ): 設置為 `true` ,讓 HTML5 播放媒體顯示*內聯*的螢幕佈局,使用瀏覽器提供的控制項,而不是本機控制項內。 為此,添加 `webkit-playsinline` 歸咎于任何 `<video>` 的元素。
+    
+        <preference name="AllowInlineMediaPlayback" value="true"/>
+        
+
+*   `BackupWebStorage`(字串,或者 `none` , `local` ,或預設的 `cloud` ): 設置為 `cloud` 允許通過 iCloud 備份到 web 存儲資料。 設置為 `local` ,使得只有本地備份通過 iTunes 同步。 設置為 `none` 防止 web 存儲備份。
+    
+        <preference name="BackupWebStorage" value="local"/>
+        
+
+*   `TopActivityIndicator`(字串,預設值為 `gray` ): 控制指示大量的處理器活動的狀態列中的旋轉的小圖示的外觀。 有效的值為 `whiteLarge` , `white` ,和`gray`.
+    
+        <preference name="TopActivityIndicator" value="white"/>
+        
+
+*   `FadeSplashScreen`(boolean 類型的值,預設值為 `true` ): 設置為 `false` 以防止褪色和縮小其顯示狀態發生更改時初始螢幕。
+    
+        <preference name="FadeSplashScreen" value="false"/>
+        
+
+*   `FadeSplashScreenDuration`(浮動,預設值為 `2` ): 指定的初始螢幕的秒數淡出效果來執行。
+    
+        <preference name="FadeSplashScreenDuration" value="4"/>
+        
+
+*   `ShowSplashScreenSpinner`(boolean 類型的值,預設值為 `true` ): 設置為 `false` 隱藏初始螢幕微調框。
+    
+        <preference name="ShowSplashScreenSpinner" value="false"/>
+        
+
+*   `KeyboardDisplayRequiresUserAction`(boolean 類型的值,預設值為 `true` ): 設置為 `false` ,允許鍵盤出現在調用時 `focus()` 形式投入。
+    
+        <preference name="KeyboardDisplayRequiresUserAction" value="false"/>
+        
+
+*   `SuppressesIncrementalRendering`(boolean 類型的值,預設值為 `false` ): 設置為 `true` 等待,直到在呈現到螢幕之前已收到的所有內容。
+    
+        <preference name="SuppressesIncrementalRendering" value="true"/>
+        
+
+*   `KeyboardShrinksView`(boolean 類型的值,預設值為 `false` ): 設置為 `true` 規模 web 視圖,當鍵盤出現時,重寫預設 beavior,沿垂直方向縮小視區。 這與匹配 Android 應用程式的預設的行為。
+    
+        <preference name="KeyboardShrinksView" value="true"/>
+        
+
+*   `GapBetweenPages`(浮動,預設值為 `` ): 的大小,以磅為單位,頁面之間的差距。
+    
+        < 首選項名稱 = 值"GapBetweenPages"="0"/ >
+        
+
+*   `PageLength`(浮動,預設值為 `` ): 中點,在頁面流的方向每個頁面的大小。 當 PaginationMode 是從右至左或從左至右,此屬性工作表示每個頁面的寬度。 PaginationMode topToBottom 或 bottomToTop 時,此屬性工作表示每個頁面的高度。 預設值為 0,這意味著佈局使用視區的大小來確定頁面的尺寸。
+    
+        < 首選項名稱 = 值"PageLength"="0"/ >
+        
+
+*   `PaginationBreakingMode`(字串,預設值為 `page` ): 有效的值為 `page` 和 `column` 。在列或頁斷發生的方式。 此屬性確定是否某些 CSS 屬性關於列和頁打破是榮幸還是忽略。 當此屬性設置為 `column` ,內容尊重相關的頁斷的地方斷列的 CSS 屬性。
+    
+        < 首選項名稱 = 值"PaginationBreakingMode"="第頁"/ >
+        
+
+*   `PaginationMode`(字串,預設值為 `unpaginated` ): 有效的值為 `unpaginated` , `leftToRight` , `topToBottom` , `bottomToTop` ,和 `rightToLeft` 。 此屬性確定是否在 web 視圖中的內容劃分為一次填充視圖一螢幕的頁或一個長的滾動視圖所示。 如果設置為一個分頁的表單,此屬性切換分頁的佈局上的內容,導致其內容的 web 視圖使用重新佈局的 PageLength 和 GapBetweenPages 的值。
+    
+        < 首選項名稱 = 值"PaginationMode"="分頁"/ >
\ 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/ios/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/ios/index.md b/www/docs/zh-cn/3.1.0/guide/platforms/ios/index.md
new file mode 100644
index 0000000..b438aab
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/guide/platforms/ios/index.md
@@ -0,0 +1,171 @@
+---
+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: iOS 平臺指南
+---
+
+# iOS 平臺指南
+
+本指南介紹如何設置您的 SDK 開發環境部署科爾多瓦的 iOS [設備](../../../cordova/device/device.html) (如 iPhone 和 iPad 的應用程式。請參閱下列特定于平臺的詳細資訊:
+
+*   [iOS 配置](config.html)
+*   [升級 iOS](upgrading.html)
+*   [WebViews iOS](webview.html)
+*   [iOS 外掛程式](plugin.html)
+*   [iOS 命令列工具](tools.html)
+
+上面的命令列工具請參閱科爾多瓦 3.0 以前的版本。關於當前介面的資訊,請參閱命令列介面。
+
+## 要求和支援
+
+蘋果公司 ® 生成僅在基於英特爾的 Mac OS X 作業系統上運行的 iOS 應用程式所需的工具。 僅在 OS X 10.7 (獅子) 版本上運行 Xcode ® 4.5 (要求的最低版本) 或更大,並包括 iOS 6 SDK (軟體發展工具組)。 要提交到蘋果 App Store℠ 的應用程式需要的蘋果工具的最新版本。
+
+您可以測試的許多科爾多瓦功能使用 iOS 模擬器安裝 ios SDK 和 Xcode,但你需要使用實際的設備完全提交到 App Store 之前測試的所有應用程式的裝置功能。 該設備必須至少有 iOS 5.x 安裝、 科爾多瓦 2.3 支援的最低限度的 iOS 版本。配套設備包括所有 iPad ® 模型、 iPhone ® 3GS 及以上,和 iPod ® 觸摸第三代或更高版本。 要安裝到設備上的應用程式,您必須也是蘋果公司的[iOS 開發者計畫][1],該費用每 99 年美元的成員。 本指南演示如何將應用程式部署到 iOS 模擬器,不必註冊開發者計畫。
+
+ [1]: https://developer.apple.com/programs/ios/
+
+## 安裝 SDK
+
+有兩種方法可以下載 Xcode:
+
+*   從[應用程式商店][2],可通過搜索"Xcode"在**App Store**中的應用。
+
+*   從[蘋果開發者下載][3],而作為蘋果開發者需要註冊。
+
+ [2]: https://itunes.apple.com/us/app/xcode/id497799835?mt=12
+ [3]: https://developer.apple.com/downloads/index.action
+
+一旦安裝了 Xcode,幾個命令列工具需要為科爾多瓦運行啟用。 從**Xcode**功能表中,選擇**首選項**,然後**下載**選項卡。 從**元件**面板中,按**命令列工具**清單旁邊的**安裝**按鈕。
+
+## 在 SDK 中打開的專案
+
+使用 `cordova` 實用程式設置了一個新的專案,如所述在科爾多瓦命令列介面。例如,在原始程式碼中的目錄:
+
+        $ cordova create hello com.example.hello "HelloWorld"
+        $ cd hello
+        $ cordova platform add ios
+        $ cordova prepare              # or "cordova build"
+    
+
+創建後,您可以在 Xcode 內打開它從。按兩下打開 `hello/platforms/ios/hello.xcodeproj` 檔。螢幕應該如下所示:
+
+![][4]
+
+ [4]: {{ site.baseurl }}/static/img/guide/platforms/ios/helloworld_project.png
+
+## 部署到模擬程式
+
+若要預覽 iOS 模擬器中的應用程式:
+
+1.  請確保在左邊的面板中選擇*.xcodeproj*檔。
+
+2.  選擇**你好**app 立即向右面板中。
+
+3.  從工具列上的**計畫**功能表中選擇預定的設備、 iPhone 等作為 6.0 模擬器在這裡突出了:
+    
+    ![][5]
+
+4.  按下**運行**按鈕出現在同一工具列左側的**計畫**中。 那生成、 部署並在模擬器中運行應用程式。 一個單獨的模擬器應用程式將打開,並顯示該應用程式:
+    
+    ![][6]
+    
+    只有一個模擬程式可能會運行一次,所以如果你想要在不同的模擬器中測試應用程式,您需要退出的模擬程式應用程式和運行一個不同的目標在 Xcode 的範圍內。
+
+ [5]: {{ site.baseurl }}/static/img/guide/platforms/ios/select_xcode_scheme.png
+ [6]: {{ site.baseurl }}/static/img/guide/platforms/ios/HelloWorldStandard.png
+
+Xcode 捆綁了模擬器為最新版本的 iPhone 和 iPad。 較舊的版本中可能會提供**Xcode → 首選項 → 下載 → 元件**面板。
+
+## 將部署到設備
+
+有關各項要求,部署到一個設備的詳細資訊,請參閱蘋果的[iOS 工具工作流指南][7]的*配置開發和分配資產*部分。 簡單地說,您需要部署之前執行以下操作:
+
+ [7]: http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959
+
+1.  加入蘋果 iOS 開發者計畫。
+
+2.  創建*資源調配設定檔*內[iOS 資源調配門戶][8]。 您可以使用其*發展資源調配助理*來創建和安裝設定檔和證書 Xcode 需要。
+
+3.  驗證*代碼簽名*部分*代碼簽名標識*內的專案設置設置為您設置的設定檔名稱。
+
+ [8]: https://developer.apple.com/ios/manage/overview/index.action
+
+若要部署到設備:
+
+1.  使用 USB 電纜將設備插入到您的 mac。
+
+2.  Xcode 視窗**計畫**下拉清單中選擇的專案的名稱。
+
+3.  從**設備**下拉清單中選擇您的設備。如果它通過 USB 連接電源,但仍然沒有出現,請按**管理器**按鈕,以解決任何錯誤。
+
+4.  按下**運行**按鈕以生成、 部署並運行該應用程式在您的設備上。
+
+## 常見的問題
+
+**否決警告:**當應用程式更改或替換為另一個 API 程式設計介面 (API) 時,它被標記為*已過時*。 API 仍可工作,短期內,但最終將被刪除。 這些過時的介面的一些反映在 Apache 科爾多瓦和 Xcode 問題對他們的警告您在生成和部署應用程式時。
+
+Xcode 的警告 `invokeString` 方法涉及啟動一個應用程式從一個自訂 URL 的功能。 雖然從自訂 URL 載入的機制發生了變化,此代碼目前仍在繼續為科爾多瓦的較早版本創建的應用程式提供向後的功能。 應用程式範例不使用這一功能,因此可以忽略這些警告。 若要防止出現這些警告,請刪除引用已棄用的 invokeString API 的代碼:
+
+*   編輯*Classes/MainViewController.m*檔、 環繞的代碼與下面的塊 `/*` 和 `*/` 的評論如下所示,然後鍵入**命令-s**保存該檔:
+    
+        (失效) webViewDidFinishLoad:(UIWebView*) theWebView {/ / 如果 ___PROJECTNAME__ Info.plist 指定協定來處理的唯一有效 / * 如果 (self.invokeString) {/ / 這傳遞之前觸發 deviceready 事件,以便您可以訪問它的 js 時您會收到 deviceready NSLog (@"已否決: window.invokeString-相反,使用 window.handleOpenURL(url) 函數,總是調用通過自訂方案 url 啟動應用程式時.") ;NSString * jsString = [NSString stringWithFormat:@"var invokeString = \"%@\";"self.invokeString] ;[theWebView stringByEvaluatingJavaScriptFromString:jsString] ;} * / / / 黑色底彩色背景匹配的本機應用程式 theWebView.backgroundColor = [UIColor blackColor] ;返回 [超級 webViewDidFinishLoad: theWebView] ;}
+        
+
+*   編輯*Classes/AppViewDelegate.m*檔,注釋掉下面的行插入雙斜杠,如下所示,然後鍵入**命令-s**保存該檔:
+    
+        //self.viewController.invokeString = invokeString ;
+        
+
+*   按**命令-b**重新生成專案並消除此警告。
+
+<!-- Does this fix only last until the next "cordova prepare"? -->
+
+**缺少標題**: 編譯錯誤有關的失蹤頭導致從生成位置的問題,可以通過 Xcode 偏好固定:
+
+1.  選擇**Xcode → 首選項 → 位置**.
+
+2.  在**派生的資料**部分中,按**高級**按鈕並選擇**唯一**作為**生成位置**如下所示:
+    
+    ![][9]
+
+ [9]: {{ site.baseurl }}/static/img/guide/platforms/ios/xcode_build_location.png
+
+這是預設設置為一個新的 Xcode 安裝,但也可以設置以不同的方式從較早版本的 Xcode 後升級。
+
+進一步的資訊,請參考蘋果的文檔:
+
+*   [開始開發 iOS 應用程式今天][10]快速概述的步驟開發 iOS 的應用程式。
+
+*   [會員中心主頁][11]提供幾個 iOS 的連結技術資源包括技術資源,資源調配門戶、 分佈指南和社區論壇。
+
+*   [IOS 工具工作流指南][7]
+
+*   [Xcode 4 使用者指南][12]
+
+*   從蘋果世界廣泛開發人員會議 (WWDC2012) 2012年[屆會議視頻][13]
+
+*   安裝[xcode 選擇命令][14],它有助於指定正確版本的 Xcode,如果不止一個的話。
+
+ [10]: http://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/index.html#//apple_ref/doc/uid/TP40011343
+ [11]: https://developer.apple.com/membercenter/index.action
+ [12]: http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/000-About_Xcode/about.html#//apple_ref/doc/uid/TP40010215
+ [13]: https://developer.apple.com/videos/wwdc/2012/
+ [14]: http://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/xcode-select.1.html
+
+(Mac ®,OS X ®,蘋果公司 ®,Xcode ® 應用程式 Store℠,iPad ®,iPhone ®,iPod ® 和 Finder ® 是蘋果公司商標)

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/guide/platforms/ios/plugin.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/ios/plugin.md b/www/docs/zh-cn/3.1.0/guide/platforms/ios/plugin.md
new file mode 100644
index 0000000..83f5be2
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/guide/platforms/ios/plugin.md
@@ -0,0 +1,202 @@
+---
+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: iOS 外掛程式
+---
+
+# iOS 外掛程式
+
+外掛程式是一個擴展的目標 C 類 `CDVPlugin` 類。
+
+每個外掛程式類必須註冊為 `<feature>` 中標籤的 `config.xml` 檔。 正是通過這一機制的 JavaScript `exec` 方法的 `service` 參數將映射到目標 C 類。
+
+## 外掛程式類映射
+
+一個外掛程式的 JavaScript 部分始終使用 `cordova.exec` 方法,如下所示:
+
+    exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
+    
+
+這封送一個請求從 `UIWebView` 到 iOS 本機側,更或較不沸騰到調用 `action` 方法 `service` 類,傳入的參數中的 `args` 陣列。
+
+指定外掛程式作為 `<feature>` 在科爾多瓦 iOS 應用程式專案中的標記 `config.xml` 檔。
+
+    <feature name="LocalStorage">
+        <param name="ios-package" value="CDVLocalStorage" />
+    </feature>
+    
+
+功能 `name` 屬性應匹配您在 JavaScript 中使用 `exec` 調用的 `service` 參數,和 `value` 屬性應與外掛程式的目標 C 類的名稱相匹配。 `<param name>`應始終是我 `"ios-package"` 。 如果不遵循此安裝程式,該外掛程式可能編譯,但不是會到達科爾多瓦。
+
+## 外掛程式初始化和存留期
+
+外掛程式物件的一個實例創建為生活的每個 `UIWebView` 。 外掛程式不會具現化之前他們第一次引用通過調用從 JavaScript,除非 `<param>` 與 `onload` `name` 屬性設置為 `"true"` 的 `config.xml` 。 例如:
+
+    <feature name="Echo">
+        <param name="ios-package" value="Echo" />
+        <param name="onload" value="true" />
+    </feature>
+    
+
+有*沒有*指定外掛程式的初始值設定項。相反,應使用外掛程式 `pluginInitialize` 他們開辦的邏輯方法。
+
+長時間運行的請求,外掛程式背景活動 (例如,播放的媒體),聽眾或內部狀態應執行 `onReset` 方法和停止或清理這些活動。 這種方法運行時 `UIWebView` 定位到新的一頁或刷新,重新載入 JavaScript。
+
+## 寫作 iOS 科爾多瓦外掛程式
+
+我們有外掛程式請求到本機端 JavaScript 起火燃燒。 我們有通過正確映射的目標 C 的 iOS 外掛程式 `config.xml` 檔。 所以最後的 iOS 目標 C 外掛程式類長什麼樣子?
+
+什麼獲取調度到該外掛程式通過 JavaScript 的 `exec` 函數獲取傳遞到相應的外掛程式類的 `action` 方法。外掛程式的方法有此簽名:
+
+    - (void)myMethod:(CDVInvokedUrlCommand*)command
+    {
+        CDVPluginResult* pluginResult = nil;
+        NSString* myarg = [command.arguments objectAtIndex:0];
+    
+        if (myarg != nil) {
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+        } else {
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg was null"];
+        }
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+    }
+    
+
+1.  [CDVInvokedUrlCommand.h][1]
+
+2.  [CDVPluginResult.h][2]
+
+3.  [CDVCommandDelegate.h][3]
+
+ [1]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVInvokedUrlCommand.h
+ [2]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPluginResult.h
+ [3]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVCommandDelegate.h
+
+## iOS CDVPluginResult 訊息類型
+
+使用 CDVPluginResult 可以返回結果類型的各種回您的 JavaScript 回呼函數,使用看起來像的類方法:
+
+    + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...
+    
+
+您可以創建 `String` , `Int` , `Double` , `Bool` , `Array` , `Dictionary` , `ArrayBuffer` ,和 `Multipart` 類型。 或者,不附加任何參數 (只是發送狀態)。 或者,返回一個錯誤。 你甚至可以選擇不發送任何外掛程式的結果,在這種情況下不會觸發回檔。
+
+### 備註
+
+*   `messageAsArrayBuffer`預計 `NSData*` 並將轉換為 `ArrayBuffer` 為您的 JavaScript 回檔 (和 `ArrayBuffers` 從 JavaScript 發送到一個外掛程式都將轉換為`NSData*`).
+*   `messageAsMultipart` 預計 `NSArray *` 包含任何其他支援類型,並將整個陣列作為發送 `參數` 給您的 JavaScript 回檔。 
+    *   怪癖: 這不是只是語法糖 (儘管它是甜的)。 這種方式,所有參數序列化或反序列化,必要時。 例如,它是能夠安全返回 `NSData*` 作為多部分,但不是 `Array` /`Dictionary`.
+
+## Echo 外掛程式 iOS 外掛程式
+
+我們會將以下內容添加到該專案的 `config.xml` 檔:
+
+    <feature name="Echo">
+        <param name="ios-package" value="Echo" />
+    </feature>
+    
+
+然後我們將添加下列檔 ( `Echo.h` 和 `Echo.m` ) 到我們科爾多瓦 iOS 應用程式目錄裡面的外掛程式目錄:
+
+    /********* Echo.h Cordova Plugin Header *******/
+    
+    #import <Cordova/CDV.h>
+    
+    @interface Echo : CDVPlugin
+    
+    - (void)echo:(CDVInvokedUrlCommand*)command;
+    
+    @end
+    
+    /********* Echo.m Cordova Plugin Implementation *******/
+    
+    #import "Echo.h"
+    #import <Cordova/CDV.h>
+    
+    @implementation Echo
+    
+    - (void)echo:(CDVInvokedUrlCommand*)command
+    {
+        CDVPluginResult* pluginResult = nil;
+        NSString* echo = [command.arguments objectAtIndex:0];
+    
+        if (echo != nil && [echo length] > 0) {
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
+        } else {
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
+        }
+    
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+    }
+    
+    @end
+    
+
+讓我們看看代碼。在頂部,我們有所有必要的科爾多瓦進口。我們班延伸從 `CDVPlugin` (非常重要)。
+
+此外掛程式只支援一個操作, `echo` 的行動。 第一,我們抓住 echo 字串使用 `objectAtIndex` 方法上的我們 `args` ,告訴它我們想要獲取的參數陣列中的第十的參數。 我們做一些參數檢查: 請確保它不是 `nil` ,並確保它不是一個零長度的字串。
+
+如果是,我們返回 `PluginResult` 與 `ERROR` 狀態。 如果所有這些檢查通過,然後我們將返回 `PluginResult` 與 `OK` 狀態,並通過在 `echo` 我們收到了在第一位作為參數的字串。
+
+最後,我們發送結果到 `self.commandDelegate` ,其中執行 `exec` 方法的成功或失敗回檔 JavaScript 一邊。 如果成功回檔被調用,它將通過在 `echo` 參數。
+
+## 執行緒
+
+在相同的 UI 執行緒中執行的外掛程式方法。如果你的外掛程式需要大量的處理,或者需要一個阻塞調用,則應使用後臺執行緒。例如:
+
+    - (void)myPluginMethod:(CDVInvokedUrlCommand*)command
+    {
+        // Check command.arguments here.
+        [self.commandDelegate runInBackground:^{
+            NSString* payload = nil;
+            // Some blocking logic...
+            CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
+            // The sendPluginResult method is thread-safe.
+            [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+        }];
+    }
+    
+
+## 高級的外掛程式功能
+
+請參閱其他方法時,您可以在重寫:
+
+*   [CDVPlugin.h][4]
+
+*   [CDVPlugin.m][5]
+
+ [4]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.h
+ [5]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.m
+
+例如,你可以掛接到 `pause` , `resume` ,應用程式終止和 `handleOpenURL` 事件。
+
+## 調試外掛程式
+
+若要調試的目標 C 側,您將使用 Xcode 的內置調試器。 對於 JavaScript,在 iOS 5.0 可以使用[Weinre、 Apache 科爾多瓦專案][6]或[iWebInspector、 一個協力廠商實用程式][7]
+
+ [6]: https://github.com/apache/cordova-weinre
+ [7]: http://www.iwebinspector.com/
+
+Ios 6,您將使用 Safari 6.0 將簡單地附加到您的應用程式運行在 iOS 6 模擬器。
+
+## 常見的陷阱
+
+*   別忘了向 config.xml 添加您的腳本映射。如果你忘記了,是在 Xcode 主控台中記錄錯誤。
+
+*   別忘了添加任何主機,您在白名單中,連接到域白名單指南中所述。如果你忘記了,是在 Xcode 主控台中記錄錯誤。
\ 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/ios/tools.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/ios/tools.md b/www/docs/zh-cn/3.1.0/guide/platforms/ios/tools.md
new file mode 100644
index 0000000..603bbd3
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/guide/platforms/ios/tools.md
@@ -0,0 +1,55 @@
+---
+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: iOS 命令列工具
+---
+
+# iOS 命令列工具
+
+`cordova`命令列實用程式是一個高級別的工具,允許您在一次跨幾個平臺生成的應用程式。 舊版本的科爾多瓦框架提供了特定于每個平臺的命令列工具集。 若要使用它們作為 CLI 的替代,您需要從[cordova.apache.org][1]下載此版本的科爾多瓦。 下載檔案中包含單獨的檔案,為每個平臺。 展開您想要的目標平臺。 這裡描述的工具,通常可用在頂級 `bin` 目錄中,否則為諮詢**自述**檔,瞭解有關更多詳細的指示。
+
+ [1]: http://cordova.apache.org
+
+IOS 命令列工具都建立在 shell 腳本和依賴于 Xcode 命令列工具如 `xcode-select` 和`xcodebuild`.
+
+## 創建一個專案
+
+運行 `create` 命令,指定的現有路徑的專案、 反向域式包識別碼和應用程式的顯示名稱。
+
+    $ ./path/to/cordova-ios/bin/create /path/to/my_new_project com.example.project_name ProjectName
+    
+
+## 生成專案
+
+    $ /path/to/my_new_project/cordova/build
+    
+
+## 在模擬器上運行的應用程式
+
+    $ /path/to/my_new_project/cordova/run
+    
+
+## 釋放
+
+    $ /path/to/my_new_project/cordova/release
+    
+
+## 日誌記錄
+
+    $ /path/to/my_new_project/cordova/log
\ 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