You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ld...@apache.org on 2014/05/28 19:40:08 UTC

[07/53] [abbrv] Lisa testing pulling in plugins for plugin: cordova-docs

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/513a1fa1/docs/zh/edge/guide/platforms/ios/upgrade.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/ios/upgrade.md b/docs/zh/edge/guide/platforms/ios/upgrade.md
new file mode 100644
index 0000000..d391940
--- /dev/null
+++ b/docs/zh/edge/guide/platforms/ios/upgrade.md
@@ -0,0 +1,770 @@
+---
+
+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.
+---
+
+# 升級 iOS
+
+本指南演示如何修改 iOS 專案從科爾多瓦的舊版本進行升級。 大多數這些說明適用于與舊集的前面的命令列工具創建的專案 `cordova` CLI 實用程式。 資訊,請參閱命令列介面如何更新的 CLI 版本。
+
+**注**: Xcode 5 是必需的。 目前,以提交到蘋果 App Store,應使用最新的產品出廠的 iOS SDK,是 iOS 7 版本,這是只包括在 Xcode 5。
+
+## 升級 3.3.0 專案到 3.4.0
+
+對於非 CLI 的專案,請運行:
+
+        bin/更新路徑/到專案
+    
+
+CLI 的專案:
+
+1.  更新 `cordova` CLI 版本。請參閱命令列介面。
+
+2.  運行`cordova platform update ios`
+
+## 升級 3.2.0 專案到 3.3.0
+
+對於非 CLI 的專案,請運行:
+
+        bin/更新路徑/到專案
+    
+
+CLI 的專案:
+
+1.  更新 `cordova` CLI 版本。請參閱命令列介面。
+
+2.  運行`cordova platform update ios`
+
+## 升級 3.1.0 專案到 3.2.0
+
+對於非 CLI 的專案,請運行:
+
+        bin/更新路徑/到專案
+    
+
+CLI 的專案:
+
+1.  更新 `cordova` CLI 版本。請參閱命令列介面。
+
+2.  運行`cordova platform update ios`
+
+## 升級 3.0.0 專案到 3.1.0
+
+對於非 CLI 的專案,請運行:
+
+        bin/更新路徑/到專案
+    
+
+CLI 的專案:
+
+1.  更新 `cordova` CLI 版本。請參閱命令列介面。
+
+2.  運行`cordova platform update ios`
+
+iOS 7 的問題:
+
+1.  刪除 `width=device-width, height=device-height` 從 `index.html` 檔的 `viewport` `meta` 標記。 (請參見[相關的 bug][1].)
+
+2.  更新你的 iOS 7 支援的媒體、 媒體捕獲和閃屏核心外掛程式。
+
+ [1]: https://issues.apache.org/jira/browse/CB-4323
+
+Xcode 5 的問題:
+
+1.  如果 Xcode 5 提示您這樣做 (在問題導航器),請更新您的專案設置。
+
+2.  更新您**編譯器的 C / C + + / 目標 C**根據**生成設置**選項卡,設置**生成選項**一節。 選擇**預設編譯器 (蘋果 LLVM 5.0)**.
+
+## 從 2.9.0 升級到 CLI (3.0.0)
+
+1.  創建新的 Apache 科爾多瓦 3.0.0 專案使用 CLI,科爾多瓦,如所述的命令列介面。
+
+2.  添加您的平臺到科爾多瓦專案中,例如:`cordova
+platform add ios`.
+
+3.  該專案的內容複寫 `www` 目錄到 `www` 目錄在您剛剛創建的科爾多瓦專案的根目錄。
+
+4.  複製或覆蓋任何本機資產從原始專案 ( `Resources` 等),這讓肯定要添加任何新檔到 `.xcodeproj` 專案。 IOS 專案內生成 `platforms\ios` 目錄。
+
+5.  複製 `config.xml` 到 `www` 目錄中,並刪除任何外掛程式定義。修改設置在這裡而不是平臺目錄。
+
+6.  使用科爾多瓦 CLI 工具來安裝您需要的任何外掛程式。請注意 CLI 處理所有核心 Api 作為外掛程式,所以他們可能需要添加。只有 3.0.0 外掛程式是與 CLI 相容。
+
+7.  生成並測試。
+
+## 升級 2.9.0 專案到 3.0.0
+
+1.  下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 3.0.0 源,例如到`~/Documents/Cordova-3.0.0`.
+
+2.  如果它正在運行,請退出 Xcode。
+
+3.  使用終端程式,定位到你放在上面的下載的源的目錄。
+
+4.  創建一個新專案,如 iOS 殼工具指南中所述。您需要從這個新的專案資產。
+
+5.  複製 `www/cordova.js` (注意它再也沒有一個版本尾碼,該版本是在該檔本身在標題中) 到新專案中的檔 `www` 目錄中,並刪除 `www/cordova.js` 檔。
+
+6.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova.js` 檔。
+
+7.  刪除 `CordovaLib` 目錄和副本 `CordovaLib` 目錄從新專案到專案的根目錄。
+
+**注意**: 從開始科爾多瓦 3.0.0,不預先安裝外掛程式,和你需要使用 `plugman` 命令列實用程式來安裝它們自己。 請參閱使用 Plugman 管理外掛程式。
+
+## 升級 2.8.0 專案到 2.9.0
+
+1.  下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 2.9.0 源,例如到`~/Documents/Cordova-2.9.0`.
+
+2.  如果它正在運行,請退出 Xcode。
+
+3.  使用終端程式,定位到你放在上面的下載的源的目錄。
+
+4.  創建一個新專案,如 iOS 殼工具指南中所述。您需要從這個新的專案資產。
+
+5.  複製 `www/cordova.js` (注意它再也沒有一個版本尾碼,該版本是在該檔本身在標題中) 到新專案中的檔 `www` 目錄中,並刪除 `www/cordova.js` 檔。
+
+6.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova.js` 檔。
+
+7.  刪除 `CordovaLib` 目錄和副本 `CordovaLib` 目錄從新專案到專案的根目錄。
+
+## 升級 2.7.0 專案到 2.8.0
+
+1.  下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 2.8.0 源,例如到`~/Documents/Cordova-2.8.0`.
+
+2.  如果它正在運行,請退出 Xcode。
+
+3.  使用終端程式,定位到你放在上面的下載的源的目錄。
+
+4.  創建一個新專案,如 iOS 殼工具指南中所述。您需要從這個新的專案資產。
+
+5.  複製 `www/cordova.js` (注意它再也沒有一個版本尾碼,該版本是在該檔本身在標題中) 到新專案中的檔 `www` 目錄中,並刪除 `www/cordova-2.7.0.js` 檔。
+
+6.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova.js` 檔。
+
+7.  更新任何 `<plugin>` 標籤在 `config.xml` 檔到 `<feature>` 標籤。 注意,現有 `<plugin>` 標籤仍正常工作,但都被否決了。 您可以複製此資訊在 `config.xml` 檔的一個新的專案。 例如:
+    
+        <plugins>
+            <plugin name="LocalStorage" value="CDVLocalStorage" />
+            <!-- other plugins -->
+        </plugins>
+        
+        <!-- change to: (note that a <feature> tag is on the same level as <plugins> -->
+        <feature name="LocalStorage">
+            <param name="ios-package" value="CDVLocalStorage" />
+        </feature>
+        <!-- other <feature> tags -->
+        
+
+8.  刪除 `CordovaLib` 目錄和副本 `CordovaLib` 目錄從新專案到專案的根目錄。
+
+9.  將這兩個框架添加到您的專案:
+    
+        OpenAL ImageIO
+        
+
+10. 更新您的專案目標**生成設置**。編輯**"-Obj-C"**要下**連結 → 其他連結器標誌**, **"-ObjC"**.
+
+11. 更新您的專案目標**生成設置**。 在**連結 → 其他連結器標誌**,更改**"-all_load"**是 `-force\_load ${BUILT\_PRODUCTS\_DIR}/libCordova.a` 。 你只需要這樣做,如果你有在中定義的問題[這一問題。][2].
+
+ [2]: https://issues.apache.org/jira/browse/CB-3458
+
+## 升級 2.6.0 專案到 2.7.0
+
+1.  下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 2.7.0 源,例如到`~/Documents/Cordova-2.7.0`.
+
+2.  如果它正在運行,請退出 Xcode。
+
+3.  使用終端程式,定位到你放在上面的下載的源的目錄。
+
+4.  創建一個新專案,如 iOS 殼工具指南中所述。您需要從這個新的專案資產。
+
+5.  複製 `www/cordova-2.7.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/cordova-2.6.0.js` 檔。
+
+6.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova-2.7.0.js` 檔。
+
+7.  更新 (或替換,如果您從未更改檔) `AppDelegate.m` 檔根據您從新專案 (見[此比較][3]).
+
+8.  在 `config.xml` 檔,[刪除這條線][4].
+
+9.  刪除 `CordovaLib` 目錄和副本 `CordovaLib` 目錄從新專案到專案的根目錄。
+
+ [3]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=5c05ac80e056753c0e8736f887ba9f28d5b0774c;hp=623ad8ec3c46f656ea18c6c3a190d650dd64e479;hb=c6e71147386d4ad94b07428952d1aae0a9cbf3f5;hpb=c017fda8af00375a453cf27cfc488647972e9a23
+ [4]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=537705d76a5ef6bc5e57a8ebfcab78c02bb4110b;hp=8889726d9a8f8c530fe1371c56d858c34552992a;hb=064239b7b5fa9a867144cf1ee8b2fb798ce1f988;hpb=c9f233250d4b800f3412eeded811daaafb17b2cc
+
+## 升級 2.5.0 專案到 2.6.0
+
+1.  下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 2.6.0 源,例如到`~/Documents/Cordova-2.6.0`.
+
+2.  如果它正在運行,請退出 Xcode。
+
+3.  使用終端程式,定位到你放在上面的下載的源的目錄。
+
+4.  創建一個新專案,如 iOS 殼工具指南中所述。您需要從這個新的專案資產。
+
+5.  複製專案的 `www/cordova-2.6.0.js` 檔到 `www` 目錄中,並刪除 `www/cordova-2.5.0.js` 檔。
+
+6.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及引用的腳本的任何其他檔) 來引用到新的 `cordova-2.6.0.js` 檔。
+
+7.  更新 (或替換,如果您從未更改檔) `AppDelegate.m` 檔根據您從新專案 (見[此比較][5]).
+
+8.  在 `config.xml` 檔中,[添加此新行][6].
+
+9.  在 `config.xml` 檔中,[添加此新行][7].
+
+10. 在 `config.xml` 檔, [UIWebViewBounce 已改為 DisallowOverscroll,和預設值都不同][8].
+
+11. 在 `config.xml` 檔中, `EnableLocation` 首選項已被否決。
+
+12. 刪除 `CordovaLib` 目錄和副本 `CordovaLib` 目錄從新專案到專案的根目錄。
+
+ [5]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=124a56bb4f361e95616f44d6d6f5a96ffa439b60;hp=318f79326176be8f16ebc93bad85dd745f4205b6;hb=a28c7712810a63396e9f32fa4eb94fe3f8b93985;hpb=36acdf55e4cab52802d73764c8a4b5b42cf18ef9
+ [6]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=1555b5e81de326a07efe0bccaa5f5e2326b07a9a;hp=0652d60f8d35ac13c825c572dca6ed01fea4a540;hb=95f16a6dc252db0299b8e2bb53797995b1e39aa1;hpb=a2de90b8f5f5f68bd9520bcbbb9afa3ac409b96d
+ [7]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=d307827b7e67301171a913417fb10003d43ce39d;hp=04260aa9786d6d74ab20a07c86d7e8b34e31968c;hb=97b89edfae3527828c0ca6bb2f6d58d9ded95188;hpb=942d33c8e7174a5766029ea1232ba2e0df745c3f
+ [8]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=8889726d9a8f8c530fe1371c56d858c34552992a;hp=d307827b7e67301171a913417fb10003d43ce39d;hb=57982de638a4dce6ae130a26662591741b065f00;hpb=ec411f18309d577b4debefd9a2f085ba719701d5
+
+## 升級 2.4.0 專案到 2.5.0
+
+1.  下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 2.5.0 源,例如到`~/Documents/Cordova-2.5.0`.
+
+2.  如果它正在運行,請退出 Xcode。
+
+3.  使用終端程式,定位到你放在上面的下載的源的目錄。
+
+4.  創建一個新專案,如 iOS 殼工具指南中所述。您需要從這個新的專案資產。
+
+5.  複製 `www/cordova-2.5.0.js` 到新專案中的檔 `www` 目錄和刪除 `www/cordova-2.4.0.js` 檔。
+
+6.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova-2.5.0.js` 檔。
+
+7.  更新 (或替換,如果您從未更改檔) `AppDelegate.m` 檔根據您從新專案 (見[此比較][9]).
+
+8.  在 `config.xml` 檔中,[添加這些新行][10].
+
+9.  在 `config.xml` 檔中,[編輯的根項目,更改它從科爾多瓦到構件][11].
+
+10. 在 `config.xml` 檔,[刪除 OpenAllWhitelistURLsInWebView 首選項][12].
+
+11. 刪除 `cordova` 目錄和副本 `cordova` 目錄從新專案到專案的根目錄。在 2.5.0,這已更新腳本。
+
+12. 刪除 `CordovaLib` 目錄和副本 `CordovaLib` 目錄從新專案到專案的根目錄。
+
+ [9]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=318f79326176be8f16ebc93bad85dd745f4205b6;hp=6dc7bfc84f0ecede4cc43d2a3256ef7c5383b9fe;hb=4001ae13fcb1fcbe73168327630fbc0ce44703d0;hpb=299a324e8c30065fc4511c1fe59c6515d4842f09
+ [10]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=903944c4b1e58575295c820e154be2f5f09e6314;hp=721c734120b13004a4a543ee25f4287e541f34be;hb=ae467249b4a256bd31ee89aea7a06f4f2316b8ac;hpb=9e39f7ef8096fb15b38121ab0e245a3a958d9cbb
+ [11]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=64e71636f5dd79fa0978a97b9ff5aa3860a493f5;hp=d8579352dfb21c14e5748e09b2cf3f4396450163;hb=0e711f8d09377a7ac10ff6be4ec17d22cdbee88d;hpb=57c3c082ed9be41c0588d0d63a1d2bfcd2ed878c
+ [12]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=721c734120b13004a4a543ee25f4287e541f34be;hp=7d67508b70914aa921a16e79f79c00512502a8b6;hb=187bf21b308551bfb4b98b1a5e11edf04f699791;hpb=03b8854bdf039bcefbe0212db937abd81ac675e4
+
+## 升級 2.3.0 專案到 2.4.0
+
+1.  下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 2.4.0 源,例如到`~/Documents/Cordova-2.4.0`.
+
+2.  如果它正在運行,請退出 Xcode。
+
+3.  使用終端程式,定位到你放在上面的下載的源的目錄。
+
+4.  創建一個新專案,如 iOS 殼工具指南中所述。您需要從這個新的專案資產。
+
+5.  複製 `www/cordova-2.4.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/cordova-2.3.0.js` 檔。
+
+6.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova-2.4.0.js` 檔。
+
+7.  更新 (或替換,如果您從未更改檔) `MainViewController.m` 檔根據您從新專案 (見[此比較][13]).
+
+8.  更新 (或替換,如果您從未更改檔) `AppDelegate.m` 檔根據您從新專案 (見[此比較][14]).
+
+9.  在 `config.xml` 檔中,[添加此新行][15].
+
+10. 刪除 `cordova` 目錄和副本 `cordova` 目錄從新專案到專案的根目錄。在 2.4.0,這已固定的腳本。
+
+11. 刪除 `CordovaLib` 目錄和副本 `CordovaLib` 目錄從新專案到專案的根目錄。
+
+12. AssetsLibrary.framework 作為資源添加到專案中。 (請參見[蘋果的文檔][16]有關如何執行此操作的說明.)。
+
+ [13]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/MainViewController.m;h=5f9eeac15c2437cd02a6eb5835b48374e9b94100;hp=89da1082d06ba5e5d0dffc5b2e75a3a06d5c2aa6;hb=b4a2e4ae0445ba7aec788090dce9b822d67edfd8;hpb=a484850f4610e73c7b20cd429a7794ba829ec997
+ [14]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=6dc7bfc84f0ecede4cc43d2a3256ef7c5383b9fe;hp=1ca3dafeb354c4442b7e149da4f281675aa6b740;hb=6749c17640c5fed8a7d3a0b9cca204b89a855baa;hpb=deabeeb6fcb35bac9360b053c8bf902b45e6de4d
+ [15]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=7d67508b70914aa921a16e79f79c00512502a8b6;hp=337d38da6f40c7432b0bce05aa3281d797eec40a;hb=6749c17640c5fed8a7d3a0b9cca204b89a855baa;hpb=deabeeb6fcb35bac9360b053c8bf902b45e6de4d
+ [16]: https://developer.apple.com/library/ios/#recipes/xcode_help-project_editor/Articles/AddingaLibrarytoaTarget.html
+
+## 升級 2.2.0 專案到 2.3.0
+
+1.  下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 2.3.0 源,例如到`~/Documents/Cordova-2.3.0`.
+
+2.  如果它正在運行,請退出 Xcode。
+
+3.  使用終端程式,定位到你放在上面的下載的源的目錄。
+
+4.  創建一個新專案,如 iOS 殼工具指南中所述。您需要從這個新的專案資產。
+
+5.  複製 `www/cordova-2.3.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/cordova-2.2.0.js` 檔。
+
+6.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova-2.3.0.js` 檔。
+
+7.  更新 (或替換,如果您從未更改檔) `MainViewController.m` 根據新專案中的一個。
+
+8.  刪除 `cordova` 目錄和副本 `cordova` 目錄從新專案到專案的根目錄。2.3.0,在這新的腳本。
+
+9.  刪除 `CordovaLib` 目錄和副本 `CordovaLib` 目錄從新專案到專案的根目錄。
+
+10. 轉換 `Cordova.plist` 檔為 `config.xml` ,通過運行腳本 `bin/cordova\_plist\_to\_config\_xml` 對您的專案檔案。
+
+11. 添加到 InAppBrowser 外掛程式 `config.xml` ,通過添加此標記下的 `<cordova><plugins>` :
+    
+        <plugin name="InAppBrowser" value="CDVInAppBrowser" />
+        
+
+12. 請注意目標 C 外掛程式*不*列入白名單了。 到白名單中您的連接與應用程式白名單中,您需要設置 `User-Agent` 連接到同一個使用者代理作為主要的科爾多瓦 web 視圖的標題。 你可以通過訪問 `userAgent` 關閉主視圖-控制器屬性。 主視圖-控制器 ( `CDVViewController` ) 也有 `URLisAllowed` 為您檢查是否一個 URL 通過白名單中的方法。
+
+13. 設備的 API 更改:
+    
+    *   Ios,device.platform 用於返回 `iPhone` , `iPad` 或 `iPod Touch` ; 現在它返回 (正確)`iOS`.
+    *   對於 iOS,device.name (現已被否決所有平臺) 用於返回使用者的設備的名稱 (例如 Shazron 的 iPhone 5 ′) ;現在它返回用於返回什麼 device.platform: `iPhone` , `iPad` 或`iPod Touch`.
+    *   對於所有平臺,有一個名為 device.model ; 的新屬性這將返回特定的設備模型,如 `iPad2,5` (對於其他平臺,返回用於返回什麼 device.name)。
+
+## 升級 2.1.0 專案到 2.2.0
+
+1.  下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 2.2.0 源,例如到`~/Documents/Cordova-2.2.0`.
+
+2.  如果它正在運行,請退出 Xcode。
+
+3.  使用終端程式,定位到你放在上面的下載的源的目錄。
+
+4.  創建一個新專案,如 iOS 殼工具指南中所述。您需要從這個新的專案資產。
+
+5.  複製 `www/cordova-2.2.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/cordova-2.1.0.js` 檔。
+
+6.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova-2.2.0.js` 檔。
+
+7.  更新 (或替換,如果您從未更改檔) `MainViewController.m` 根據新專案中的一個:
+    
+    *   更新 → viewWillAppear
+
+8.  複製 `cordova` 目錄從新專案到專案的根目錄。在 2.2.0,這有更新的 '模仿' 腳本。
+
+9.  下一步,更新 `CordovaLib` 分專案的引用。 從科爾多瓦 2.1.0 開始,我們 CORDOVALIB Xcode 變數不再使用引用的位置時 `CordovaLib` 駐留,引用現在是絕對檔引用。
+    
+    1.  啟動終端程式
+    2.  轉到您安裝科爾多瓦的位置 (請參見步驟 1)、 在 `bin` 子目錄
+    3.  運行下面的腳本,其中第一個參數是您的專案的路徑 `.xcodeproj` 檔:
+        
+        `update_cordova_subproject path/to/your/project/xcodeproj`
+
+**注**: 在 2.2.0, `bin/create` 腳本中的副本 `CordovaLib` 分專案到您的專案。 要有相同種類的安裝程式,只是複製的權利 `CordovaLib` 到你的專案目錄和更新 `CordovaLib` 分專案 (相對於專案) 在 Xcode 檔檢查器中的位置。
+
+## 升級 2.0.0 專案到 2.1.0
+
+與科爾多瓦 2.1.0, `CordovaLib` 已升級為使用**自動引用計數 (弧)**。 你不需要升級到**弧**要使用 CordovaLib,但是如果你想要升級您的專案使用**弧**,請使用 Xcode 遷移嚮導從功能表中:**編輯 → 重構 → 轉換為目標 C 弧...**,取消選擇 libCordova.a,然後運行嚮導完成。
+
+1.  下載並解壓縮到您的硬碟磁碟機上的永久目錄位置的科爾多瓦 2.1.0 源,例如到`~/Documents/Cordova-2.1.0`.
+
+2.  如果它正在運行,請退出 Xcode。
+
+3.  使用終端程式,定位到你放在上面的下載的源的目錄。
+
+4.  創建一個新專案,如 iOS 殼工具指南中所述。您需要從這個新的專案資產。
+
+5.  複製 `www/cordova-2.1.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/cordova-2.0.0.js` 檔。
+
+6.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova-2.1.0.js` 檔。
+
+7.  更新 (或替換,如果您從未更改檔) `AppDelegate.m` 根據新專案中的一個:
+    
+    *   編輯 → 應用程式: didFinishLaunchingWithOptions:
+    *   添加 → 應用程式: supportedInterfaceOrientationsForWindow:
+
+8.  更新 (或替換,如果您從未更改檔) `MainViewController.m` 根據新專案中的一個:
+    
+    *   添加 → viewWillAppear
+
+9.  複製 `cordova` 目錄從新專案到專案的根目錄。在 2.1.0,這有更新的腳本,支援帶空格的路徑。
+
+10. 刪除 `VERSION` 檔從您的專案參考 (**是在`CordovaLib`).
+
+11. 下一步,更新 `CordovaLib` 分專案的引用。 從科爾多瓦 2.1.0 開始,我們 CORDOVALIB Xcode 變數不再使用引用的位置時 `CordovaLib` 駐留,引用現在是絕對檔引用。
+    
+    1.  啟動終端程式
+    2.  轉到您安裝科爾多瓦的位置 (請參見步驟 1)、 在 `bin` 子目錄
+    3.  運行下面的腳本,其中第一個參數是您的專案的路徑 `.xcodeproj` 檔:
+        
+        `update_cordova_subproject path/to/your/project/xcodeproj`
+
+## 升級 1.9.0 專案到 2.0.0
+
+1.  安裝 2.0.0 科爾多瓦。
+
+2.  創建一個新專案,如 iOS 殼工具指南中所述。您需要從這個新的專案資產。
+
+3.  複製 `www/cordova-2.0.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/cordova-1.9.0.js` 檔。
+
+4.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova-2.0.0.js` 檔。
+
+5.  複製 `cordova` 目錄從新專案到專案的根目錄 (如果你想要的專案的命令列工具)。
+
+6.  添加一個新條目下的 `Plugins` 在 `Cordova.plist` 下**支援檔**組的檔。 關鍵是 `Device` 和值是`CDVDevice`.
+
+7.  刪除`Cordova.framework`.
+
+8.  刪除 `verify.sh` 從**支援檔**組。
+
+9.  在專案導航器中選擇專案圖示,選擇您的專案**目標**,然後選擇**生成設置**選項卡。
+
+10. 搜索**預處理器宏**,然後刪除所有**CORDOVA_FRAMEWORK = 1**值。
+
+11. 找到 `CordovaLib` 安裝在您的硬碟-上根據您的個人資料夾中的目錄 `Documents` 子目錄。
+
+12. 找到 `CordovaLib.xcodeproj` 檔在 `CordovaLib` 目錄中,然後拖放到您的專案檔案。它應顯示作為子專案。
+
+13. 構建您的專案,你應該與有關的一些錯誤 `#import` 指令。
+
+14. 為 `#import` 的錯誤,改變這種風格在任何基於報價進口:
+    
+        #import"CDV.h"
+        
+    
+    為此基於方括弧中的樣式:
+    
+        #import < Cordova/CDV.h >
+        
+    
+    和刪除任何 `#ifdef` 任何科爾多瓦的包裝進口,他們再也不需要 (現在統一進口)
+
+15. 再次,生成您的專案和它不應具有任何 `#import` 的錯誤。
+
+16. 在專案導航器中選擇**專案圖示**,選擇您的專案**目標**,然後選擇**生成階段**選項卡。
+
+17. 展開**目標依賴項**階段,然後選擇**+**按鈕。
+
+18. 選擇 `CordovaLib` 的目標,然後選擇**添加**按鈕。
+
+19. 展開**連結二進位與圖書館**的第一階段,(它應該已經包含框架的一群),然後選擇**+**按鈕。
+
+20. 選擇 `libCordova.a` 靜態程式庫,然後選擇**添加**按鈕。
+
+21. 刪除**運行腳本**階段。
+
+22. 在專案導航器中選擇**專案圖示**,選擇您的專案**目標**,然後選擇**生成設置**選項卡。
+
+23. 搜索**其他的連結器標誌**,並添加相應的值**-force_load**和**-Obj C**.
+
+24. 擴大 `CordovaLib` 子專案。
+
+25. 找到 `VERSION` 檔,將它拖動到您 (我們想要創建一個連結到它,不是副本) 的主專案。
+
+26. 選擇**創建組的任何添加的資料夾**選項按鈕,然後選擇**完成**按鈕。
+
+27. 選擇 `VERSION` 檔,你只是被拖上一步中。
+
+28. 鍵入**選項-命令-1**鍵的組合,以顯示**檔檢查器**(或功能表項目**查看 → 實用程式 → 顯示檔檢查器**).
+
+29. 選擇**相對於 CORDOVALIB** **檔檢查器**器下拉式功能表中的**位置**.
+
+30. 設置為**獨特**,這樣才可以找到統一標頭的 Xcode 偏好**Xcode 首選項 → 位置 → 派生資料 → 先進的......** 。
+
+31. 在專案導航器中選擇**專案圖示**,選擇你的**目標**,然後選擇**生成設置**選項卡。
+
+32. 搜索**標題搜索路徑**。該設置將追加這三個值,包括引號:
+    
+        "$(TARGET_BUILD_DIR) / usr/地方/lib/包括""$(OBJROOT) / UninstalledProducts/包括""$(BUILT_PRODUCTS_DIR)"
+        
+
+33. 搜索**其他連結器標誌**。該設置將追加此值:
+    
+        -weak_framework CoreFoundation
+        
+
+34. 生成您的專案,它應編譯和連結**沒有**問題.
+
+35. 從該**計畫**下拉箭頭,選擇您的專案,然後選擇**iPhone 5.1 模擬器**.
+
+36. 選擇**運行**按鈕。
+
+**注**: 如果您的專案不預期正常工作在模擬器中,請注意任何錯誤的主控台日誌中 Xcode 的線索。
+
+## 1.8.x 專案升級到 1.9.0
+
+1.  安裝包 1.9.0 科爾多瓦。
+
+2.  創建一個新專案。您將需要的一些資產從這個新的專案。
+
+3.  複製 `www/cordova-1.9.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/cordova-1.8.x.js` 檔。
+
+4.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova-1.9.0.js` 檔。
+
+**注**: 1.9.0 支援新 `BackupWebStorage` 布林 `Cordova.plist` 設置。 它預設啟用的那麼將其設置為 `false` ,禁用它,尤其是在 iOS 6 上。 請參閱[版本資訊: 野生動物園和 UIKit 科][17]
+
+ [17]: https://developer.apple.com/library/prerelease/ios/#releasenotes/General/RN-iOSSDK-6_0/_index.html
+
+## 升級 1.7.0 專案到 1.8.x
+
+1.  安裝 1.8.0 科爾多瓦。
+
+2.  創建一個新專案。您將需要的一些資產從這個新的專案。
+
+3.  複製 `www/cordova-1.8.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/cordova-1.7.x.js` 檔。
+
+4.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova-1.8.0.js` 檔。
+
+如果您打算使用捕獲 API,您將需要在新的**iPad 視網膜顯示**資產:
+
+1.  複製 `Resources/Capture.bundle` 從新專案到專案目錄中,覆蓋您現有的專案 `Resources/Capture.bundle` 專案。
+
+2.  在您的專案中選擇 `Capture.bundle` 專案到您的專案在 Xcode 中導航,鍵入**Delete**鍵,然後從出現的對話方塊中選擇**移除引用**。
+
+3.  拖動新 `Capture.bundle` 從步驟 1 以上到您專案中 Xcode 導航器,然後選擇**創建組的任何添加的資料夾**選項按鈕。
+
+## 升級到 1.7.0 的 1.6.x 專案
+
+1.  安裝科爾多瓦 1.7.0。
+
+2.  創建一個新專案。您將需要的一些資產從這個新的專案。
+
+3.  複製 `www/cordova-1.7.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/cordova-1.6.0.js` 檔。
+
+4.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova-1.7.0.js` 檔。
+
+## 升級 1.5.0 專案到 1.6.x
+
+1.  安裝 1.6.1 科爾多瓦。
+
+2.  創建的備份, `AppDelegate.m` , `AppDelegate.h` , `MainViewController.m` , `MainViewController.h` ,和 `Cordova.plist` 在您的專案中。
+
+3.  創建一個新專案。您將需要的一些資產從這個新的專案。
+
+4.  將這些檔從新專案複製到您的 1.5.0-based 專案目錄在磁片上,取代任何舊的檔 (備份您的檔首次從上述步驟 2):
+    
+        AppDelegate.h
+        AppDelegate.m
+        MainViewController.h
+        MainViewController.m
+        Cordova.plist
+        
+
+5.  添加所有新的 `MainViewController` 和 `AppDelegate` 檔,放入您的 Xcode 專案。
+
+6.  複製 `www/cordova-1.6.1.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/cordova-1.5.0.js` 檔。
+
+7.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `cordova-1.6.1.js` 檔。
+
+8.  添加新的 `Cordova.plist` 檔到您的專案。 這是必要的因為核心外掛程式服務名稱必須更改以匹配為一個統一的科爾多瓦 JavaScript 檔 (從 Android 和黑莓,部分`cordova-js`).
+
+9.  集成任何設置,你在你的**備份 Cordova.plist**成新的**外掛程式**和**ExternalHosts**條目`Cordova.plist`.
+
+10. 集成任何您已在您的備份中的具體專案代碼 `AppDelegate.h` 和 `AppDelegate.m` 成新 `AppDelegate` 檔。 任何 `UIWebViewDelegate` 或 `CDVCommandDelegate` 中的代碼 `AppDelegate.m` 需要去到 `MainViewController.m` 現在 (見該檔中的注釋掉節)。
+
+11. 集成任何您已在您的備份中的具體專案代碼 `MainViewController.h` 和 `MainViewController.m` 成新的 MainViewController 檔。
+
+12. 在專案導航器中的專案圖示上按一下,選擇您的**專案**,然後選擇**生成設置**選項卡。
+
+13. 輸入**編譯器的 C / C + + / 目標 C**在搜索欄位中。
+
+14. 選擇**蘋果 LLVM 編譯器 3.1**的值。
+
+## 升級到 1.5.0 版的 1.4.x 專案
+
+1.  安裝科爾多瓦 1.5.0 版。
+
+2.  創建一個新的專案並運行一次。您將需要的一些資產從這個新的專案。
+
+3.  複製 `www/cordova-1.5.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/phonegap-1.4.x.js` 檔。
+
+4.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新的科爾多瓦 `cordova-1.5.0.js` 檔。
+
+5.  找到 `PhoneGap.framework` 在你專案導航器中選擇它。
+
+6.  鍵入**Delete**鍵,刪除 `PhoneGap.framework` 專案導航器中的引用。
+
+7.  鍵入**選項-命令-A**複合鍵,應下拉表將檔添加到您的專案 (**添加檔...**表)。 請確保選中**創建組的任何添加的資料夾**選項按鈕。
+
+8.  鍵入的**Shift-命令-G**鍵組合,應下拉你去到一個資料夾中的另一個工作表 (**轉到資料夾:**表)。
+
+9.  輸入 `/Users/Shared/Cordova/Frameworks/Cordova.framework` 在**轉到資料夾:**工作表,然後按**繼續**按鈕。
+
+10. 在工作表中**添加的檔......** ,請按**添加**按鈕。
+
+11. 選擇 `Cordova.framework` 專案導航器中。
+
+12. 鍵入**選項-命令-1**鍵的組合,以顯示**檔檢查器**.
+
+13. **絕對路徑**在**檔檢查器**的下拉式功能表中選擇的**位置**.
+
+14. 鍵入**選項-命令-A**複合鍵,應下拉表將檔添加到您的專案 (**添加檔...**表)。 請確保選中**創建組的任何添加的資料夾**選項按鈕。
+
+15. 鍵入的**Shift-命令-G**鍵組合,應下拉你去到一個資料夾中的另一個工作表 (**轉到資料夾:**表)。
+
+16. 輸入 `~/Documents/CordovaLib/Classes/deprecated` 在**轉到資料夾:**工作表,然後按**繼續**按鈕。
+
+17. 在工作表中**添加的檔......** ,請按**添加**按鈕。
+
+18. 在 `AppDelegate.h` , `AppDelegate.m` ,和 `MainViewController.h` 檔,替換整個 `#ifdef PHONEGAP_FRAMEWORK` 與塊:
+    
+        #import "CDVDeprecated.h"
+        
+
+19. 按一下專案導航器中的**專案圖示**,選擇你的**目標**,然後選擇**生成設置**選項卡。
+
+20. **框架搜索路徑**搜索.
+
+21. 替換現有值與`/Users/Shared/Cordova/Frameworks`.
+
+22. 搜索**預處理器宏**.
+
+23. 對於第一次 (組合) 值,替換的值與**CORDOVA_FRAMEWORK = YES**.
+
+24. 選擇**生成階段**選項卡。
+
+25. 擴大**運行腳本**.
+
+26. 與**科爾多瓦**的**PhoneGap**任何替換.
+
+27. 找到 `PhoneGap.plist` 檔在專案導航器,並按一下檔案名一旦輸入名稱編輯模式。
+
+28. 重命名 `PhoneGap.plist` 到`Cordova.plist`.
+
+29. 用滑鼠右鍵按一下 `Cordova.plist` ,然後選擇**→ 作為開放源碼的代碼**.
+
+30. 按**選項-命令-F**,選擇**替換**從下拉在上面留下的源視窗。
+
+31. 輸入 `com.phonegap` 查找字串,和 `org.apache.cordova` 的替換字串,然後按**全部替換**按鈕。
+
+32. 查找字串和**CDV**的**PG**輸入替換字串,然後按**全部替換**按鈕。
+
+33. 按**命令-B**生成。 你仍然有你可以擺脫在將來的瞧不起 (請參閱 `CDVDeprecated.h` 。 例如,替換在您的代碼中使用類,PG * 到 CDV *)。
+
+## 升級 1.4.0 1.4.1 向專案
+
+1.  安裝 1.4.1 科爾多瓦。
+
+2.  製作一個備份`MainViewController.m`.
+
+3.  創建一個新專案。您將需要的一些資產從這個新的專案。
+
+4.  複製 `MainViewController.m` 到 1.4.0-based 專案目錄中的新專案從磁片上的檔,替換舊檔 (備份您的檔第一次從上面的步驟 2)。
+
+5.  添加 `MainViewController.m` 到 Xcode 專案檔案。
+
+6.  將任何您已在您的備份中的具體專案代碼集成 `MainViewController.m` 成新的檔。
+
+7.  更新 `phonegap-1.4.0.js` 檔是可選的 JavaScript 1.4.0 和 1.4.1 之間上沒有任何改變。
+
+## 升級 1.3.0 專案到 1.4.0
+
+1.  安裝 1.4.0 科爾多瓦。
+
+2.  製作一個備份的 `AppDelegate.m` 和 `AppDelegate.h` 在您的專案中。
+
+3.  創建一個新專案。您將需要的一些資產從這個新的專案。
+
+4.  將這些檔從新專案複製到您的 1.3.0-based 專案目錄在磁片上,取代任何舊的檔 (備份您的檔首次從上述步驟 2):
+    
+        AppDelegate.h AppDelegate.m MainViewController.h MainViewController.m MainViewController.xib
+        
+
+5.  添加所有 `MainViewController` 入 Xcode 專案檔案。
+
+6.  複製 `www/phonegap-1.4.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/phonegap-1.3.0.js` 檔。
+
+7.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `phonegap-1.4.0.js` 檔。
+
+8.  添加一個新條目下的 `Plugins` 的 `PhoneGap.plist` 檔。關鍵是 `com.phonegap.battery` 和值是`PGBattery`.
+
+9.  集成任何您已在您的備份中的具體專案代碼 `AppDelegate.h` 和 `AppDelegate.m` 成新的 AppDelegate 檔。
+
+## 升級 1.2.0 專案到 1.3.0
+
+1.  安裝 1.3.0 科爾多瓦。
+
+2.  製作一個備份的 `AppDelegate.m` 和 `AppDelegate.h` 在您的專案中。
+
+3.  創建一個新專案。您將需要的一些資產從這個新的專案。
+
+4.  將這些檔從新專案複製到您的 1.2.0-based 專案目錄在磁片上,取代任何舊的檔 (備份您的檔首次從上述步驟 2):
+    
+        AppDelegate.h AppDelegate.m MainViewController.h MainViewController.m MainViewController.xib
+        
+
+5.  添加所有 `MainViewController` 入 Xcode 專案檔案。
+
+6.  複製 `www/phonegap-1.3.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/phonegap-1.2.0.js` 檔。
+
+7.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `phonegap-1.3.0.js` 檔。
+
+8.  添加一個新條目下的 `Plugins` 的 `PhoneGap.plist` 檔。關鍵是 `com.phonegap.battery` 和值是`PGBattery`.
+
+9.  集成任何您已在您的備份中的具體專案代碼 `AppDelegate.h` 和 `AppDelegate.m` 成新的 AppDelegate 檔。
+
+## 升級 1.1.0 專案到 1.2.0
+
+1.  安裝科爾多瓦 1.2.0。
+
+2.  製作一個備份的 `AppDelegate.m` 和 `AppDelegate.h` 在您的專案中。
+
+3.  創建一個新專案。您將需要的一些資產從這個新的專案。
+
+4.  將這些檔從新專案複製到您的 1.1.0-based 專案目錄在磁片上,取代任何舊的檔 (備份您的檔首次從上述步驟 2):
+    
+        AppDelegate.h AppDelegate.m MainViewController.h MainViewController.m MainViewController.xib
+        
+
+5.  添加所有 `MainViewController` 入 Xcode 專案檔案。
+
+6.  複製 `www/phonegap-1.2.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/phonegap-1.1.0.js` 檔。
+
+7.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `phonegap-1.2.0.js` 檔。
+
+8.  添加一個新條目下的 `Plugins` 的 `PhoneGap.plist` 檔。關鍵是 `com.phonegap.battery` 和值是`PGBattery`.
+
+9.  集成任何您已在您的備份中的具體專案代碼 `AppDelegate.h` 和 `AppDelegate.m` 成新的 AppDelegate 檔。
+
+## 升級 1.0.0 專案到 1.1.0
+
+1.  安裝科爾多瓦 1.1.0。
+
+2.  製作一個備份的 `AppDelegate.m` 和 `AppDelegate.h` 在您的專案中。
+
+3.  創建一個新專案。您將需要的一些資產從這個新的專案。
+
+4.  將這些檔從新專案複製到您的 1.0.0-based 專案目錄在磁片上,取代任何舊的檔 (備份您的檔首次從上述步驟 2):
+    
+        AppDelegate.h AppDelegate.m MainViewController.h MainViewController.m MainViewController.xib
+        
+
+5.  添加所有 `MainViewController` 入 Xcode 專案檔案。
+
+6.  複製 `www/phonegap-1.1.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/phonegap-1.0.0.js` 檔。
+
+7.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `phonegap-1.1.0.js` 檔。
+
+8.  添加一個新條目下的 `Plugins` 的 `PhoneGap.plist` 檔。關鍵是 `com.phonegap.battery` 和值是`PGBattery`.
+
+9.  集成任何您已在您的備份中的具體專案代碼 `AppDelegate.h` 和 `AppDelegate.m` 成新的 AppDelegate 檔。
+
+## 升級 0.9.6 專案到 1.0.0
+
+1.  安裝科爾多瓦 1.0.0。
+
+2.  製作一個備份的 `AppDelegate.m` 和 `AppDelegate.h` 在您的專案中。
+
+3.  創建一個新專案。您將需要的一些資產從這個新的專案。
+
+4.  將這些檔從新專案複製到您的 0.9.6-based 專案目錄在磁片上,取代任何舊的檔 (備份您的檔首次從上述步驟 2):
+    
+        AppDelegate.h AppDelegate.m MainViewController.h MainViewController.m MainViewController.xib
+        
+
+5.  添加所有 `MainViewController` 入 Xcode 專案檔案。
+
+6.  複製 `www/phonegap-1.0.0.js` 到新專案中的檔 `www` 目錄中,並刪除 `www/phonegap-0.9.6.js` 檔。
+
+7.  科爾多瓦的腳本中的引用更新 `www/index.html` 檔 (以及包含該腳本引用的任何其他檔) 以指向新 `phonegap-1.0.0.js` 檔。
+
+8.  添加一個新條目下的 `Plugins` 的 `PhoneGap.plist` 檔。關鍵是 `com.phonegap.battery` 和值是`PGBattery`.
+
+9.  集成任何您已在您的備份中的具體專案代碼 `AppDelegate.h` 和 `AppDelegate.m` 成新的 AppDelegate 檔。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/513a1fa1/docs/zh/edge/guide/platforms/ios/webview.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/ios/webview.md b/docs/zh/edge/guide/platforms/ios/webview.md
index 305c4cd..49d1e14 100644
--- a/docs/zh/edge/guide/platforms/ios/webview.md
+++ b/docs/zh/edge/guide/platforms/ios/webview.md
@@ -16,7 +16,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
 
 # WebViews iOS
 
