You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by sh...@apache.org on 2014/01/30 22:20:57 UTC
[05/57] [abbrv] CB-5931 1/28 push latest of edge for chinese
simplified Cordova 3.4
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/guide/platforms/ios/index.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/ios/index.md b/docs/zh/edge/guide/platforms/ios/index.md
index 947d40b..12cb849 100644
--- a/docs/zh/edge/guide/platforms/ios/index.md
+++ b/docs/zh/edge/guide/platforms/ios/index.md
@@ -14,42 +14,42 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
under the License.
---
-# iOS 平臺指南
+# iOS 平台指南
-本指南介紹如何設置您的 SDK 開發環境部署科爾多瓦的 iOS 設備 （如 iPhone 和 iPad 的應用程式。請參閱下列特定于平臺的詳細資訊：
+本指南介绍如何设置您的 SDK 开发环境部署科尔多瓦的 iOS 设备 （如 iPhone 和 iPad 的应用程序。请参阅下列特定于平台的详细信息：
* iOS 配置
-* 升級 iOS
-* WebViews iOS
-* iOS 外掛程式
-* iOS 命令列工具
+* 升级 iOS
+* iOS WebViews
+* iOS 插件
+* iOS 命令行工具
-上面的命令列工具請參閱科爾多瓦 3.0 以前的版本。關於當前介面的資訊，請參閱命令列介面。
+上面的命令行工具请参阅科尔多瓦 3.0 以前的版本。关于当前界面的信息，请参阅命令行界面。
-## 要求和支援
+## 要求和支持
-蘋果公司 ® 生成僅在基於英特爾的 Mac OS X 作業系統上運行的 iOS 應用程式所需的工具。 僅在 OS X 10.7 (獅子) 版本上運行 Xcode ® 4.5 (要求的最低版本） 或更大，並包括 iOS 6 SDK （軟體發展工具組）。 要提交到蘋果 App Store℠ 的應用程式需要的蘋果工具的最新版本。
+苹果公司 ® 生成仅在基于英特尔的 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 模擬器，不必註冊開發者計畫。
+您可以测试的许多科尔多瓦功能使用 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
+## 安装 SDK
-有兩種方法可以下載 Xcode：
+有两种方法可以下载 Xcode：
-* 從[應用程式商店][2]，可通過搜索"Xcode"在**App Store**中的應用。
+* 从[应用程序商店][2]，可通过搜索"Xcode"在**App Store**中的应用。
-* 從[蘋果開發者下載][3]，而作為蘋果開發者需要註冊。
+* 从[苹果开发者下载][3]，而作为苹果开发者需要注册。
[2]: https://itunes.apple.com/us/app/xcode/id497799835?mt=12
[3]: https://developer.apple.com/downloads/index.action
-一旦安裝了 Xcode，幾個命令列工具需要為科爾多瓦運行啟用。 從**Xcode**功能表中，選擇**首選項**，然後**下載**選項卡。 從**元件**面板中，按**命令列工具**清單旁邊的**安裝**按鈕。
+一旦安装了 Xcode，几个命令行工具需要为科尔多瓦运行启用。 从**Xcode**菜单中，选择**首选项**，然后**下载**选项卡。 从**组件**面板中，按**命令行工具**列表旁边的**安装**按钮。
-## 在 SDK 中打開的專案
+## 在 SDK 中打开的项目
-使用 `cordova` 實用程式設置了一個新的專案，如所述在科爾多瓦命令列介面。例如，在原始程式碼中的目錄：
+使用 `cordova` 实用程序设置了一个新的项目，如所述在科尔多瓦命令行界面。例如，在源代码中的目录：
$ cordova create hello com.example.hello "HelloWorld"
$ cd hello
@@ -57,104 +57,104 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
$ cordova prepare # or "cordova build"
-創建後，您可以在 Xcode 內打開它從。按兩下打開 `hello/platforms/ios/hello.xcodeproj` 檔。螢幕應該如下所示：
+创建后，您可以在 Xcode 内打开它从。双击打开 `hello/platforms/ios/hello.xcodeproj` 文件。屏幕应该如下所示：
![][4]
[4]: img/guide/platforms/ios/helloworld_project.png
-## 部署到模擬程式
+## 部署到仿真程序
-若要預覽 iOS 模擬器中的應用程式：
+若要预览 iOS 模拟器中的应用程序：
-1. 請確保在左邊的面板中選擇*.xcodeproj*檔。
+1. 请确保在左边的面板中选择*.xcodeproj*文件。
-2. 選擇**你好**app 立即向右面板中。
+2. 选择**你好**app 立即向右面板中。
-3. 從工具列上的**計畫**功能表中選擇預定的設備、 iPhone 等作為 6.0 模擬器在這裡突出了：
+3. 从工具栏上的**计划**菜单中选择预定的设备、 iPhone 等作为 6.0 模拟器在这里突出了：
![][5]
-4. 按下**運行**按鈕出現在同一工具列左側的**計畫**中。 那生成、 部署並在模擬器中運行應用程式。 一個單獨的模擬器應用程式將打開，並顯示該應用程式：
+4. 按下**运行**按钮出现在同一工具栏左侧的**计划**中。 那生成、 部署并在模拟器中运行应用程序。 一个单独的仿真器应用程序将打开，并显示该应用程序：
![][6]
- 只有一個模擬程式可能會運行一次，所以如果你想要在不同的模擬器中測試應用程式，您需要退出的模擬程式應用程式和運行一個不同的目標在 Xcode 的範圍內。
+ 只有一个仿真程序可能会运行一次，所以如果你想要在不同的仿真器中测试应用程序，您需要退出的仿真程序应用程序和运行一个不同的目标在 Xcode 的范围内。
[5]: img/guide/platforms/ios/select_xcode_scheme.png
[6]: img/guide/platforms/ios/HelloWorldStandard.png
-Xcode 捆綁了模擬器為最新版本的 iPhone 和 iPad。 較舊的版本中可能會提供**Xcode → 首選項 → 下載 → 元件**面板。
+Xcode 捆绑了仿真器为最新版本的 iPhone 和 iPad。 较旧的版本中可能会提供**Xcode → 首选项 → 下载 → 组件**面板。
-## 將部署到設備
+## 将部署到设备
-有關各項要求，部署到一個設備的詳細資訊，請參閱蘋果的[iOS 工具工作流指南][7]的*配置開發和分配資產*部分。 簡單地說，您需要部署之前執行以下操作：
+有关各项要求，部署到一个设备的详细信息，请参阅苹果的[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 開發者計畫。
+1. 加入苹果 iOS 开发者计划。
-2. 創建*資源調配設定檔*內[iOS 資源調配門戶][8]。 您可以使用其*發展資源調配助理*來創建和安裝設定檔和證書 Xcode 需要。
+2. 创建*资源调配配置文件*内[iOS 资源调配门户][8]。 您可以使用其*发展资源调配助理*来创建和安装配置文件和证书 Xcode 需要。
-3. 驗證*代碼簽名*部分*代碼簽名標識*內的專案設置設置為您設置的設定檔名稱。
+3. 验证*代码签名*部分*代码签名标识*内的项目设置设置为您设置的配置文件名称。
[8]: https://developer.apple.com/ios/manage/overview/index.action
-若要部署到設備：
+若要部署到设备：
-1. 使用 USB 電纜將設備插入到您的 mac。
+1. 使用 USB 电缆将设备插入到您的 mac。
-2. Xcode 視窗**計畫**下拉清單中選擇的專案的名稱。
+2. Xcode 窗口**计划**下拉列表中选择的项目的名称。
-3. 從**設備**下拉清單中選擇您的設備。如果它通過 USB 連接電源，但仍然沒有出現，請按**管理器**按鈕，以解決任何錯誤。
+3. 从**设备**下拉列表中选择您的设备。如果它通过 USB 连接电源，但仍然没有出现，请按**管理器**按钮，以解决任何错误。
-4. 按下**運行**按鈕以生成、 部署並運行該應用程式在您的設備上。
+4. 按下**运行**按钮以生成、 部署并运行该应用程序在您的设备上。
-## 常見的問題
+## 常见的问题
-**否決警告：**當應用程式更改或替換為另一個 API 程式設計介面 (API) 時，它被標記為*已過時*。 API 仍可工作，短期內，但最終將被刪除。 這些過時的介面的一些反映在 Apache 科爾多瓦和 Xcode 問題對他們的警告您在生成和部署應用程式時。
+**否决警告**： 当应用程序更改或替换为另一个 API 编程接口 (API) 时，它被标记为*已过时*。 API 仍可工作，短期内，但最终将被删除。 这些过时的接口的一些反映在 Apache 科尔多瓦和 Xcode 问题对他们的警告您在生成和部署应用程序时。
-Xcode 的警告 `invokeString` 方法涉及啟動一個應用程式從一個自訂 URL 的功能。 雖然從自訂 URL 載入的機制發生了變化，此代碼目前仍在繼續為科爾多瓦的較早版本創建的應用程式提供向後的功能。 應用程式範例不使用這一功能，因此可以忽略這些警告。 若要防止出現這些警告，請刪除引用已棄用的 invokeString API 的代碼：
+Xcode 的警告 `invokeString` 方法涉及启动一个应用程序从一个自定义 URL 的功能。 虽然从自定义 URL 加载的机制发生了变化，此代码目前仍在继续为科尔多瓦的较早版本创建的应用程序提供向后的功能。 示例应用程序不使用这一功能，因此可以忽略这些警告。 若要防止出现这些警告，请删除引用已弃用的 invokeString API 的代码：
-* 編輯*Classes/MainViewController.m*檔、 環繞的代碼與下面的塊 `/*` 和 `*/` 的評論如下所示，然後鍵入**命令-s**保存該檔：
+* 编辑*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] ；}
+ （失效） 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**保存該檔：
+* 编辑*Classes/AppViewDelegate.m*文件，注释掉下面的行插入双斜杠，如下所示，然后键入**命令-s**保存该文件：
//self.viewController.invokeString = invokeString ；
-* 按**命令-b**重新生成專案並消除此警告。
+* 按**命令-b**重新生成项目并消除此警告。
<!-- Does this fix only last until the next "cordova prepare"? -->
-**缺少標題**: 編譯錯誤有關的失蹤頭導致從生成位置的問題，可以通過 Xcode 偏好固定：
+**缺少标题**: 编译错误有关的失踪头导致从生成位置的问题，可以通过 Xcode 偏好固定：
-1. 選擇**Xcode → 首選項 → 位置**.
+1. 选择**Xcode → 首选项 → 位置**.
-2. 在**派生的資料**部分中，按**高級**按鈕並選擇**唯一**作為**生成位置**如下所示：
+2. 在**派生的数据**部分中，按**高级**按钮并选择**唯一**作为**生成位置**如下所示：
![][9]
[9]: img/guide/platforms/ios/xcode_build_location.png
-這是預設設置為一個新的 Xcode 安裝，但也可以設置以不同的方式從較早版本的 Xcode 後升級。
+这是默认设置为一个新的 Xcode 安装，但也可以设置以不同的方式从较早版本的 Xcode 后升级。
-進一步的資訊，請參考蘋果的文檔：
+进一步的信息，请参考苹果的文档：
-* [開始開發 iOS 應用程式今天][10]快速概述的步驟開發 iOS 的應用程式。
+* [开始开发 iOS 应用程序今天][10]快速概述的步骤开发 iOS 的应用程序。
-* [會員中心主頁][11]提供幾個 iOS 的連結技術資源包括技術資源，資源調配門戶、 分佈指南和社區論壇。
+* [会员中心主页][11]提供几个 iOS 的链接技术资源包括技术资源，资源调配门户、 分布指南和社区论坛。
* [IOS 工具工作流指南][7]
-* [Xcode 4 使用者指南][12]
+* [Xcode 4 用户指南][12]
-* 從蘋果世界廣泛開發人員會議 (WWDC2012) 2012年[屆會議視頻][13]
+* 从苹果世界广泛开发人员会议 (WWDC2012) 2012年[届会议视频][13]
-* 安裝[xcode 選擇命令][14]，它有助於指定正確版本的 Xcode，如果不止一個的話。
+* 安装[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
@@ -162,4 +162,4 @@ Xcode 的警告 `invokeString` 方法涉及啟動一個應用程式從一個自
[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 ® 是蘋果公司商標)
\ No newline at end of file
+(Mac ®，OS X ®，苹果公司 ®，Xcode ® 应用程序 Store℠，iPad ®，iPhone ®，iPod ® 和 Finder ® 是苹果公司商标)
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/guide/platforms/ios/plugin.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/ios/plugin.md b/docs/zh/edge/guide/platforms/ios/plugin.md
index 56ceeb1..6b16324 100644
--- a/docs/zh/edge/guide/platforms/ios/plugin.md
+++ b/docs/zh/edge/guide/platforms/ios/plugin.md
@@ -14,183 +14,165 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
under the License.
---
-# iOS 外掛程式
+# iOS 插件
-外掛程式是一個擴展的目標 C 類 `CDVPlugin` 類。
+此部分提供了如何在 iOS 平台上实现本机插件代码的详细信息。 之前读这篇文章，请参阅应用程序插件插件的结构和其共同的 JavaScript 界面的概述。 这一节继续表明通信从科尔多瓦 web 视图的本机平台和后面的示例*回声*插件。
-每個外掛程式類必須註冊為 `<feature>` 中標籤的 `config.xml` 檔。 正是通過這一機制的 JavaScript `exec` 方法的 `service` 參數將映射到目標 C 類。
+IOS 插件作为扩展目标 C 类实现 `CDVPlugin` 类。 对于 JavaScript 的 `exec` 方法的 `service` 参数将映射到一个目标 C 类，每个插件必须注册为 `<feature>` 标记命名的应用程序目录中 `config.xml` 文件。
-## 外掛程式類映射
+## 插件类映射
-一個外掛程式的 JavaScript 部分始終使用 `cordova.exec` 方法，如下所示：
+一个插件的 JavaScript 部分使用 `cordova.exec` 方法，如下所示：
- exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
-這封送一個請求從 `UIWebView` 到 iOS 本機側，更或較不沸騰到調用 `action` 方法 `service` 類，傳入的參數中的 `args` 陣列。
+这封送一个请求从 `UIWebView` 到 iOS 本机一侧，有效地调用 `action` 方法在 `service` 类，传入的参数中的 `args` 数组。
-指定外掛程式作為 `<feature>` 在科爾多瓦 iOS 應用程式專案中的標記 `config.xml` 檔。
+指定作为插件 `<feature>` 科尔多瓦 iOS 应用程序项目中的标记 `config.xml` 文件，使用 `plugin.xml` 文件来自动应用程序插件中所述注入此标记：
- <feature name="LocalStorage">
- <param name="ios-package" value="CDVLocalStorage" />
- </feature>
+ <feature name="LocalStorage">
+ <param name="ios-package" value="CDVLocalStorage" />
+ </feature>
-功能 `name` 屬性應匹配您在 JavaScript 中使用 `exec` 調用的 `service` 參數，和 `value` 屬性應與外掛程式的目標 C 類的名稱相匹配。 `<param name>`應始終是我 `"ios-package"` 。 如果不遵循此安裝程式，該外掛程式可能編譯，但不是會到達科爾多瓦。
+该功能的 `name` 属性应匹配您所指定的作为 JavaScript `exec` 调用的 `service` 参数。 `value`属性应与插件的目标 C 类的名称相匹配。 `<param>`元素的 `name` 应始终是 `ios-package` 。 如果你不遵守这些准则，该插件可能会编译，但科尔多瓦可能仍然不能够访问它。
-## 外掛程式初始化和存留期
+## 插件初始化和生存期
-外掛程式物件的一個實例創建為生活的每個 `UIWebView` 。 外掛程式不會具現化之前他們第一次引用通過調用從 JavaScript，除非 `<param>` 與 `onload` `name` 屬性設置為 `"true"` 的 `config.xml` 。 例如：
+插件对象的一个实例创建为生活的每个 `UIWebView` 。 首先从 JavaScript 的调用的引用时，通常被实例化插件。 否则他们可以通过设置实例化 `param` 命名为 `onload` 到 `true` 在 `config.xml` 文件：
- <feature name="Echo">
- <param name="ios-package" value="Echo" />
- <param name="onload" value="true" />
- </feature>
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ <param name="onload" value="true" />
+ </feature>
-有*沒有*指定外掛程式的初始值設定項。相反，應使用外掛程式 `pluginInitialize` 他們開辦的邏輯方法。
+有*没有*指定插件的初始值设定项。相反，应使用插件 `pluginInitialize` 为其启动逻辑方法。
-長時間運行的請求，外掛程式背景活動 （例如，播放的媒體），聽眾或內部狀態應執行 `onReset` 方法和停止或清理這些活動。 這種方法運行時 `UIWebView` 定位到新的一頁或刷新，重新載入 JavaScript。
+插件需要长时间运行的请求，如媒体回放、 听众，保持内部状态应执行的背景活动 `onReset` 方法来清理这些活动。 在方法运行时 `UIWebView` 定位到新的一页或刷新，重新加载 JavaScript。
-## 寫作 iOS 科爾多瓦外掛程式
+## 写作 iOS 科尔多瓦插件
-我們有外掛程式請求到本機端 JavaScript 起火燃燒。 我們有通過正確映射的目標 C 的 iOS 外掛程式 `config.xml` 檔。 所以最後的 iOS 目標 C 外掛程式類長什麼樣子？
+JavaScript 调用触发插件请求到本机的一边，和相应的 iOS 目标 C 插件映射正确地在 `config.xml` 文件中，但最后 iOS 目标 C 插件类看起来像什么？ 无论派往与 JavaScript 的插件 `exec` 函数传递到相应的插件类的 `action` 方法。 插件的方法有此签名：
-什麼獲取調度到該外掛程式通過 JavaScript 的 `exec` 函數獲取傳遞到相應的外掛程式類的 `action` 方法。外掛程式的方法有此簽名：
-
- - (void)myMethod:(CDVInvokedUrlCommand*)command
- {
- CDVPluginResult* pluginResult = nil;
- NSString* myarg = [command.arguments objectAtIndex:0];
+ - (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"];
+ 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];
}
- [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
- }
-1. [CDVInvokedUrlCommand.h][1]
-
-2. [CDVPluginResult.h][2]
-
-3. [CDVCommandDelegate.h][3]
-
- [1]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVInvokedUrlCommand.h
- [2]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPluginResult.h
- [3]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVCommandDelegate.h
+有关更多详细信息，请参见 `[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 訊息類型
+## iOS CDVPluginResult 消息类型
-使用 CDVPluginResult 可以返回結果類型的各種回您的 JavaScript 回呼函數，使用看起來像的類方法：
+您可以使用 `CDVPluginResult` 来返回结果的多种类型回 JavaScript 回调函数，使用类的方法，它们遵循这种模式：
- + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...
+ + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...
-您可以創建 `String` ， `Int` ， `Double` ， `Bool` ， `Array` ， `Dictionary` ， `ArrayBuffer` ，和 `Multipart` 類型。 或者，不附加任何參數 (只是發送狀態)。 或者，返回一個錯誤。 你甚至可以選擇不發送任何外掛程式的結果，在這種情況下不會觸發回檔。
+您可以创建 `String` ， `Int` ， `Double` ， `Bool` ， `Array` ， `Dictionary` ， `ArrayBuffer` ，和 `Multipart` 类型。 你可以也离开了任何参数来发送状态，或返回错误，或甚至选择不发送任何插件的结果，在这种情况下既不回拨火。
-### 備註
+请注意以下复杂的返回值为：
-* `messageAsArrayBuffer`預計 `NSData*` 並將轉換為 `ArrayBuffer` 為您的 JavaScript 回檔 （和 `ArrayBuffers` 從 JavaScript 發送到一個外掛程式都將轉換為`NSData*`).
-* `messageAsMultipart` 預計 `NSArray *` 包含任何其他支援類型，並將整個陣列作為發送 `參數` 給您的 JavaScript 回檔。
- * 怪癖： 這不是只是語法糖 （儘管它是甜的）。 這種方式，所有參數序列化或反序列化，必要時。 例如，它是能夠安全返回 `NSData*` 作為多部分，但不是 `Array` /`Dictionary`.
+* `messageAsArrayBuffer`预计 `NSData*` 并将转换为 `ArrayBuffer` 在 JavaScript 回调。 同样，任何 `ArrayBuffer` JavaScript 发送到一个插件都将转换为`NSData*`.
-## Echo 外掛程式 iOS 外掛程式
+* `messageAsMultipart`预计， `NSArray*` 包含任何其他支持类型，并将发送整个数组作为 `arguments` 给您的 JavaScript 回调。 这种方式，所有参数在序列化或反序列化作为必要的所以它是能够安全返回 `NSData*` 作为多部分，但不是 `Array` /`Dictionary`.
-我們會將以下內容添加到該專案的 `config.xml` 檔：
+## 回声 iOS 插件示例
- <feature name="Echo">
- <param name="ios-package" value="Echo" />
- </feature>
+若要匹配的 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` ） 到我們科爾多瓦 iOS 應用程式目錄裡面的外掛程式目錄：
+然后我们将添加以下 `Echo.h` 和 `Echo.m` 文件到 `Plugins` 内科尔多瓦 iOS 应用程序目录的文件夹：
- /********* Echo.h Cordova Plugin Header *******/
+ /********* Echo.h Cordova Plugin Header *******/
- #import <Cordova/CDV.h>
+ #import <Cordova/CDV.h>
- @interface Echo : CDVPlugin
+ @interface Echo : CDVPlugin
- - (void)echo:(CDVInvokedUrlCommand*)command;
+ - (void)echo:(CDVInvokedUrlCommand*)command;
- @end
+ @end
- /********* Echo.m Cordova Plugin Implementation *******/
+ /********* Echo.m Cordova Plugin Implementation *******/
- #import "Echo.h"
- #import <Cordova/CDV.h>
+ #import "Echo.h"
+ #import <Cordova/CDV.h>
- @implementation Echo
+ @implementation Echo
- - (void)echo:(CDVInvokedUrlCommand*)command
- {
- CDVPluginResult* pluginResult = nil;
- NSString* echo = [command.arguments objectAtIndex:0];
+ - (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];
- }
+ 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];
- }
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }
- @end
+ @end
-讓我們看看代碼。在頂部，我們有所有必要的科爾多瓦進口。我們班延伸從 `CDVPlugin` （非常重要）。
+在文件的顶部必要的进口商品扩展从类 `CDVPlugin` 。 在这种情况下，该插件只支持单个 `echo` 行动。 它获取 echo 字符串通过调用 `objectAtIndex` 方法获取的第一个参数 `arguments` 对应于参数的数组通过 JavaScript 在 `exec()` 函数。
-此外掛程式只支援一個操作， `echo` 的行動。 第一，我們抓住 echo 字串使用 `objectAtIndex` 方法上的我們 `args` ，告訴它我們想要獲取的參數陣列中的第十的參數。 我們做一些參數檢查： 請確保它不是 `nil` ，並確保它不是一個零長度的字串。
+它会检查该参数，以确保它不是 `nil` 或空字符串，返回 `PluginResult` 与 `ERROR` 如果是这样的状态。 如果该参数通过检查，它返回 `PluginResult` 与 `OK` 状态，在原始中传递 `echo` 的字符串。 最后，它将发送结果到 `self.commandDelegate` ，其中执行 `exec` 方法的成功或失败回调 JavaScript 一边。 如果成功回调被调用，它将通过在 `echo` 参数。
-如果是，我們返回 `PluginResult` 與 `ERROR` 狀態。 如果所有這些檢查通過，然後我們將返回 `PluginResult` 與 `OK` 狀態，並通過在 `echo` 我們收到了在第一位作為參數的字串。
+## iOS 一体化
-最後，我們發送結果到 `self.commandDelegate` ，其中執行 `exec` 方法的成功或失敗回檔 JavaScript 一邊。 如果成功回檔被調用，它將通過在 `echo` 參數。
+`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
-在相同的 UI 執行緒中執行的外掛程式方法。如果你的外掛程式需要大量的處理，或者需要一個阻塞調用，則應使用後臺執行緒。例如：
+## 线程处理
- - (void)myPluginMethod:(CDVInvokedUrlCommand*)command
- {
- // Check command.arguments here.
- [self.commandDelegate runInBackground:^{
- NSString* payload = nil;
- // Some blocking logic...
- CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
- // The sendPluginResult method is thread-safe.
- [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
- }];
- }
-
-
-## 高級的外掛程式功能
-
-請參閱其他方法時，您可以在重寫：
-
-* [CDVPlugin.h][4]
-
-* [CDVPlugin.m][5]
+插件方法通常在主界面相同的线程中执行。 如果你的插件需要大量的处理，或者需要一个阻塞调用，则应使用后台线程。 例如：
- [4]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.h
- [5]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.m
-
-例如，你可以掛接到 `pause` ， `resume` ，應用程式終止和 `handleOpenURL` 事件。
-
-## 調試外掛程式
+ - (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];
+ }];
+ }
+
-若要調試的目標 C 側，您將使用 Xcode 的內置調試器。 對於 JavaScript，在 iOS 5.0 可以使用[Weinre、 Apache 科爾多瓦專案][6]或[iWebInspector、 一個協力廠商實用程式][7]
+## 调试 iOS 插件
- [6]: https://github.com/apache/cordova-weinre
- [7]: http://www.iwebinspector.com/
+若要调试的目标 C 一边，你需要 Xcode 的内置调试器。 对于 JavaScript，在 iOS 5.0 可以使用[Weinre、 Apache 科尔多瓦项目][3]或[iWebInspector、 一个第三方实用程序][4]。 Ios 6，您可以向您的应用程序运行在 iOS 6 模拟器附加 Safari 6.0。
-Ios 6，您將使用 Safari 6.0 將簡單地附加到您的應用程式運行在 iOS 6 模擬器。
+ [3]: https://github.com/apache/cordova-weinre
+ [4]: http://www.iwebinspector.com/
-## 常見的陷阱
+## 常见的陷阱
-* 別忘了向 config.xml 添加您的腳本映射。如果你忘記了，是在 Xcode 主控台中記錄錯誤。
+* 别忘了添加到您的脚本映射 `config.xml` 。如果你忘记了，是在 Xcode 控制台中记录错误。
-* 別忘了添加任何主機，您在白名單中，連接到域白名單指南中所述。如果你忘記了，是在 Xcode 主控台中記錄錯誤。
\ No newline at end of file
+* 别忘了添加任何主机，您在白名单中，连接到域白名单指南中所述。如果你忘记了，是在 Xcode 控制台中记录错误。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/guide/platforms/ios/tools.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/ios/tools.md b/docs/zh/edge/guide/platforms/ios/tools.md
index e97b48a..775227a 100644
--- a/docs/zh/edge/guide/platforms/ios/tools.md
+++ b/docs/zh/edge/guide/platforms/ios/tools.md
@@ -14,36 +14,38 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
under the License.
---
-# iOS 命令列工具
+# iOS 命令行工具
-`cordova`命令列實用程式是一個高級別的工具，允許您在一次跨幾個平臺生成的應用程式。 舊版本的科爾多瓦框架提供了特定于每個平臺的命令列工具集。 若要使用它們作為 CLI 的替代，您需要從[cordova.apache.org][1]下載此版本的科爾多瓦。 下載檔案中包含單獨的檔案，為每個平臺。 展開您想要的目標平臺。 這裡描述的工具，通常可用在頂級 `bin` 目錄中，否則為諮詢**自述**檔，瞭解有關更多詳細的指示。
+`cordova`命令行实用程序是一个高级别的工具，允许您在一次跨几个平台生成的应用程序。 旧版本的科尔多瓦框架提供了特定于每个平台的命令行工具集。 若要使用它们作为 CLI 的替代，您需要从[cordova.apache.org][1]下载此版本的科尔多瓦。 下载文件中包含单独的档案，为每个平台。 展开您想要的目标平台。 这里描述的工具，通常可用在顶级 `bin` 目录中，否则为咨询**自述**文件，了解有关更多详细的指示。
[1]: http://cordova.apache.org
-IOS 命令列工具都建立在 shell 腳本和依賴于 Xcode 命令列工具如 `xcode-select` 和`xcodebuild`.
+IOS 命令行工具都建立在 shell 脚本和依赖于 Xcode 命令行工具如 `xcode-select` 和`xcodebuild`.
-## 創建一個專案
+低级命令行界面，它使插件的信息，请参阅使用 Plugman 到管理插件。有关概述，请参见应用程序插件。
-運行 `create` 命令，指定的現有路徑的專案、 反向域式包識別碼和應用程式的顯示名稱。
+## 创建一个项目
+
+运行 `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