cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dblot...@apache.org
Subject [34/51] [partial] docs commit: Adding both Chinese versions.
Date Wed, 06 Apr 2016 09:27:50 GMT
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.4.0/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.4.0/guide/platforms/ios/config.md b/www/docs/zh-cn/3.4.0/guide/platforms/ios/config.md
new file mode 100644
index 0000000..fd82d0f
--- /dev/null
+++ b/www/docs/zh-cn/3.4.0/guide/platforms/ios/config.md
@@ -0,0 +1,89 @@
+---
+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"/>
+        
+    
+    放置在 HTML 中禁用縮放和適合的視口,如下內容靈活地內呈現 web 視圖:
+    
+        < 元名稱 = '視' 內容 =' 寬度 = 設備-寬度,初始規模 = 1,使用者可擴展 = no' / >
+        
+
+*   `MediaPlaybackRequiresUserAction`(boolean 類型的值,預設值為 `false` ): 設置為 `true` 以防止與自動播放 HTML5 視頻或音訊 `autoplay` 屬性或通過 JavaScript。
+    
+        <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"/>
+        
+
+*   `KeyboardDisplayRequiresUserAction`(boolean 類型的值,預設值為 `true` ): 設置為 `false` ,允許鍵盤出現在調用時 `focus()` 形式投入。
+    
+        <preference name="KeyboardDisplayRequiresUserAction" value="false"/>
+        
+
+*   `SuppressesIncrementalRendering`(boolean 類型的值,預設值為 `false` ): 設置為 `true` 等待,直到在呈現到螢幕之前已收到的所有內容。
+    
+        <preference name="SuppressesIncrementalRendering" value="true"/>
+        
+
+*   `GapBetweenPages`(浮動,預設值為 `` ): 的大小,以磅為單位,頁面之間的差距。
+    
+        <preference name="GapBetweenPages" value="0"/>
+        
+
+*   `PageLength`(浮動,預設值為 `` ): 中點,在頁面流的方向每個頁面的大小。 當 PaginationMode 是從右至左或從左至右,此屬性工作表示每個頁面的寬度。 PaginationMode topToBottom 或 bottomToTop 時,此屬性工作表示每個頁面的高度。 預設值為 0,這意味著佈局使用視區的大小來確定頁面的尺寸。
+    
+        <preference name="PageLength" value="0"/>
+        
+
+*   `PaginationBreakingMode`(字串,預設值為 `page` ): 有效的值為 `page` 和 `column` 。在列或頁斷發生的方式。 此屬性確定是否某些 CSS 屬性關於列和頁打破是榮幸還是忽略。 當此屬性設置為 `column` ,內容尊重相關的頁斷的地方斷列的 CSS 屬性。
+    
+        <preference name="PaginationBreakingMode" value="page"/>
+        
+
+*   `PaginationMode`(字串,預設值為 `unpaginated` ): 有效的值為 `unpaginated` , `leftToRight` , `topToBottom` , `bottomToTop` ,和 `rightToLeft` 。 此屬性確定是否在 web 視圖中的內容劃分為一次填充視圖一螢幕的頁或一個長的滾動視圖所示。 如果設置為一個分頁的表單,此屬性切換分頁的佈局上的內容,導致其內容的 web 視圖使用重新佈局的 PageLength 和 GapBetweenPages 的值。
+    
+        <preference name="PaginationMode" value="unpaginated"/>
+        
+
+*   `UIWebViewDecelerationSpeed`(字串,預設值為 `normal` ): 有效的值為 `normal` , `fast` 。 此屬性控制減速勢頭滾動。 `normal`是大多數本機應用程式,預設的速度和 `fast` 的移動版 Safari 是預設的。
+    
+        <preference name="UIWebViewDecelerationSpeed" value="fast" />
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.4.0/guide/platforms/ios/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.4.0/guide/platforms/ios/index.md b/www/docs/zh-cn/3.4.0/guide/platforms/ios/index.md
new file mode 100644
index 0000000..adb129c
--- /dev/null
+++ b/www/docs/zh-cn/3.4.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 設備 (如 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.4.0/guide/platforms/ios/plugin.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.4.0/guide/platforms/ios/plugin.md b/www/docs/zh-cn/3.4.0/guide/platforms/ios/plugin.md
new file mode 100644
index 0000000..03927bc
--- /dev/null
+++ b/www/docs/zh-cn/3.4.0/guide/platforms/ios/plugin.md
@@ -0,0 +1,184 @@
+---
+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 外掛程式
+
+此部分提供了如何在 iOS 平臺上實現本機外掛程式代碼的詳細資訊。 之前讀這篇文章,請參閱應用程式外掛程式外掛程式的結構和其共同的 JavaScript 介面的概述。 這一節繼續表明通信從科爾多瓦 web 視圖的本機平臺和後面的示例*回聲*外掛程式。
+
+IOS 外掛程式作為擴展目標 C 類實現 `CDVPlugin` 類。 對於 JavaScript 的 `exec` 方法的 `service` 參數將映射到一個目標 C 類,每個外掛程式必須註冊為 `<feature>` 標記命名的應用程式目錄中 `config.xml` 檔。
+
+## 外掛程式類映射
+
+一個外掛程式的 JavaScript 部分使用 `cordova.exec` 方法,如下所示:
+
+        exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
+    
+
+這封送一個請求從 `UIWebView` 到 iOS 本機一側,有效地調用 `action` 方法在 `service` 類,傳入的參數中的 `args` 陣列。
+
+指定作為外掛程式 `<feature>` 科爾多瓦 iOS 應用程式專案中的標記 `config.xml` 檔,使用 `plugin.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` 到 `true` 在 `config.xml` 檔:
+
+        <feature name="Echo">
+            <param name="ios-package" value="Echo" />
+            <param name="onload" value="true" />
+        </feature>
+    
+
+有*沒有*指定外掛程式的初始值設定項。相反,應使用外掛程式 `pluginInitialize` 為其啟動邏輯方法。
+
+外掛程式需要長時間運行的請求,如媒體重播、 聽眾,保持內部狀態應執行的背景活動 `onReset` 方法來清理這些活動。 在方法運行時 `UIWebView` 定位到新的一頁或刷新,重新載入 JavaScript。
+
+## 寫作 iOS 科爾多瓦外掛程式
+
+JavaScript 調用觸發外掛程式請求到本機的一邊,和相應的 iOS 目標 C 外掛程式映射正確地在 `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];
+        }
+    
+
+有關更多詳細資訊,請參見 `[CDVInvokedUrlCommand.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVInvokedUrlCommand.h)` , `[CDVPluginResult.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPluginResult.h)` ,和`[CDVCommandDelegate.h](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 回檔。 同樣,任何 `ArrayBuffer` JavaScript 發送到一個外掛程式都將轉換為`NSData*`.
+
+*   `messageAsMultipart`預計, `NSArray*` 包含任何其他支援類型,並將發送整個陣列作為 `arguments` 給您的 JavaScript 回檔。 這種方式,所有參數在序列化或反序列化作為必要的所以它是能夠安全返回 `NSData*` 作為多部分,但不是 `Array` /`Dictionary`.
+
+## 回聲 iOS 外掛程式示例
+
+若要匹配的 JavaScript 介面*回波*特徵描述的應用程式外掛程式,使用 `plugin.xml` 來注入 `feature` 到本地平臺規範 `config.xml` 檔:
+
+        <platform name="ios">
+            <config-file target="config.xml" parent="/*">
+                <feature name="Echo">
+                    <param name="ios-package" value="Echo" />
+                </feature>
+            </config-file>
+        </platform>
+    
+
+然後我們將添加以下 `Echo.h` 和 `Echo.m` 檔到 `Plugins` 內科爾多瓦 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` 方法獲取的第一個參數 `arguments` 對應于參數的陣列通過 JavaScript 在 `exec()` 函數。
+
+它會檢查該參數,以確保它不是 `nil` 或空字串,返回 `PluginResult` 與 `ERROR` 如果是這樣的狀態。 如果該參數通過檢查,它返回 `PluginResult` 與 `OK` 狀態,在原始中傳遞 `echo` 的字串。 最後,它將發送結果到 `self.commandDelegate` ,其中執行 `exec` 方法的成功或失敗回檔 JavaScript 一邊。 如果成功回檔被調用,它將通過在 `echo` 參數。
+
+## iOS 一體化
+
+`CDVPlugin`類功能其他你的外掛程式可以重寫的方法。 例如,您可以捕獲 `pause` , `resume` ,應用程式終止和 `handleOpenURL` 事件。 請參見[CDVPlugin.h][1]和[CDVPlugin.m][2]類的指導。
+
+ [1]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.h
+ [2]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.m
+
+## 執行緒
+
+外掛程式方法通常在主介面相同的執行緒中執行。 如果你的外掛程式需要大量的處理,或者需要一個阻塞調用,則應使用後臺執行緒。 例如:
+
+        - (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];
+            }];
+        }
+    
+
+## 調試 iOS 外掛程式
+
+若要調試的目標 C 一邊,你需要 Xcode 的內置調試器。 對於 JavaScript,在 iOS 5.0 可以使用[Weinre、 Apache 科爾多瓦專案][3]或[iWebInspector、 一個協力廠商實用程式][4]。 Ios 6,您可以向您的應用程式運行在 iOS 6 模擬器附加 Safari 6.0。
+
+ [3]: https://github.com/apache/cordova-weinre
+ [4]: http://www.iwebinspector.com/
+
+## 常見的陷阱
+
+*   別忘了添加到您的腳本映射 `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.4.0/guide/platforms/ios/tools.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.4.0/guide/platforms/ios/tools.md b/www/docs/zh-cn/3.4.0/guide/platforms/ios/tools.md
new file mode 100644
index 0000000..f4d4b8e
--- /dev/null
+++ b/www/docs/zh-cn/3.4.0/guide/platforms/ios/tools.md
@@ -0,0 +1,57 @@
+---
+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`.
+
+低級命令列介面,它使外掛程式的資訊,請參閱使用 Plugman 到管理外掛程式。有關概述,請參見應用程式外掛程式。
+
+## 創建一個專案
+
+運行 `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

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.4.0/guide/platforms/ios/upgrading.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.4.0/guide/platforms/ios/upgrading.md b/www/docs/zh-cn/3.4.0/guide/platforms/ios/upgrading.md
new file mode 100644
index 0000000..f2ccbb1
--- /dev/null
+++ b/www/docs/zh-cn/3.4.0/guide/platforms/ios/upgrading.md
@@ -0,0 +1,754 @@
+---
+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
+
+本指南演示如何修改 iOS 專案從科爾多瓦的舊版本進行升級。 大多數這些說明適用于與舊集的前面的命令列工具創建的專案 `cordova` CLI 實用程式。 命令列介面資訊,請參閱如何更新的 CLI 版本。
+
+**注**: Xcode 4.6 必需的推薦 Xcode 5。 目前,以提交到蘋果 App Store,你應使用最新的產品出廠的版本的 iOS SDK,這是 iOS 7。 iOS 7 SDK 尚不需要,但這可能會很快改變。
+
+## 升級 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>` :
+    
+        < 外掛程式名稱 = 值"InAppBrowser"="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 路徑/為/您/專案/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/local/lib/include"
+        
+        "$(OBJROOT)/UninstalledProducts/include"
+        
+        "$(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/a890e4de/www/docs/zh-cn/3.4.0/guide/platforms/ios/webview.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.4.0/guide/platforms/ios/webview.md b/www/docs/zh-cn/3.4.0/guide/platforms/ios/webview.md
new file mode 100644
index 0000000..e4059e2
--- /dev/null
+++ b/www/docs/zh-cn/3.4.0/guide/platforms/ios/webview.md
@@ -0,0 +1,158 @@
+---
+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: WebViews iOS
+---
+
+# WebViews iOS
+
+這一節演示如何嵌入在一個較大的 iOS 應用程式內的科爾多瓦啟用 web 視圖元件。這些元件可以如何與對方溝通的詳細資訊,請參閱應用程式外掛程式。
+
+支援的 iOS WebViews 開始與科爾多瓦版本 1.4,使用 `Cleaver` 的 Xcode 範本用作參考實現的元件。 科爾多瓦 2.0 及更高版本僅支援基於子專案的刀實施。
+
+這些說明至少需要科爾多瓦 2.3 和 Xcode 4.5,沿與 `config.xml` 從新創建的 iOS 專案檔案。 你可以使用程式的命令列介面來創建一個新專案,然後獲取 `config.xml` 從檔中的命名的應用程式子目錄內`platforms/ios`.
+
+要按照這些說明進行操作,請確保您有最新的科爾多瓦分佈。從[cordova.apache.org][1]下載並解壓其 iOS 包。
+
+ [1]: http://cordova.apache.org
+
+## 將刀添加到 Xcode 專案 (CordovaLib 子專案)
+
+1.  如果它正在運行,請退出 Xcode。
+
+2.  打開一個終端並導航到科爾多瓦 iOS 的原始目錄。
+
+3.  複製 `config.xml` 檔到專案目錄上文所述。
+
+4.  打開 Xcode 並使用 Finder 來複製 `config.xml` 檔到其**專案導航**視窗。
+
+5.  選擇**創建組的任何添加的資料夾**,然後按**完成**.
+
+6.  使用 Finder 來複製 `CordovaLib/CordovaLib.xcodeproj` 檔到 Xcode 的**專案導航器**
+
+7.  選擇 `CordovaLib.xcodeproj` 內**專案導航器**.
+
+8.  鍵入**選項-命令-1**鍵的組合,以顯示**檔檢查器**.
+
+9.  選擇**相對於組****檔檢查器**器下拉式功能表中的**位置**.
+
+10. 在**導航專案**中選擇**專案圖示**,選擇**目標**,然後選擇**生成設置**選項卡。
+
+11. 添加 `-force_load` 和 `-Obj-C` 的**其他連結器標誌**值。
+
+12. 按一下專案導航器中的**專案圖示**,選擇**目標**,然後選擇**生成階段**選項卡。
+
+13. 展開**連結二進位檔案與庫**.
+
+14. 選擇**+**按鈕,然後添加下列**框架**。 (可選) 在**導航專案**內, 移動它們**框架**組下:
+    
+        AddressBook.framework
+        AddressBookUI.framework
+        AudioToolbox.framework
+        AVFoundation.framework
+        CoreLocation.framework
+        MediaPlayer.framework
+        QuartzCore.framework
+        SystemConfiguration.framework
+        MobileCoreServices.framework
+        CoreMedia.framework
+        
+
+15. 擴展**目標的依賴關係**,與該標籤,如果有多個框頂部的框。
+
+16. 選擇**+**按鈕,然後添加 `CordovaLib` 生成產品。
+
+17. 展開**連結與庫的二進位檔案**,與該標籤,如果有多個框頂部的框。
+
+18. 選擇**+**按鈕,然後添加`libCordova.a`.
+
+19. 設置**Xcode 首選項 → 位置 → 派生資料 → 高級...**到**獨特**.
+
+20. 在專案導航器中選擇**專案圖示**,選擇你的**目標**,然後選擇**生成設置**選項卡。
+
+21. 搜索**標題搜索路徑**。該設置,添加這三個值以下,包括引號:
+    
+        "$(TARGET_BUILD_DIR)/usr/local/lib/include"        
+        "$(OBJROOT)/UninstalledProducts/include"
+        "$(BUILT_PRODUCTS_DIR)"
+        
+    
+    科爾多瓦 2.1.0,如 `CordovaLib` 已升級為使用**自動引用計數 (弧)**。 你不需要升級到**弧**要使用 `CordovaLib` ,但如果您想要升級您的專案使用**弧**,則應使用 Xcode 遷移嚮導從**編輯 → 重構 → 轉換為目標 C 弧...**功能表中,**取消選擇 libCordova.a**,然後運行嚮導完成。
+
+## 使用 CDVViewController
+
+1.  添加以下標頭:
+    
+        #import <Cordova/CDVViewController.h>
+        
+
+2.  具現化一個新的 `CDVViewController` 和保留它在某個地方,例如,到類的屬性:
+    
+        CDVViewController* viewController = [CDVViewController new];
+        
+
+3.  (可選) 設置 `wwwFolderName` 屬性,預設為 `www` :
+    
+        viewController.wwwFolderName = @"myfolder";
+        
+
+4.  (可選) 設置的起始頁 `config.xml` 檔的 `<content>` 標記,或者本地的檔:
+    
+        <content src="index.html" />
+        
+    
+    ...或是遠端站台:
+    
+        <content src="http://apache.org" />
+        
+
+5.  (可選) 設置 `useSplashScreen` 屬性,預設為 `NO` :
+    
+        viewController.useSplashScreen = YES;
+        
+
+6.  設置**視圖框架**。始終設置為最後一個屬性:
+    
+        viewController.view.frame = CGRectMake(0, 0, 320, 480);
+        
+
+7.  向視圖添加刀:
+    
+        [myView addSubview:viewController.view];
+        
+
+## 添加 HTML、 CSS 和 JavaScript 資產
+
+1.  創建一個新的目錄,在專案中, `www` 為例。
+
+2.  將 HTML、 CSS 和 JavaScript 資產放到此目錄。
+
+3.  使用 Finder 將目錄複寫到 Xcode 的**專案導航**視窗。
+
+4.  選擇**任何添加的資料夾創建資料夾的參考檔**.
+
+5.  設置相應的 `wwwFolderName` 和 `startPage` 你最初創建的目錄的屬性或使用預設值 (在上一節中指定) 時具現化`CDVViewController`.
+    
+        /*
+         if you created a folder called 'myfolder' and
+         you want the file 'mypage.html' in it to be
+         the startPage
+        */
+        viewController.wwwFolderName = @"myfolder";
+        viewController.startPage = @"mypage.html"
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.4.0/guide/platforms/tizen/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.4.0/guide/platforms/tizen/index.md b/www/docs/zh-cn/3.4.0/guide/platforms/tizen/index.md
new file mode 100644
index 0000000..e904a93
--- /dev/null
+++ b/www/docs/zh-cn/3.4.0/guide/platforms/tizen/index.md
@@ -0,0 +1,118 @@
+---
+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: Tizen 平臺指南
+---
+
+# Tizen 平臺指南
+
+本指南介紹了如何設置您的 SDK 開發環境部署科爾多瓦運行 Tizen 作業系統的設備的應用程式。
+
+## 要求和支援
+
+Tizen SDK 需要 Linux Ubuntu 10.04/10.10/11.04/11.10 (32 位) 或 Windows XP SP3/7 (32 位)。
+
+開發人員應使用 `cordova` 實用程式 Tizen SDK 的結合。 命令列介面資訊,請參閱如何安裝它,添加專案,然後生成和部署專案。
+
+## 安裝 SDK
+
+從[tizen.org][1]下載 Tizen SDK.
+
+ [1]: https://developer.tizen.org/sdk
+
+<!--
+
+- (optional) Install Tizen Cordova template projects: copy the
+  `/templates` directory content into the Tizen Eclipse IDE web
+  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__)
+    - Fill the __Project name__ and its target __Location__
+
+    ![]({{ site.baseurl }}/static/img/guide/platforms/tizen/project_template.png)
+
+    - Click __Finish__
+
+    ![]({{ site.baseurl }}/static/img/guide/platforms/tizen/project_explorer.png)
+
+    - Your project should now appear in the __Project Explorer__ view
+
+-->
+
+## 在 SDK 中打開的專案
+
+1.  推出 Tizen Eclipse IDE。
+
+2.  選擇**檔 → 導入 → Tizen Web 專案**:
+    
+    ![][2]
+
+3.  按**下一步**.
+
+4.  請確保選中了**選擇根目錄**。
+
+5.  請確保選中了**複製到工作區中的專案**。
+
+6.  按**流覽**並選擇科爾多瓦 Tizen `samples` 專案目錄 (如 `/cordova-basic` ):
+    
+    ![][3]
+
+7.  按**完成**。您的專案現在應該將其導入並出現在**專案資源管理器**視圖中:
+    
+    ![][4]
+
+ [2]: {{ site.baseurl }}/static/img/guide/platforms/tizen/import_project.png
+ [3]: {{ site.baseurl }}/static/img/guide/platforms/tizen/import_widget.png
+ [4]: {{ site.baseurl }}/static/img/guide/platforms/tizen/project_explorer.png
+
+重新生成專案,在**專案資源管理器**視圖中按右鍵並選擇**生成專案**:
+
+![][5]
+
+ [5]: {{ site.baseurl }}/static/img/guide/platforms/tizen/build_project.png
+
+如*hello.wgt*的小部件包檔應在專案的根目錄中生成。
+
+## 部署到模擬程式
+
+用滑鼠右鍵按一下**專案資源管理器**視圖中的專案並選擇**運行作為 → Tizen Web 模擬器應用程式**:
+
+![][6]
+
+ [6]: {{ site.baseurl }}/static/img/guide/platforms/tizen/runas_web_sim_app.png
+
+## 將部署到設備
+
+*   請確保目標設備正常啟動、 連接和配置。必須正確設置其**日期和時間**設置。
+
+*   使用**連接資源管理器**視圖選擇的應用程式部署目標:**視窗顯示視圖 → 連接資源管理器**.
+    
+    ![][7]
+
+*   用滑鼠右鍵按一下該專案,在**專案資源管理器**視圖,然後選擇 Run As **& rarr;Tizen Web 應用程式**:
+    
+    ![][8]
+
+ [7]: {{ site.baseurl }}/static/img/guide/platforms/tizen/connection_explorer.png
+ [8]: {{ site.baseurl }}/static/img/guide/platforms/tizen/runas_web_app.png

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.4.0/guide/platforms/ubuntu/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.4.0/guide/platforms/ubuntu/index.md b/www/docs/zh-cn/3.4.0/guide/platforms/ubuntu/index.md
new file mode 100644
index 0000000..07da48f
--- /dev/null
+++ b/www/docs/zh-cn/3.4.0/guide/platforms/ubuntu/index.md
@@ -0,0 +1,95 @@
+---
+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: Ubuntu 平臺指南
+---
+
+# Ubuntu 平臺指南
+
+## 初始版本
+
+歡迎來到科爾多瓦 Ubuntu 平臺支援的初始版本。 此版本中,重點是在 Ubuntu 的系統上開發和使用科爾多瓦 Web 專案開發工作流。 這包括將 Ubuntu 平臺添加到您的專案,添加標準科爾多瓦外掛程式,,當然,建設和運行的 Ubuntu 平臺的應用程式。
+
+### Ubuntu SDK
+
+您還可能想要安裝 Ubuntu QtCreator 開發環境。 請參閱[developer.ubuntu.com][1]為更多的資訊。 (QtCreator SDK 不是需要將 Ubuntu 平臺支援添加到應用程式科爾多瓦。)
+
+ [1]: http://developer.ubuntu.com
+
+### Ubuntu 運行時平臺
+
+Ubuntu 是知名的為其桌面環境 (用於筆記本電腦、 Pc 和此類)。 Ubuntu 觸摸延伸到手機和平板電腦上的 Ubuntu 作業系統。 Ubuntu 運行時平臺有不同的 CPU 體系結構 (x 86,armhf,等.)。 必須適當地編譯外掛程式和應用程式代碼。 對此廣泛領域的支援正在迅速演變在 Ubuntu 中。
+
+### 最新資訊
+
+科爾多瓦 app 支援 Ubuntu 運行時平臺的最新資訊,請參閱[wiki.ubuntu.com/Cordova][2].
+
+ [2]: http://wiki.ubuntu.com/Cordova
+
+## 發展平臺要求
+
+此初始發行版本的開發平臺應該是 Ubuntu 桌面。Ubuntu 13.10 (代號 '曖昧') 或更高版本需要享受完整的支援的功能集。
+
+你可以安裝科爾多瓦非 Ubuntu 使用在系統上 (故宮),但重要的能力,在這個時候只提供通過 Ubuntu debian 套裝軟體。
+
+## 科爾多瓦安裝
+
+添加到您的 Ubuntu 系統 Ubuntu 科爾多瓦[個人包存檔][3]:
+
+ [3]: https://launchpad.net/~cordova-ubuntu/+archive/ppa
+
+    $ sudo add-apt-repository ppa:cordova-ubuntu/ppa
+    $ sudo apt-get update
+    
+
+安裝科爾多瓦 cli 包 (和它的依賴項):
+
+    $ sudo apt-get install cordova-cli
+    
+
+## 專案工作流
+
+### 創建一個專案
+
+    $ cordova create project1 REVERSEDNSNAME.project1 project1
+    
+
+### 移動到專案目錄
+
+    $ cd project1
+    
+
+### 添加 Ubuntu 平臺
+
+    $ cordova platform add ubuntu
+    
+
+### Ubuntu 的生成
+
+    $ cordova build ubuntu
+    
+
+### 運行應用程式
+
+    $ cordova run ubuntu
+    
+
+### 添加電池狀態外掛程式
+
+    $ cordova plugin add org.apache.cordova.battery-status
\ 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