-這一節演示如何嵌入在一個較大的 iOS 應用程式內的科爾多瓦啟用 web 視圖元件。這些元件可以如何與對方溝通的詳細資訊,請參閱應用程式外掛程式。
+本指南說明如何將嵌入在一個較大的 iOS 應用程式內的科爾多瓦啟用 web 視圖元件。這些元件可以如何與對方溝通的詳細資訊,請參閱應用程式外掛程式。
 
 支援的 iOS WebViews 開始與科爾多瓦版本 1.4,使用 `Cleaver` 的 Xcode 範本用作參考實現的元件。 科爾多瓦 2.0 及更高版本僅支援基於子專案的刀實施。
 
@@ -56,16 +56,10 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
 
 14. 選擇**+**按鈕,然後添加下列**框架**。 (可選) 在**導航專案**內, 移動它們**框架**組下:
     
-        AddressBook.framework
-        AddressBookUI.framework
-        AudioToolbox.framework
-        AVFoundation.framework
+        AssetsLibrary.framework
         CoreLocation.framework
-        MediaPlayer.framework
-        QuartzCore.framework
-        SystemConfiguration.framework
+        CoreGraphics.framework
         MobileCoreServices.framework
-        CoreMedia.framework
         
 
 15. 擴展**目標的依賴關係**,與該標籤,如果有多個框頂部的框。

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/513a1fa1/docs/zh/edge/guide/platforms/tizen/index.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/tizen/index.md b/docs/zh/edge/guide/platforms/tizen/index.md
index 7d9375e..e86ed8d 100644
--- a/docs/zh/edge/guide/platforms/tizen/index.md
+++ b/docs/zh/edge/guide/platforms/tizen/index.md
@@ -34,14 +34,14 @@ Tizen SDK 需要 Linux Ubuntu 10.04/10.10/11.04/11.10 (32 位) 或 Windows X
 
 - (optional) Install Tizen Cordova template projects: copy the
   `/templates` directory content into the Tizen Eclipse IDE web
-  templates directory (e.g:
+  templates directory (e.g.:
   `/home/my_username/tizen-sdk/IDE/Templates/web`).
 
 - __Method #2: Use Tizen Eclipse IDE Cordova Tizen project templates__
     - Launch Tizen Eclipse IDE
     - Select  __File &rarr; New &rarr; Tizen Web Project__
     - Select __User Template__ and __User defined__ items
-    - Select one of the Tizen Cordova template (e.g: __CordovaBasicTemplate__)
+    - Select one of the Tizen Cordova template (e.g.: __CordovaBasicTemplate__)
     - Fill the __Project name__ and its target __Location__
 
     ![](img/guide/platforms/tizen/project_template.png)
@@ -104,7 +104,7 @@ Tizen SDK 需要 Linux Ubuntu 10.04/10.10/11.04/11.10 (32 位) 或 Windows X
     
     ![][7]
 
-*   用滑鼠右鍵按一下該專案,在**專案資源管理器**視圖,然後選擇 Run As **& rarr;Tizen Web 應用程式**:
+*   用滑鼠右鍵按一下該專案在**專案資源管理器**視圖,然後選擇**運行作為 → Tizen Web 應用程式**:
     
     ![][8]
 

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/513a1fa1/docs/zh/edge/guide/platforms/ubuntu/index.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/ubuntu/index.md b/docs/zh/edge/guide/platforms/ubuntu/index.md
index 330f74b..36a9473 100644
--- a/docs/zh/edge/guide/platforms/ubuntu/index.md
+++ b/docs/zh/edge/guide/platforms/ubuntu/index.md
@@ -18,7 +18,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
 
 ## 初始版本
 
-歡迎來到科爾多瓦 Ubuntu 平臺支援的初始版本。 此版本中,重點是在 Ubuntu 的系統上開發和使用科爾多瓦 Web 專案開發工作流。 這包括將 Ubuntu 平臺添加到您的專案,添加標準科爾多瓦外掛程式,,當然,建設和運行的 Ubuntu 平臺的應用程式。
+歡迎來到科爾多瓦 Ubuntu 平臺支援的初始版本。 此版本中,重點是在 Ubuntu 的系統上開發和使用概述中討論的跨平臺工作流。 這包括將 Ubuntu 平臺添加到您的專案,添加標準科爾多瓦外掛程式,以及建設和運行的 Ubuntu 平臺的應用程式。
 
 ### Ubuntu SDK
 
@@ -28,7 +28,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
 
 ### Ubuntu 運行時平臺
 
-Ubuntu 是知名的為其桌面環境 (用於筆記本電腦、 Pc 和此類)。 Ubuntu 觸摸延伸到手機和平板電腦上的 Ubuntu 作業系統。 Ubuntu 運行時平臺有不同的 CPU 體系結構 (x 86,armhf,等.)。 必須適當地編譯外掛程式和應用程式代碼。 對此廣泛領域的支援正在迅速演變在 Ubuntu 中。
+Ubuntu 是眾所周知的其桌面環境 (用於筆記本電腦、 Pc 和此類)。 Ubuntu 觸摸延伸到手機和平板電腦上的 Ubuntu 作業系統。 Ubuntu 運行時平臺有不同的 CPU 體系結構 (x 86,armhf,等.)。 必須適當地編譯外掛程式和應用程式代碼。 對此廣泛領域的支援正在迅速演變在 Ubuntu 中。
 
 ### 最新資訊
 
@@ -61,12 +61,14 @@ Ubuntu 是知名的為其桌面環境 (用於筆記本電腦、 Pc 和此類
 
 ### 創建一個專案
 
-    $ cordova create project1 REVERSEDNSNAME.project1 project1
+創建一個應用程式在 `hello` 目錄的顯示名稱是 `HelloWorld` :
+
+    $ cordova create hello com.example.hello HelloWorld
     
 
 ### 移動到專案目錄
 
-    $ cd project1
+    $ cd hello
     
 
 ### 添加 Ubuntu 平臺

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/513a1fa1/docs/zh/edge/guide/platforms/win8/index.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/win8/index.md b/docs/zh/edge/guide/platforms/win8/index.md
index f504392..af485e1 100644
--- a/docs/zh/edge/guide/platforms/win8/index.md
+++ b/docs/zh/edge/guide/platforms/win8/index.md
@@ -16,87 +16,149 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
 
 # Windows 8 平臺指南
 
-本指南介紹如何設置您的 SDK 開發環境為 Windows 8 部署科爾多瓦的應用程式。請參閱下列特定于平臺的詳細資訊:
+本指南介紹如何設置您的 SDK 開發環境部署科爾多瓦在 Windows 8 的應用程式。 該示例演示如何使用任一特定于 Windows 8 的外殼工具來生成和生成的應用程式,或者跨平臺科爾多瓦 CLI 討論在命令列介面。 (見的概述的這些發展選項比較)。此部分還顯示如何修改科爾多瓦在 Visual Studio 中的應用程式。 無論你採取哪種方法,您需要安裝 Visual Studio SDK,如下所述。
 
-*   升級 Windows 8
-*   Windows 8 的命令列工具
+有關如何升級現有的 Windows 8 科爾多瓦專案的資訊,請參閱升級 Windows 8。
 
-上面的命令列工具請參閱科爾多瓦 3.0 以前的版本。關於當前介面的資訊,請參閱命令列介面。
+科爾多瓦 WebViews 運行在 Windows 8 上依靠互聯網資源管理器中 10 作為他們的呈現引擎,因此作為一個實際問題你可以使用 IE10 的功能強大的調試器來測試並不調用科爾多瓦 Api 的任何 web 內容。 Windows Phone 開發者博客如何支援 IE10 和可比較的 WebKit 瀏覽器提供[有益的指導][1]。
 
-Microsoft 不推薦使用在 Windows 8 和 Windows 室溫下*地鐵風格的應用程式*名稱 MSDN 現在指的是這種類型的應用程式作為*Windows 應用商店*的應用程式,並且本指南跟隨該公約 》。 此外,在本指南中*Windows 8*表示 Windows 8 和 Windows 室溫下
+ [1]: http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx
 
-## 要求
+## 要求和支援
 
-*   Windows 8
+您需要以下 OS/SDK 組合,可以從安裝盤或*ISO*磁片影像檔之一:
 
-*   Visual Studio 2012 專業或更好或 Visual Studio 2012 表示為 Windows 8
+*   Windows 8.0 或 8.1、 32 或 64 位*首頁*、*臨*,或*企業*版,以及[Visual Studio 2012 速成版][2].
 
-按照在[windowsstore.com][1]的說明提交您對 Windows 應用商店的應用程式。
+*   Windows 8.1、 32 或 64 位*首頁*、*臨*,或*企業*版,以及[Visual Studio 2013 專業版][2]或更高。 評估版的 Windows 8.1 企業是可從[Microsoft 開發人員網路][3].
 
- [1]: http://www.windowsstore.com/
+ [2]: http://www.visualstudio.com/downloads
+ [3]: http://msdn.microsoft.com/en-US/evalcenter/jj554510
 
-## 安裝 SDK 和科爾多瓦
+根據 Windows 8.1 編譯的應用程式*不*在 Windows 8.0 下運行。根據 Windows 8.0 編譯的應用程式是向前相容的 8.1。
 
-設置您的 Visual Studio 2012 的首選變形。 所有產品的付費版本 (專業、 等) 讓您構建 Windows 應用商店的應用程式。 你需要**表達為 Windows 8**來構建 Windows 應用商店應用程式使用的[速成版][2].
+<!-- 64-bit necessary? Pro necessary? ELSE still recommended for parallel WP dev -->
 
- [2]: http://www.microsoft.com/visualstudio/eng/products/visual-studio-express-products
+按照在[windowsstore.com][4]的說明提交到 Windows 應用商店的應用程式。
 
-下載並解壓縮[科爾多瓦][3]的最新副本。這些說明適用于 `lib\windows-8` 子目錄。
+ [4]: http://www.windowsstore.com/
 
- [3]: http://phonegap.com/download
+<!-- true? -->
 
-## 設立了一個新的專案
+為了為 Windows 8 開發科爾多瓦的應用程式,您可以使用運行 Windows 的個人電腦,但你也可能發展的 mac,通過運行一個虛擬機器環境或者通過使用到雙重開機 Windows 8 分區的新兵訓練營。 請查閱這些資源以設置在 Mac 上所需的 Windows 開發環境:
 
-你已經可以生成使用*HTML/JavaScript 跟蹤*在 Windows 應用商店的應用程式中可用的 Windows 8 應用程式。 在 Windows 應用商店的應用程式中使用科爾多瓦,正如在其他科爾多瓦支援的平臺上公開相同的 Api。
+*   [VMWare 融合][5]
 
-*   打開 Visual Studio 2012 並選擇**新的專案**.
+*   [相似之處的桌面][6],
 
-*   從專案清單從樹,然後**空白應用程式**選擇**安裝 → 範本 → 其它語言 → JavaScript → Windows 存儲區**。 輸入你喜歡的如無論專案名稱 `CordovaWin8Foo` 如本示例所示:
-    
-    ![][4]
+*   [新兵訓練營][7].
+
+ [5]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945426
+ [6]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945424
+ [7]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945423
+
+## 使用科爾多瓦外殼工具
+
+如果您想要使用科爾多瓦的 Windows 8 居中外殼工具與 SDK 一起,你有兩個基本選項:
+
+*   本地訪問它們生成的 CLI 的專案代碼中。 他們是可用在 `platforms/windows8/cordova` 目錄在您添加後 `windows8` 平臺如下所述。
+
+*   從單獨的分發在[cordova.apache.org][8]下載它們。 科爾多瓦分佈包含單獨的檔案,為每個平臺。 一定要展開相應的存檔, `cordova-windows8\windows8` 在這種情況下,在一個空的目錄內。 有關批次處理實用程式可用在頂級 `bin` 目錄。 (參閱**自述**檔,如果有必要作更詳細的指示)。
+
+ [8]: http://cordova.apache.org
+
+這些外殼工具允許您創建、 構建和運行 Windows 8 的應用程式。 額外的命令列介面,可以跨所有平臺的外掛程式功能的資訊,請參閱使用 Plugman 到管理外掛程式。
+
+## 安裝 SDK
+
+*最終*、*溢價*或*專業*2013年版本的[Visual Studio][2]安裝.
+
+![][9]
 
-*   Microsoft 將繼續使用 `default.html` 作為預設的主頁,但大多數的 網頁程式開發人員使用 `index.html` 。 它是個好主意,這樣做,至少要匹配你有可能在其他平臺。 若要修復此問題,在**解決方案資源管理器中**重命名 `default.html` 檔到 `index.html` 。 然後按兩下 `package.appxmanifest` 檔,並將**起始頁**該值更改為 `index.html` :
+ [9]: img/guide/platforms/win8/win8_installSDK.png
+
+## 創建一個新專案
+
+此時,若要創建一個新的專案您可以選擇在命令列介面或一組 Windows 8 特定 shell 工具中所述的跨平臺 CLI 工具之間。 從內一個原始程式碼目錄,此 CLI 方法生成命名在一個新的*HelloWorld*應用程式 `hello` 的專案目錄:
+
+        > cordova create hello com.example.hello HelloWorld
+        > cd hello
+        > cordova platform add windows8
+        > cordova build
     
-        ![](img/guide/platforms/win8/wschangemanifest.png)
-        
 
-*   要包括 `cordova.js` 在專案中,按右鍵 `js` 目錄在**解決方案資源管理器**並選擇**添加 → 新專案**。 找到 `cordova.js` 檔在 `lib\windows-8` 目錄。
+這裡是相應的較低級別外殼工具方法:
 
-*   編輯的代碼為 `index.html` 。 將引用添加到 `cordova.js` 。 您可以手動,或通過從**解決方案資源管理器中**拖動檔。 添加以下其他應用程式的主頁上的依賴關係:
+        C:\path\to\cordova-win8\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld
     
-            <!-- WinJS references -->
-            <link href="//Microsoft.WinJS.1.0/css/ui-dark.css" rel="stylesheet" />
-            <script src="//Microsoft.WinJS.1.0/js/base.js"></script>
-            <script src="//Microsoft.WinJS.1.0/js/ui.js"></script>
-        
-            <!-- Cordova -->
-            <script src="/js/cordova.js"></script>
-        
-            <!-- CordovaWin8Foo references -->
-            <link href="/css/default.css" rel="stylesheet" />
-            <script src="/js/default.js"></script>
-        
-
-*   添加 `deviceready` 處理常式,以演示科爾多瓦工作:
+
+## 生成專案
+
+如果您在開發中使用 CLI,專案目錄的頂級 `www` 目錄中包含的原始程式碼檔。運行任一內要重新生成應用程式的專案目錄:
+
+        > cordova build
+        > cordova build windows8   # do not rebuild other platforms
     
-        <body>
-            <p>Content goes here</p>
-            <script type="text/javascript">
-                console.log("Subscribing...");
-                document.addEventListener("deviceready", function () {
-                    navigator.notification.alert("The device is ready!");
-                });
-            </script>
-        </body>
-        
 
- [4]: img/guide/platforms/win8/wsnewproject.png
+如果您使用的 Windows Phone 特定 shell 工具在發展中,有不同的方法。 一旦您生成該專案,預設應用程式的源是可用在 `projects\windows8\www` 子目錄。 隨後的命令都可用在 `cordova` 子目錄中同一級別的。
 
-## 測試專案
+`build`命令,清理專案檔案並重新生成應用程式。第一個示例將生成調試資訊,和第二個標誌發佈的應用程式:
 
-從 Visual Studio 中運行該專案。你會看到顯示的訊息方塊:
+        C:\path\to\project\cordova\build.bat --debug        
+        C:\path\to\project\cordova\build.bat --release
+    
+
+`clean`命令有助於沖洗掉下一步準備中的目錄 `build` :
 
-        ![](img/guide/platforms/win8/wsalert.png)
+        C:\path\to\project\cordova\clean.bat
     
 
-這是它。你現在準備好建立 Windows 應用商店的應用,科爾多瓦。
\ No newline at end of file
+## 在 SDK 中打開的專案和部署應用程式
+
+一旦你建立科爾多瓦 app,如上文所述,您可以與 Visual Studio 一起打開它。 各種 `build` 命令生成一個 Visual Studio 解決方案 (*.sln*) 檔。 在檔瀏覽器來修改在 Visual Studio 專案中打開檔:
+
+![][10]
+
+ [10]: img/guide/platforms/win8/win8_sdk_openSLN.png
+
+`CordovaApp`元件顯示在解決方案內和其 `www` 目錄中包含的基於 web 的原始程式碼,包括 `index.html` 的主頁:
+
+![][11]
+
+ [11]: img/guide/platforms/win8/win8_sdk.png
+
+Visual Studio 主功能表下面的控制項允許您測試或部署應用程式:
+
+![][12]
+
+ [12]: img/guide/platforms/win8/win8_sdk_deploy.png
+
+選擇**本地電腦**,請按綠色箭頭,在運行 Visual Studio 在同一台電腦上安裝該應用程式。一旦你這樣做,應用程式將出現在 Windows 8 的應用程式清單:
+
+![][13]
+
+ [13]: img/guide/platforms/win8/win8_sdk_runApp.png
+
+每次您重新生成應用程式,在介面中可用的版本被刷新一次。
+
+一旦可用應用程式清單中,按住**CTRL**鍵同時選擇該應用程式允許您把它釘在主畫面:
+
+![][14]
+
+ [14]: img/guide/platforms/win8/win8_sdk_runHome.png
+
+請注意是否您打開該應用程式在虛擬機器環境中的,您可能需要按一下在角落或沿邊的 windows 訪問額外的功能或切換應用程式:
+
+![][15]
+
+ [15]: img/guide/platforms/win8/win8_sdk_run.png
+
+或者,選擇**模擬器**部署選項以查看應用程式,如果它運行在平板設備上:
+
+![][16]
+
+ [16]: img/guide/platforms/win8/win8_sdk_sim.png
+
+與不同的桌面部署,此選項允許您類比平板的方向、 位置,並更改其網路設置。
+
+**注意**: 有關如何在您的工作流中使用科爾多瓦的命令列工具或 SDK 的建議諮詢概述。 科爾多瓦 CLI 依賴經常會覆蓋使用 SDK 的平臺特定檔的跨平臺原始程式碼。 如果您想要使用 SDK 來修改該專案,使用較低級別殼工具作為 CLI 的替代。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/513a1fa1/docs/zh/edge/guide/platforms/win8/upgrade.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/win8/upgrade.md b/docs/zh/edge/guide/platforms/win8/upgrade.md
new file mode 100644
index 0000000..333fc21
--- /dev/null
+++ b/docs/zh/edge/guide/platforms/win8/upgrade.md
@@ -0,0 +1,56 @@
+---
+
+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.
+---
+
+# 升級 Windows 8
+
+本指南演示如何修改 Windows 8 專案從科爾多瓦的舊版本進行升級。 大多數這些說明適用于與舊集的前面的命令列工具創建的專案 `cordova` CLI 實用程式。 資訊,請參閱命令列介面如何更新的 CLI 版本。
+
+## 從 3.1.0 升級到 3.2.0
+
+為創建的科爾多瓦 CLI 的專案:
+
+1.  更新 `cordova` CLI 版本。請參閱命令列介面。
+
+2.  運行`cordova platform update windows8`.
+
+對於不使用 CLI 科爾多瓦創建的專案,請運行:
+
+        bin\update <project_path>
+    
+
+## 升級到 3.1.0
+
+在科爾多瓦 3.1.0 引入了對 Windows 8 的科爾多瓦 CLI 支援。若要升級,我們建議創建新的科爾多瓦 CLI 專案和所有必要的資產轉移。
+
+## 從 2.8.0 升級到 2.9.0
+
+下面的命令應當從內進行 Visual Studio 可以肯定任何專案引用是更新刪除。
+
+1.  刪除 `cordova-2.8.0.js` 從專案的 `www` 目錄。
+
+2.  添加 `cordova.js` 檔從源到專案中的 `www` 目錄。(請注意該檔不再包含在檔案名中的版本號)。
+
+3.  生成和測試 !
+
+## 從 2.7.0 升級到 2.8.0
+
+下面的命令應當從內進行 Visual Studio 可以肯定任何專案引用是更新刪除。
+
+1.  刪除 `cordova-2.7.0.js` 從專案的 `www` 目錄。
+
+2.  添加 `cordova.js` 檔從源到專案中的 `www` 目錄。(請注意該檔不再包含在檔案名中的版本號)。
+
+3.  生成和測試 !
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/513a1fa1/docs/zh/edge/guide/platforms/wp8/index.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/wp8/index.md b/docs/zh/edge/guide/platforms/wp8/index.md
index a6d6c2d..1cca878 100644
--- a/docs/zh/edge/guide/platforms/wp8/index.md
+++ b/docs/zh/edge/guide/platforms/wp8/index.md
@@ -14,135 +14,237 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
    under the License.
 ---
 
-# Windows Phone 8 平臺指南
+# Windows Phone 平臺指南
 
-本指南介紹如何設置您的 SDK 開發環境部署科爾多瓦為 Windows Phone 8 設備的應用程式。 如果你想要的目標 7.5 和 8 設備,而是盡可能詳細的 Windows Phone 7 平臺指南開發為 Windows Phone 7。 第 7 版並沒有互聯網資源管理器中 10 中包含的所有高級的功能,但實現相同的 Api 集。 Windows Phone 8 應用程式*不*在 Windows Phone 7 設備上運行。
+本指南介紹如何設置您的 SDK 開發環境部署科爾多瓦的 Windows Phone 設備的應用程式。 它側重于 Windows Phone 8,但提供如何支援 Windows Phone 7 的附加詳細資訊。
 
-適用于這兩個版本的更多詳細的平臺特定資訊如下所示:
+該示例演示如何使用任一特定的 Windows Phone 外殼程式工具來生成和生成的應用程式,或者跨平臺科爾多瓦 CLI 討論在命令列介面。 (見的概述的這些發展工作流比較)。此部分還顯示了如何打開科爾多瓦的應用程式,以便您可以在 Visual Studio 中修改他們。 無論你採取哪種方法,您需要安裝 Windows Phone SDK,如下所述。
+
+見到 Windows Phone 平臺特定的詳細資訊如下:
 
-*   升級 Windows Phone
 *   Windows Phone 外掛程式
-*   Windows Phone 的命令列工具
+*   升級 Windows Phone
+
+對於 Windows Phone 8 平臺,科爾多瓦 web 視圖依賴于互聯網資源管理器中 10 作為自己的渲染引擎,因此作為一個實際問題你可以使用 IE10 的功能強大的調試器來測試並不調用科爾多瓦 Api 的任何 web 內容。 Windows Phone 開發者博客如何支援 IE10 和可比較的 WebKit 瀏覽器提供[有益的指導][1]。
+
+ [1]: http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx
+
+## 要求和支援
+
+您需要以下各項:
+
+*   64 位版本的 Windows 8 Pro,安裝盤或*ISO*磁片影像檔。 評估版是[Microsoft 開發人員網路][2]上可用。 Pro 版有必要運行設備模擬程式。
+
+*   的[Windows Phone SDK][3].
+
+ [2]: http://msdn.microsoft.com/en-US/evalcenter/jj554510
+ [3]: https://dev.windowsphone.com/en-us/downloadsdk
+
+為了開發科爾多瓦的 Windows Phone 設備的應用程式,您可以使用運行 Windows 的電腦,但你也可能發展的 mac,通過運行一個虛擬機器環境或者通過使用新兵訓練營雙啟動 Windows 的分區。 請查閱這些資源以設置在 Mac 上所需的 Windows 開發環境:
+
+*   **VMWare 融合**: 要設置了 Windows 8 的虛擬機器,按照[Microsoft 開發人員網路][4],所提供的說明,然後請參閱配置 VMWare 融合的虛擬環境運行 SDK 捆綁的模擬器的準備工作資訊。
+
+*   **桌面的相似之處**: 若要設置 Windows 8 虛擬機器,按照[Microsoft 開發人員網路][5],所提供的說明,然後請參閱配置平行桌面虛擬環境運行 SDK 捆綁的模擬器的準備工作資訊。
+
+ [4]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945426
+ [5]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945424
+
+<!--
+- __VirtualBox__: To set up the Windows 8 virtual machine, follow the
+  installation instructions provided by the [Microsoft Developer
+  Network](http://msdn.microsoft.com/en-US/library/windows/apps/jj945425).
+
+  2DO: virtualBox doesn't work yet; any extra config info?
+-->
+
+*   **新兵訓練營**: 要設置了 Windows 8 的分區,請按照操作[Microsoft 開發人員網路][6]所提供的安裝說明.
+
+ [6]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945423
+
+如果您在 PC 上開發,其處理器必須支援虛擬化 (英特爾*VT-x* ) 和[第二級別位址翻譯 (板式)][7]。 請查閱[英特爾的支援的處理器的清單][8]。 虛擬化是通常預設禁用的所以您需要在您的 BIOS 設置中啟用它。 PC 應該有至少 6.5 GB 的可用硬碟空間和 4 GB 的 RAM。
+
+ [7]: http://en.wikipedia.org/wiki/Second_Level_Address_Translation
+ [8]: http://ark.intel.com/Products/VirtualizationTechnology
+
+## 使用科爾多瓦外殼工具
+
+如果您想要使用科爾多瓦的 Windows Phone 居中外殼工具與 SDK 一起,你有兩個基本選項:
+
+*   本地訪問它們生成的 CLI 的專案代碼中。他們是可用在 `platforms/wp8/cordova` 目錄在您添加後 `wp8` 平臺如下所述。
+
+*   從單獨的分發在[cordova.apache.org][9]下載它們。 科爾多瓦分佈包含單獨的檔案,為每個平臺。 一定要展開相應的存檔, `cordova-wp8\wp8` 在這種情況下,在一個空的目錄內。 有關批次處理實用程式可用在頂級 `bin` 目錄。 (參閱**自述**檔,如果有必要作更詳細的指示)。
+
+ [9]: http://cordova.apache.org
+
+這些外殼工具允許您創建、 構建和運行 Windows Phone 應用程式。 額外的命令列介面,可以跨所有平臺的外掛程式功能的資訊,請參閱使用 Plugman 到管理外掛程式。 指導如何開發外掛程式和 Windows Phone 外掛程式特定的 Windows Phone 平臺的詳細資訊,請參閱應用程式外掛程式。
+
+## 安裝 SDK
 
-上面的命令列工具請參閱科爾多瓦 3.0 以前的版本。關於當前介面的資訊,請參閱命令列介面。
+從[dev.windowsphone.com][3]的**下載**區域安裝最新版本的 Windows Phone SDK。 你也可以安裝更多最近的模擬程式更新程式封裝。
 
-## 系統要求
+![][10]
 
-*   作業系統:
+ [10]: img/guide/platforms/wp8/wp8_downloadSDK.png
+
+後安裝的 SDK,您需要修改系統的路徑,以使科爾多瓦可用 SDK 在 Windows 命令列:
+
+*   首先你需要獲取路徑字串。 打開**檔資源管理器中**,導航到 `C:\Windows\Microsoft.NET\Framework` ,然後打開最新的框架。 按一下右邊的導航路徑查看完整路徑的字串,然後鍵入**CTRL c**複製它:
     
-    *   Windows 8 或 Windows 8 臨 
-        *   需要的 SDK 的 Windows 64 位版本 (x64)。
-        *   Pro 版建議以便您可以運行的設備模擬程式。
+    ![][11]
 
-*   硬體:
+*   然後你需要修改的路徑。打開**控制台**從 Windows 8 的主畫面**應用程式**範圍內:
     
-    *   6.5 GB 的可用硬碟空間
-    *   4 GB RAM
-    *   (x64) 64 位 CPU
+    ![][12]
 
-*   Windows Phone 8 模擬器
+*   打開**系統**控制台專案:
     
-    *   手機模擬器使用 HYPER-V,因此該清單只包含那些必備。
-    *   Windows 8 Pro 64 位版或更高
-    *   需要支援虛擬化的處理器和 [第二級別位址翻譯 (板式)][1] 
-        *   查看[清單中的英特爾處理器支援 VT-x (虛擬化) 和 EPT (板式)][2]
-    *   啟用虛擬化功能 (即,VT-x 上英特爾) 在您的 BIOS 設置,如預設情況下通常禁用此。
+    ![][13]
 
-*   SDK 和 IDE (Visual Studio)
+*   從左側的清單中選擇**高級系統設置**:
     
-    *   Visual Studio 2012 專業、 保費或極限。 請注意 Visual Studio 表示為 Windows Phone (包含在 SDK) 建議不要因為你可以不生成範本 (見下文) 與 VS 表示,由於它並沒有**匯出範本**功能,這是只有在 VS Pro 或更高。
+    ![][14]
 
-*   註冊和支付為[Windows Phone 開發中心][3]帳戶,如果你想要在實際設備上安裝您的應用程式或將其提交給市場的地方。
+*   在結果面板的底部,請按**環境變數**按鈕:
+    
+    ![][15]
 
- [1]: http://en.wikipedia.org/wiki/Second_Level_Address_Translation
- [2]: http://ark.intel.com/Products/VirtualizationTechnology
- [3]: http://dev.windowsphone.com/en-us/publish
+*   從**使用者變數**,選擇**路徑**,然後按**編輯**:
+    
+    ![][16]
+    
+    否則如果沒有**路徑**,按**新建**創建它。
 
-**注意**: 在虛擬機器中運行 SDK 可能會有一些挑戰。 您可以閱讀這篇博客,讓大家瞭解關於要為[在 Mac 上的 Windows Phone][4]開發的解決方案.
+*   如果一個路徑的值已經存在,追加一個分號和粘貼先前複製的路徑字串。否則只需粘貼字串:
+    
+    ![][17]
+    
+    這裡是一個示例**路徑**值,還可以指定 `npm` 安裝科爾多瓦 CLI 所需的實用程式:
+    
+    C:\Users\me\AppData\Roaming\npm ;C:\Windows\Microsoft.NET\Framework\v4.0.30319
 
- [4]: http://aka.ms/BuildaWP8apponaMac
+ [11]: img/guide/platforms/wp8/modpath_copy.png
+ [12]: img/guide/platforms/wp8/modpath_control_panel.png
+ [13]: img/guide/platforms/wp8/modpath_system.png
+ [14]: img/guide/platforms/wp8/modpath_advanced.png
+ [15]: img/guide/platforms/wp8/modpath_environment.png
+ [16]: img/guide/platforms/wp8/modpath_edit.png
+ [17]: img/guide/platforms/wp8/modpath_append.png
 
-## 安裝 SDK 和科爾多瓦
+## 創建一個新專案
 
-下載並安裝[Windows Phone SDK][5].
+此時,若要創建一個新的專案您可以選擇在命令列介面或一組特定的 Windows Phone 殼工具中所述的跨平臺 CLI 工具之間。 在原始程式碼目錄中,這裡是從 CLI 的辦法:
 
- [5]: http://www.microsoft.com/en-us/download/details.aspx?id=35471
+        > cordova create hello com.example.hello HelloWorld
+        > cd hello
+        > cordova platform add wp8
+    
 
-下載並解壓縮[科爾多瓦][6]的最新副本。`lib\windows-phone-8\wp8`子目錄是要你做的工作。
+這裡是相應的較低級別外殼工具方法:
 
- [6]: http://phonegap.com/download
+        C:\path\to\cordova-wp8\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld
+    
 
-複製 `CordovaWP8_x_x_x.zip` 檔到 `\My Documents\Visual
-Studio 2012\Templates\ProjectTemplates\` 目錄。
+## 生成專案
 
-## 建築範本
+如果您在開發中使用 CLI,專案目錄的頂級 `www` 目錄中包含的原始程式碼檔。運行任一內要重新生成應用程式的專案目錄:
 
-**注意**: 如果跳過這一步 `lib\windows-phone` 的目錄已經包含 `CordovaWP8_x_x_x.zip` 檔。
+        > cordova build
+        > cordova build wp8   # do not rebuild other platforms
+    
 
-為了簡化開發過程,科爾多瓦,將捆綁一個腳本來生成 Visual Studio 範本。 這些允許您迅速生成科爾多瓦的應用程式,如果有必要,您可以修改它們。 以下步驟顯示如何生成它。
+如果您使用的 Windows Phone 特定 shell 工具在發展中,有不同的方法。 一旦您生成該專案,預設應用程式的源是可用在 `projects\wp8\www` 子目錄。 隨後的命令都可用在 `cordova` 子目錄中同一級別的。
 
-### 運行該批次檔來創建和安裝範本
+`build`命令,清理專案檔案並重新生成應用程式。第一個示例將生成調試資訊,和第二個標誌發佈的應用程式:
 
-回購的根目錄中包含 `createTemplates.bat` 檔。 按兩下此生成兩個 `.zip` 檔: `CordovaWP7_x_x_x.zip` 和 `CordovaWP8_x_x_x.zip` ,其中*x.x.x*是的當前版本號。 若要使用這些檔很容易在 Visual Studio 中的,複製它們到 `My
-Documents\Visual Studio 2012\Templates\ProjectTemplates\` 。 然後,可以從**Visual Studio 檔 → 新建專案**功能表創建新的 Apache 科爾多瓦 Windows Phone 應用程式。
+        C:\path\to\project\cordova\build.bat --debug        
+        C:\path\to\project\cordova\build.bat --release
+    
 
-如果您從命令列運行該批次檔,也可以使用參數來自動安裝調用它:
+`clean`命令有助於沖洗掉下一步準備中的目錄 `build` :
 
-        > createTemplates.bat-安裝
+        C:\path\to\project\cordova\clean.bat
     
 
-## 設立了一個新的專案
+## 部署到模擬程式
 
-打開 Visual Studio 表示為 Windows Phone 和選擇**新的專案**.
+此時你可以使用 `cordova` CLI 實用程式將應用部署到模擬程式從命令列:
 
-選擇**CordovaWP8**。版本號將顯示在範本描述。
+        > cordova emulate wp8
+    
 
-為該專案的名稱,並選擇**確定**.
+否則請使用備用外殼介面:
 
-![][7]
+        C:\path\to\project\cordova\run
+    
 
- [7]: img/guide/platforms/wp8/StandAloneTemplate.png
+預設情況下, `run` 腳本調用該模擬程式標誌,並為其接受附加生成標誌, `--debug` 提供的預設值:
 
-## 審查的專案結構
+        C:\path\to\project\cordova\run --emulator --debug
+        C:\path\to\project\cordova\run --emulator --release
+        C:\path\to\project\cordova\run --emulator --nobuild
+    
+
+在啟動模擬器設備圖像與安裝的應用程式。 在主畫面中,導航到要啟動的**HelloWorld**應用程式的應用程式面板。這顯示了應用程式啟動,其次是其主介面其初始螢幕:
 
-`www`目錄功能 `html` , `js` ,和 `css` 子目錄和任何其他資源要求您的應用程式。 任何附加內容需要的 Visual Studio 專案的一部分,必須將它設置為內容。
+![][18]
 
-下面的示例結構表示一個 2.3.0 專案,但可能已安裝的版本而異:
+ [18]: img/guide/platforms/wp8/wp8_emulator.png
 
-![][8]
+設備螢幕右側頂部模擬程式的基本控制項允許您縱向和橫向方向之間切換。 **>**按鈕將打開更多的控制項使您可以測試更複雜的方向和姿態:
 
- [8]: img/guide/platforms/wp8/projectStructure.png
+![][19]
 
-## 生成並部署到模擬程式
+ [19]: img/guide/platforms/wp8/wp8_emulator_orient.png
 
-請確保在主要的下拉式功能表中選擇**Windows Phone 模擬器**。
+這些先進的控制項還允許您修改該設備的位置或類比動作序列:
 
-然後按綠色**播放**按鈕下拉式功能表中開始調試,或鍵入**F5**.
+![][20]
 
-![][9]
+ [20]: img/guide/platforms/wp8/wp8_emulator_loc.png
 
- [9]: img/guide/platforms/wp8/BuildEmulator.png
+## 將部署到設備
 
-## 為該設備生成專案
+在測試之前您的設備上的應用程式,必須註冊該設備。 有關如何部署和測試 Windows Phone 8 上的詳細資訊,請參考[微軟的文檔][21]。 此外,還要確保手機連接到電腦上,並在螢幕未鎖定。
 
-在測試之前您的設備上的應用程式,必須註冊該設備。 有關如何部署和測試 Windows Phone 8 上的詳細資訊,請參考[微軟的文檔][10]。 這些都是基本的步驟:
+ [21]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx
 
- [10]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx
+然後運行下面的 CLI 命令,要在設備上運行的應用程式:
+
+        > cordova run wp8
+    
+
+它對應于此較低級別 shell 命令:
+
+        C:\path\to\project\cordova\run --device
+    
 
-*   請確保您的電話連接,並且螢幕處於解鎖狀態。
+或者,如果您工作在 Visual Studio 中, **Windows Phone 設備**從功能表中選擇下拉在頂部,然後按綠色**播放**按鈕附近,或其他類型**F5**.
 
-*   在 Visual Studio 中,從頂部的下拉式功能表中選擇**設備**。
+## 修改在 SDK 中的專案
 
-*   按主要的下拉式功能表中,若要啟動調試,旁邊的綠色**播放**按鈕,否則鍵入**F5**.
+一旦你建立科爾多瓦 app,如上文所述,您可以使用 SDK 打開它。 各種 `build` 命令會生成一個 Visual Studio 解決方案 (*.sln*) 檔。 打開要修改內 Visual Studio 專案的檔。 基於 web 的原始程式碼,該代碼是在該專案內可用 `www` 目錄。 以及其他工具 SDK 提供,下面的功能表控制項使您可以啟動該應用程式在 Windows Phone 模擬器中:
 
-![][11]
+![][22]
+
+ [22]: img/guide/platforms/wp8/wp8_vs.png
+
+有關如何在您的工作流中使用科爾多瓦的命令列工具或 SDK 的建議諮詢概述。 科爾多瓦 CLI 依賴經常會覆蓋使用 SDK 的平臺特定檔的跨平臺原始程式碼。 如果你想要在 SDK 內工作,使用較低級別殼工具作為 CLI 的替代。
+
+## 對 Windows Phone 7 的支援
+
+它是那麼容易產生,它是為 Windows Phone 8,但它工作方式極其類似添加一個單獨的平臺是 Windows Phone 7 應用程式。 如果您使用的 CLI,只需指定 `wp7` 沿或而不是 `wp8` :
+
+        > cordova platform add wp7
+        > cordova build wp7
+        > cordova emulate wp7
+    
 
- [11]: img/guide/platforms/wp7/wpd.png
+`emulate`命令生成 Windows Phone 7 設備模擬程式顯示一個不同的介面:
 
-此時,你完了。
+![][23]
 
-## 進一步閱讀
+ [23]: img/guide/platforms/wp8/wp7_emulator.png
 
-Windows Phone 開發者博客 IE10 和 WebKit 的瀏覽器和如何支援這兩個之間的差異提供[有用的詳細資訊][12]。
+如果您正在使用的平臺為中心殼工具工作流,所有的步驟*安裝科爾多瓦外殼工具*以上,部分中除了提取工具從 `cordova-wp8\wp7` 目錄相反。 所有這些工具的工作相同,其 `wp8` 同行。
 
- [12]: http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx
\ No newline at end of file
+**注**: WebViews 舉 Windows Phone 7 科爾多瓦應用程式不要*使用互聯網資源管理器中 10 作為他們的呈現引擎,*並因而錯過一些先進的 Windows Phone 8 的應用程式中可用的功能。 仍然,兩者都執行相同的 Api 集。 您可以對 Windows Phone 8 設備,但不是運行 Windows Phone 7 應用程式: Windows Phone 8 應用程式*不*在 Windows Phone 7 設備上運行。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/513a1fa1/docs/zh/edge/guide/platforms/wp8/parallels.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/wp8/parallels.md b/docs/zh/edge/guide/platforms/wp8/parallels.md
new file mode 100644
index 0000000..9a3eb2b
--- /dev/null
+++ b/docs/zh/edge/guide/platforms/wp8/parallels.md
@@ -0,0 +1,36 @@
+— — 許可證: 下一個或多個參與者授權合約許可向阿帕奇軟體基金會 (ASF)。 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.
+---
+
+# 配置 512mb
+
+這一節演示如何在 Mac 上配置的相似之處桌面,以便您可以使用科爾多瓦生成 Windows Phone 應用程式。
+
+[Microsoft 開發人員網路][1]提供有關如何運行 Windows 的相似之處的桌面下的一般說明。 之後安裝 Windows,請執行以下步驟:
+
+ [1]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945424
+
+1.  在桌面的相似之處內, 選擇您已經準備好的 Windows 8 磁片映射並選擇**設置**.
+
+2.  選擇的**一般 → Cpu**選項。指定*兩個*Cpu。指定至少 2 GB 的記憶體,即使它不屬於建議的範圍:
+    
+    ![][2]
+
+3.  要能運行 Windows 8 虛擬機器中的設備模擬程式圖像,選擇**優化**選項並啟用**嵌套的虛擬化**.
+    
+    ![][3]
+
+ [2]: img/guide/platforms/wp8/parallel_cpu_opts.png
+ [3]: img/guide/platforms/wp8/parallel_optimize_opts.png
+
+一旦你完成這些步驟,您就可以安裝 Windows Phone SDK。請參閱 Windows Phone 平臺指南的詳細資訊。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/513a1fa1/docs/zh/edge/guide/platforms/wp8/plugin.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/wp8/plugin.md b/docs/zh/edge/guide/platforms/wp8/plugin.md
index 2a406c1..7c23959 100644
--- a/docs/zh/edge/guide/platforms/wp8/plugin.md
+++ b/docs/zh/edge/guide/platforms/wp8/plugin.md
@@ -134,6 +134,14 @@ JavaScript 會需要調用 `exec` 像這樣:
         }
     
 
+## 外掛程式使用壽命
+
+外掛程式需要長時間運行的請求,如媒體重播、 聽眾,保持內部狀態應執行的背景活動 `onReset` 方法來清理這些活動。 當 CordovaView webbrowser 控制項導航到新的一頁或刷新,重新載入 JavaScript 運行方法。
+
+        // defined in WPCordovaClassLib.Cordova.Commands.BaseCommand
+        public virtual void OnReset() { }
+    
+
 ## 外掛程式 XML
 
 下面演示如何使用 `plugin.xml` 檔來指定外掛程式的原始程式碼檔在 Windows Phone 平臺上。 請參閱應用程式外掛程式概述和外掛程式規範有關可用選項的詳細資訊。