You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/08/30 19:25:52 UTC
[02/36] Add edge for Spanish, French, and Chinese.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/guide/platforms/ios/config.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/ios/config.md b/docs/zh/edge/guide/platforms/ios/config.md
new file mode 100644
index 0000000..5eb852d
--- /dev/null
+++ b/docs/zh/edge/guide/platforms/ios/config.md
@@ -0,0 +1,53 @@
+---
+
+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 配置
+
+`config.xml`设置文件控制科尔多瓦的各种设置。 这是应用广泛，并不设置每个 CDVViewController 实例。 `config.xml`文件位于您 `<project folder>/<appname>` 目录。
+
+## `< 首选项 >`
+
+各种首选项 （作为 `<preference>` 标签） 默认情况下，不打破现有的应用程序。可用的选择是：
+
+* `DisallowOverscroll`(boolean 类型的值，默认值为 `false` ）： 设置为 `true` 如果你不想对橡胶带 web 视图。
+
+* `TopActivityIndicator`（字符串，默认值为 `gray` ）： 这是栏中的状态/电池顶部纺 throbber，有效的值是 `whiteLarge` ， `white` ，和`gray`.
+
+* `EnableLocation`(boolean 类型的值，默认值为 `false` ）： 设置为 `true` 、 初始化启动时的地理定位插件 （以便在您所在的位置上的修补程序可以更准确）**已否决**： 请设置 `onload` 属性的 `Geolocation` 插件的 `true` 相反。
+
+* `EnableViewportScale`(boolean 类型的值，默认值为 `false` ）： 设置为 `true` ，防止结垢通过 meta 标记的视区。
+
+* `AutoHideSplashScreen`(boolean 类型的值，默认值为 `true` ）： 设置为 `false` ，控制通过 JavaScript API 闪屏被隐藏时。
+
+* `FadeSplashScreen`(boolean 类型的值，默认值为 `true` ）： 设置为 `false` ，防止出现闪屏，淡出时显示或隐藏它。
+
+* `FadeSplashScreenDuration`（浮动，默认值为 2）： 初始屏幕淡入淡出时间以秒为单位。
+
+* `ShowSplashScreenSpinner`(boolean 类型的值，默认值为 `true` ）： 设置为 `false` 隐藏初始屏幕微调框。
+
+* `MediaPlaybackRequiresUserAction`(boolean 类型的值，默认值为 `false` ）： 设置为 true，不允许 autoplayed HTML5 视频。
+
+* `AllowInlineMediaPlayback`(boolean 类型的值，默认值为 `false` ）： 设置为 true，以允许内联 HTML5 播放媒体，此外，在 HTML 文档中的视频元素还必须包括 webkit playsinline 属性。
+
+* `BackupWebStorage`（字符串，默认值为 `cloud` ）： 有效的值为 `none` ， `cloud` 和 `local` 。 设置为 `cloud` ，允许 web 存储数据要备份到 iCloud，并将设置为 `local` ，仅允许本地备份 （iTunes 同步）。 设置为 `none` ，不允许任何备份 web 存储。
+
+* `KeyboardDisplayRequiresUserAction`(boolean 类型的值，默认值为 `true` ）： 设置为 false 时窗体元素获得焦点通过 JavaScript focus() 调用打开键盘。
+
+* `SuppressesIncrementalRendering`(boolean 类型的值，默认值为 `false` ）： 它在呈现之前已收到设置为 true，等待，直到新的所有视图的内容。
+
+* `HideKeyboardFormAccessoryBar`(boolean 类型的值，默认值为 `false` ）： 设置为隐藏的附加工具栏的键盘上面是真实。 此工具栏功能**上一页**、**下一页**，和**做**按钮。
+
+* `KeyboardShrinksView`(boolean 类型的值，默认值为 `false` ）： 设置为 `true` 当键盘后缩小 web 视图。 Web 视图缩小，而不是视区萎缩和可滚动页面。 这适用于应用程序，它们相对于底部的 web 视图的元素的位置。 这是在 android 系统里的默认行为，构建应用程序而不是网页时发出很大的意义。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/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
new file mode 100644
index 0000000..4f202f1
--- /dev/null
+++ b/docs/zh/edge/guide/platforms/ios/index.md
@@ -0,0 +1,165 @@
+---
+
+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 平台指南
+
+本指南介绍如何设置您的 SDK 开发环境部署科尔多瓦的 iOS 设备 （如 iPhone 和 iPad 的应用程序。请参阅下列特定于平台的详细信息：
+
+* iOS 配置
+* 升级 iOS
+* WebViews iOS
+* iOS 插件
+* iOS 命令行工具
+
+上面的命令行工具请参阅科尔多瓦 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]: img/guide/platforms/ios/helloworld_project.png
+
+## 部署到仿真程序
+
+若要预览 iOS 模拟器中的应用程序：
+
+1. 请确保在左边的面板中选择*.xcodeproj*文件。
+
+2. 选择**你好**app 立即向右面板中。
+
+3. 从工具栏上的**计划**菜单中选择预定的设备、 iPhone 等作为 6.0 模拟器在这里突出了：
+
+ ![][5]
+
+4. 按下**运行**按钮出现在同一工具栏左侧的**计划**中。 那生成、 部署并在模拟器中运行应用程序。 一个单独的仿真器应用程序将打开，并显示该应用程序：
+
+ ![][6]
+
+ 只有一个仿真程序可能会运行一次，所以如果你想要在不同的仿真器中测试应用程序，您需要退出的仿真程序应用程序和运行一个不同的目标在 Xcode 的范围内。
+
+ [5]: img/guide/platforms/ios/select_xcode_scheme.png
+ [6]: 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]: 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 ® 是苹果公司商标)
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/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
new file mode 100644
index 0000000..87813c3
--- /dev/null
+++ b/docs/zh/edge/guide/platforms/ios/plugin.md
@@ -0,0 +1,140 @@
+---
+
+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 插件
+
+插件是一个扩展的目标 C 类 `CDVPlugin` 类。
+
+每个插件类必须注册为 `<feature>` 中标签的 `config.xml` 文件。 正是通过这一机制的 JavaScript `exec` 方法的 `service` 参数将映射到目标 C 类。
+
+## 插件类映射
+
+一个插件的 JavaScript 部分始终使用 `cordova.exec` 方法，如下所示：
+
+ exec （< successFunction > < failFunction >、 < 服务 >、 < 行动 > [< args >]) ；
+
+
+这封送一个请求从 `UIWebView` 到 iOS 本机侧，更或较不沸腾到调用 `action` 方法 `service` 类，传入的参数中的 `args` 数组。
+
+指定插件作为 `<feature>` 在科尔多瓦 iOS 应用程序项目中的标记 `config.xml` 文件。
+
+ < 功能名称 ="认为">< 参数名称 ="ios 包"值 ="CDVLocalStorage"/ >< / 功能 >
+
+
+功能 `name` 属性应匹配您在 JavaScript 中使用 `exec` 调用的 `service` 参数，和 `value` 属性应与插件的目标 C 类的名称相匹配。 `<param name>`应始终是我 `"ios-package"` 。 如果不遵循此安装程序，该插件可能编译，但不是会到达科尔多瓦。
+
+## 插件初始化和生存期
+
+插件对象的一个实例创建为生活的每个 `UIWebView` 。 插件不会实例化之前他们第一次引用通过调用从 JavaScript，除非 `<param>` 与 `onload` `name` 属性设置为 `"true"` 的 `config.xml` 。 例如：
+
+ < 功能名称 ="回声">< 参数名称 ="ios 包"值 ="回声"/ >< 参数名称 ="onload"值 ="true"/ >< / 功能 >
+
+
+有*没有*指定插件的初始值设定项。相反，应使用插件 `pluginInitialize` 他们开办的逻辑方法。
+
+长时间运行的请求，插件背景活动 （例如，播放的媒体），听众或内部状态应执行 `onReset` 方法和停止或清理这些活动。 这种方法运行时 `UIWebView` 定位到新的一页或刷新，重新加载 JavaScript。
+
+## 写作 iOS 科尔多瓦插件
+
+我们有插件请求到本机端 JavaScript 起火燃烧。 我们有通过正确映射的目标 C 的 iOS 插件 `config.xml` 文件。 所以最后的 iOS 目标 C 插件类长什么样子？
+
+什么获取调度到该插件通过 JavaScript 的 `exec` 函数获取传递到相应的插件类的 `action` 方法。插件的方法有此签名：
+
+ -（失效） myMethod:(CDVInvokedUrlCommand*) 命令 {CDVPluginResult * pluginResult = 零 ；NSString * myarg = [command.arguments objectAtIndex:0];如果 (myarg! = 无) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];} 其他 {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg 为空"] ；} [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId] ；}
+
+
+1. [CDVInvokedUrlCommand.h][1]
+
+2. [CDVPluginResult.h][2]
+
+3. [CDVCommandDelegate.h][3]
+
+ [1]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVInvokedUrlCommand.h
+ [2]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPluginResult.h
+ [3]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVCommandDelegate.h
+
+## iOS CDVPluginResult 消息类型
+
+使用 CDVPluginResult 可以返回结果类型的各种回您的 JavaScript 回调函数，使用看起来像的类方法：
+
+ + (CDVPluginResult *) resultWithStatus： (CDVCommandStatus) statusOrdinal messageAs......
+
+
+您可以创建 `String` ， `Int` ， `Double` ， `Bool` ， `Array` ， `Dictionary` ， `ArrayBuffer` ，和 `Multipart` 类型。 或者，不附加任何参数 (只是发送状态)。 或者，返回一个错误。 你甚至可以选择不发送任何插件的结果，在这种情况下不会触发回调。
+
+### 备注
+
+* `messageAsArrayBuffer`预计 `NSData*` 并将转换为 `ArrayBuffer` 为您的 JavaScript 回调 （和 `ArrayBuffers` 从 JavaScript 发送到一个插件都将转换为`NSData*`).
+* `messageAsMultipart` 预计 `NSArray *` 包含任何其他支持类型，并将整个数组作为发送 `参数` 给您的 JavaScript 回调。
+ * 怪癖： 这不是只是语法糖 （尽管它是甜的）。 这种方式，所有参数序列化或反序列化，必要时。 例如，它是能够安全返回 `NSData*` 作为多部分，但不是 `Array` /`Dictionary`.
+
+## Echo 插件 iOS 插件
+
+我们会将以下内容添加到该项目的 `config.xml` 文件：
+
+ < 功能名称 ="回声">< 参数名称 ="ios 包"值 ="回声"/ >< / 功能 >
+
+
+然后我们将添加下列文件 （ `Echo.h` 和 `Echo.m` ） 的插件文件夹里面我们科尔多瓦 iOS 应用程序文件夹中：
+
+ / --- Echo.h 科尔多瓦插件头 * * * / #import < Cordova/CDV.h > @interface 回声： CDVPlugin-(void) echo:(CDVInvokedUrlCommand*) 命令 ；@end / * * * Echo.m 科尔多瓦插件执行 * * * / #import"Echo.h"#import < Cordova/CDV.h > @implementation 回声-（失效） echo:(CDVInvokedUrlCommand*) 命令 {CDVPluginResult * pluginResult = 零 ；NSString * 回声 = [command.arguments objectAtIndex:0];如果 (回声! = 无 & & [回声长度] > 0) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];} 其他 {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];} [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId] ；} @end
+
+
+让我们看看代码。在顶部，我们有所有必要的科尔多瓦进口。我们班延伸从 `CDVPlugin` （非常重要）。
+
+此插件只支持一个操作， `echo` 的行动。 第一，我们抓住 echo 字符串使用 `objectAtIndex` 方法上的我们 `args` ，告诉它我们想要获取的参数数组中的第十的参数。 我们做一些参数检查： 请确保它不是 `nil` ，并确保它不是一个零长度的字符串。
+
+如果是，我们返回 `PluginResult` 与 `ERROR` 状态。 如果所有这些检查通过，然后我们将返回 `PluginResult` 与 `OK` 状态，并通过在 `echo` 我们收到了在第一位作为参数的字符串。
+
+最后，我们发送结果到 `self.commandDelegate` ，其中执行 `exec` 方法的成功或失败回调 JavaScript 一边。 如果成功回调被调用，它将通过在 `echo` 参数。
+
+## 线程处理
+
+在相同的 UI 线程中执行的插件方法。如果你的插件需要大量的处理，或者需要一个阻塞调用，则应使用后台线程。例如：
+
+ -（失效） myPluginMethod:(CDVInvokedUrlCommand*) 命令 {/ / 检查 command.arguments 在这里。
+ [self.commandDelegate runInBackground: ^ {NSString * 有效载荷 = 零 ；/ 有些阻塞的逻辑......
+ CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];/ / SendPluginResult 方法是线程安全的。
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId] ；}];}
+
+
+## 高级的插件功能
+
+请参阅其他方法时，您可以在重写：
+
+* [CDVPlugin.h][4]
+
+* [CDVPlugin.m][5]
+
+ [4]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.h
+ [5]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.m
+
+例如，你可以挂接到 `pause` ， `resume` ，应用程序终止和 `handleOpenURL` 事件。
+
+## 调试插件
+
+若要调试的目标 C 侧，您将使用 Xcode 的内置调试器。 对于 JavaScript，在 iOS 5.0 可以使用[Weinre、 Apache 科尔多瓦项目][6]或[iWebInspector、 一个第三方实用程序][7]
+
+ [6]: https://github.com/apache/cordova-weinre
+ [7]: http://www.iwebinspector.com/
+
+Ios 6，您将使用 Safari 6.0 将简单地附加到您的应用程序运行在 iOS 6 模拟器。
+
+## 常见的陷阱
+
+* 别忘了向 config.xml 添加您的脚本映射。如果你忘记了，是在 Xcode 控制台中记录错误。
+
+* 别忘了添加任何主机，您在白名单中，连接到域白名单指南中所述。如果你忘记了，是在 Xcode 控制台中记录错误。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/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
new file mode 100644
index 0000000..21fe42b
--- /dev/null
+++ b/docs/zh/edge/guide/platforms/ios/tools.md
@@ -0,0 +1,49 @@
+---
+
+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 命令行工具
+
+`cordova`命令行实用程序是一个高级别的工具，允许您在一次跨几个平台生成的应用程序。 旧版本的科尔多瓦框架提供了特定于每个平台的命令行工具集。 若要使用它们作为 CLI 的替代，您需要从[cordova.apache.org][1]下载此版本的科尔多瓦。 下载文件中包含单独的档案，为每个平台。 展开您想要的目标平台。 这里描述的工具，通常可用在顶级 `bin` 目录中，否则为咨询**自述**文件，了解有关更多详细的指示。
+
+ [1]: http://cordova.apache.org
+
+IOS 命令行工具都建立在 shell 脚本和依赖于 Xcode 命令行工具如 `xcode-select` 和`xcodebuild`.
+
+## 创建一个项目
+
+运行 `create` 命令，指定的现有路径的项目、 反向域式包标识符和应用程序的显示名称。
+
+ $ ./path/to/cordova-ios/bin/create /path/to/my_new_project com.example.project_name ProjectName
+
+
+## 生成项目
+
+ $ /path/to/my_new_project/cordova/build
+
+
+## 在仿真器上运行的应用程序
+
+ $ /path/to/my_new_project/cordova/run
+
+
+## 释放
+
+ $ /path/to/my_new_project/cordova/release
+
+
+## 日志记录
+
+ $ /path/to/my_new_project/cordova/log
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/guide/platforms/ios/upgrading.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/ios/upgrading.md b/docs/zh/edge/guide/platforms/ios/upgrading.md
new file mode 100644
index 0000000..69cdfda
--- /dev/null
+++ b/docs/zh/edge/guide/platforms/ios/upgrading.md
@@ -0,0 +1,695 @@
+---
+
+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 4.5 是必需的。要提交到苹果 App Store，必须使用最新的产品出厂的版本的 iOS SDK，这是 iOS 6。IOS 6 SDK 需要 Xcode 4.5。
+
+## 从 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` CLI 实用程序。 请参阅使用 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` 的一个新的项目。 例如：
+
+ < 插件 >< 插件名称 ="认为"值 ="CDVLocalStorage"/ ><! — — 其他插件--> < / 插件 ><! — — 将更改为： (< 插件 >--> < 功能 > 标记是在同一水平的注 < 功能名称 ="认为">< 参数名称 ="ios 包"值 ="CDVLocalStorage"/ >< / 功能 ><! — — 其他 < 功能 > 标签-->
+
+
+8. 删除您 `CordovaLib` 目录和副本 `CordovaLib` 目录从新项目到项目的根目录。
+
+9. 将这两个框架添加到您的项目：
+
+ OpenAL ImageIO
+
+
+10. 更新您的项目目标**生成设置**。编辑**"-Obj-C"**要下**链接 → 其他链接器标志**， **"-ObjC"**.
+
+11. 更新您的项目目标**生成设置**。 在**链接 → 其他链接器标志**，更改**"-all_load"**是 `-force\_load ${BUILT\_PRODUCTS\_DIR}/libCordova.a` 。 你只需要这样做，如果你有在中定义的问题[这一问题。][1].
+
+ [1]: 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` 文件根据您从新项目 (见[此比较][2]).
+
+8. 在您 `config.xml` 文件，[删除这条线][3].
+
+9. 删除您 `CordovaLib` 目录和副本 `CordovaLib` 目录从新项目到项目的根目录。
+
+ [2]: 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
+ [3]: 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` 文件根据您从新项目 (见[此比较][4]).
+
+8. 在您 `config.xml` 文件，[添加此新行][5].
+
+9. 在您 `config.xml` 文件，[添加此新行][6].
+
+10. 在您 `config.xml` 文件， [UIWebViewBounce 已改为 DisallowOverscroll，和默认值都不同][7].
+
+11. 在您 `config.xml` 文件， `EnableLocation` 首选项已被否决。
+
+12. 删除您 `CordovaLib` 目录和副本 `CordovaLib` 目录从新项目到项目的根目录。
+
+ [4]: 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
+ [5]: 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
+ [6]: 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
+ [7]: 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` 文件根据您从新项目 (见[此比较][8]).
+
+8. 在您 `config.xml` 文件，[添加这些新行][9].
+
+9. 在您 `config.xml` 文件，[编辑的根元素，更改它从科尔多瓦到构件][10].
+
+10. 在您 `config.xml` 文件，[删除 OpenAllWhitelistURLsInWebView 首选项][11].
+
+11. 删除您 `cordova` 目录和副本 `cordova` 目录从新项目到项目的根目录。在 2.5.0，这已更新脚本。
+
+12. 删除您 `CordovaLib` 目录和副本 `CordovaLib` 目录从新项目到项目的根目录。
+
+ [8]: 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
+ [9]: 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
+ [10]: 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
+ [11]: 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` 文件根据您从新项目 (见[此比较][12]).
+
+8. 更新 （或如果您从未更改该文件替换） 您 `AppDelegate.m` 文件根据您从新项目 (见[此比较][13]).
+
+9. 在您 `config.xml` 文件，[添加此新行][14].
+
+10. 删除您 `cordova` 目录和副本 `cordova` 目录从新项目到项目的根目录。在 2.4.0，这已固定的脚本。
+
+11. 删除您 `CordovaLib` 目录和副本 `CordovaLib` 目录从新项目到项目的根目录。
+
+12. AssetsLibrary.framework 作为资源添加到项目中。 （去[这里][15]有关如何执行此操作的说明.）。
+
+ [12]: 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
+ [13]: 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
+ [14]: 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
+ [15]: 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 路径/为/您/项目/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. 搜索**其他的链接器标志**，并添加相应的值**-all_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 科][16]
+
+ [16]: 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. 将这些文件从新项目复制到磁盘，替换任何旧的文件 （备份您的文件首次从上述步骤 2） 上的项目文件夹中 1.5.0-based：
+
+ 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. 将这些文件从新项目复制到磁盘，替换任何旧的文件 （备份您的文件首次从上述步骤 2） 上的项目文件夹中 1.3.0-based：
+
+ 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. 将这些文件从新项目复制到磁盘，替换任何旧的文件 （备份您的文件首次从上述步骤 2） 上的项目文件夹中 1.2.0-based：
+
+ 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. 将这些文件从新项目复制到磁盘，替换任何旧的文件 （备份您的文件首次从上述步骤 2） 上的项目文件夹中 1.1.0-based：
+
+ 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. 将这些文件从新项目复制到磁盘，替换任何旧的文件 （备份您的文件首次从上述步骤 2） 上的项目文件夹中 1.0.0-based：
+
+ 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. 将这些文件从新项目复制到磁盘，替换任何旧的文件 （备份您的文件首次从上述步骤 2） 上的项目文件夹中 0.9.6-based：
+
+ 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/992e9151/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
new file mode 100644
index 0000000..f3af5d0
--- /dev/null
+++ b/docs/zh/edge/guide/platforms/ios/webview.md
@@ -0,0 +1,143 @@
+---
+
+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.
+---
+
+# WebViews iOS
+
+从科尔多瓦 1.4 开始，可以使用一个组件作为科尔多瓦在 iOS 应用程序中。此组件是代号为 '刀'。
+
+新科尔多瓦基于应用程序使用提供在科尔多瓦 1.4 或更多地使用刀的 Xcode 模板创建的。（模板是刀的参考实现。
+
+科尔多瓦 2.0.0 和后续版本仅支持基于次级项目刀执行。
+
+## 系统必备组件
+
+* 科尔多瓦 2.3.0 或更大
+
+* Xcode 4.5 或更大
+
+* `config.xml`文件 (从新创建的 iOS 项目)
+
+## 克利弗添加到 Xcode 项目 （CordovaLib 子项目）
+
+1. 下载并解压缩到您的硬盘驱动器上的永久文件夹位置的科尔多瓦源，例如到`~/Documents/Cordova`.
+
+2. 如果它正在运行，请退出 Xcode。
+
+3. 使用终端程序，定位到你放在上面的下载的源的目录。
+
+4. 复制 `config.xml` 文件到您的项目文件夹在磁盘上 （请参见上面的前提条件）。
+
+5. 拖放式 `config.xml` 到 Xcode 项目导航的文件。
+
+6. 选择**创建组的任何添加的文件夹**单选按钮，然后按**完成**.
+
+7. 拖放式 `CordovaLib.xcodeproj` 到 Xcode 项目导航的文件 （从永久文件夹位置上面，和它应该是在 `CordovaLib` 子目录）。
+
+8. Select `CordovaLib.xcodeproj` in the Project Navigator.
+
+9. 键入**选项-命令-1**键的组合，以显示**文件检查器**.
+
+10. 选择**相对于组****文件检查器**器下拉菜单中的**位置**.
+
+11. 在项目导航器中选择**项目图标**，选择你的**目标**，然后选择**生成设置**选项卡。
+
+12. 添加 `-all_load` 和 `-Obj-C` 的**其他链接器标志**值。
+
+13. 单击项目导航器中的**项目图标**，选择你的**目标**，然后选择**生成阶段**选项卡。
+
+14. 展开**链接二进制文件与库**.
+
+15. 选择**+**按钮，然后添加下列**框架**。（可选） 该项目导航器中移动他们的**框架**组下）：
+
+ AddressBook.framework AddressBookUI.framework AudioToolbox.framework AVFoundation.framework CoreLocation.framework MediaPlayer.framework QuartzCore.framework SystemConfiguration.framework MobileCoreServices.framework CoreMedia.framework
+
+
+16. 扩展**目标的依赖关系**，标有像这样如果您有多个框的顶部框 ！
+
+17. 选择**+**按钮，然后添加 `CordovaLib` 生成产品。
+
+18. 展开**链接二进制文件与库**，标有像这样如果您有多个框的顶部框 ！
+
+19. 选择**+**按钮，然后添加`libCordova.a`.
+
+20. 设置为**独特**Xcode 偏好**Xcode 首选项 → 位置 → 派生数据 → 先进......**.
+
+21. 在项目导航器中选择**项目图标**，选择你的**目标**，然后选择**生成设置**选项卡。
+
+22. 搜索**标题搜索路径**。该设置，添加以下 （带引号） 这三个值：
+
+ "$(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 新] ；
+
+
+3. (*可选*）设置 `wwwFolderName` 属性 （默认为 `www` ）：
+
+ viewController.wwwFolderName = @"myfolder"；
+
+
+4. (*可选*）在您的 config.xml 中设置的起始页 `<content>` 标记。
+
+ < 内容 src="index.html"/ >
+
+
+ 或
+
+ < 内容 src ="http://apache.org"/ >
+
+
+5. (*可选*）设置 `useSplashScreen` 属性 （默认为 `NO` ）：
+
+ viewController.useSplashScreen = 否。
+
+
+6. 设置**视图框架**（总是此设置作为最后一个属性）：
+
+ viewController.view.frame = CGRectMake (0、 0、 320、 480） ；
+
+
+7. 将刀添加到您的视图：
+
+ [myView addSubview:viewController.view] ；
+
+
+## 添加您的 HTML、 CSS 和 JavaScript 资产
+
+1. 在您在磁盘上的项目中创建一个新的文件夹 `www` 为例。
+
+2. 将您的 HTML、 CSS 和 JavaScript 资产放入此文件夹。
+
+3. 拖动并放到 Xcode 项目导航的文件夹。
+
+4. 选择**创建文件夹引用的任何添加的文件夹**单选按钮。
+
+5. 设置相应的 `wwwFolderName` 和 `startPage` 你最初创建的文件夹的属性，或使用默认设置 （请参阅上一节） 当你实例化`CDVViewController`.
+
+ / * 如果您创建了一个名为 'myfolder' 文件夹和你想要的文件中它是 Start 的 ' mypage.html' * / viewController.wwwFolderName = @"myfolder"；viewController.startPage = @"mypage.html"
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/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
new file mode 100644
index 0000000..9c1ddf2
--- /dev/null
+++ b/docs/zh/edge/guide/platforms/tizen/index.md
@@ -0,0 +1,112 @@
+---
+
+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.
+---
+
+# 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 → New → 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__
+
+ 
+
+ - Click __Finish__
+
+ 
+
+ - 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]: img/guide/platforms/tizen/import_project.png
+ [3]: img/guide/platforms/tizen/import_widget.png
+ [4]: img/guide/platforms/tizen/project_explorer.png
+
+重新生成项目，在**项目资源管理器**视图中右键单击并选择**生成项目**：
+
+![][5]
+
+ [5]: img/guide/platforms/tizen/build_project.png
+
+如*hello.wgt*的小部件包文件应在项目的根目录中生成。
+
+## 部署到仿真程序
+
+用鼠标右键单击**项目资源管理器**视图中的项目并选择**运行作为 → Tizen Web 模拟器应用程序**：
+
+![][6]
+
+ [6]: img/guide/platforms/tizen/runas_web_sim_app.png
+
+## 将部署到设备
+
+* 请确保目标设备正常启动、 连接和配置。必须正确设置其**日期和时间**设置。
+
+* 使用**连接资源管理器**视图选择的应用程序部署目标：**窗口显示视图 → 连接资源管理器**.
+
+ ![][7]
+
+* 用鼠标右键单击该项目，在**项目资源管理器**视图，然后选择 Run As **& rarr;Tizen Web 应用程序**：
+
+ ![][8]
+
+ [7]: img/guide/platforms/tizen/connection_explorer.png
+ [8]: img/guide/platforms/tizen/runas_web_app.png
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/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
new file mode 100644
index 0000000..c315b7d
--- /dev/null
+++ b/docs/zh/edge/guide/platforms/win8/index.md
@@ -0,0 +1,104 @@
+---
+
+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 平台指南
+
+本指南介绍如何设置您的 SDK 开发环境为 Windows 8 部署科尔多瓦的应用程序。请参阅下列特定于平台的详细信息：
+
+* 升级 Windows 8
+* Windows 8 的命令行工具
+
+上面的命令行工具请参阅科尔多瓦 3.0 以前的版本。关于当前界面的信息，请参阅命令行界面。
+
+Microsoft 不推荐使用在 Windows 8 和 Windows 室温下*地铁风格的应用程序*名称 MSDN 现在指的是这种类型的应用程序作为*Windows 应用商店*的应用程序，并且本指南跟随该公约 》。 此外，在本指南中*Windows 8*表示 Windows 8 和 Windows 室温下
+
+## 1.要求
+
+* Windows 8
+
+* Visual Studio 2012 专业或更好或 Visual Studio 2012 表示为 Windows 8
+
+按照说明[在这里][1]提交您的应用程序 Windows 存储区。
+
+ [1]: http://www.windowsstore.com/
+
+## 2.安装 SDK + 科尔多瓦
+
+* 设置您的 Visual Studio 2012 的首选变形。 所有产品的付费版本 (专业、 等) 让您构建 Windows 应用商店的应用程序。 你需要**表达为 Windows 8**来构建 Windows 应用商店应用程序使用的[速成版][2].
+
+* 下载并解压缩[科尔多瓦][3]的最新副本。您将使用的 `lib\windows-8` 子文件夹。
+
+ [2]: http://www.microsoft.com/visualstudio/eng/products/visual-studio-express-products
+ [3]: http://phonegap.com/download
+
+## 3.设置新项目
+
+你已经可以生成使用*HTML/JavaScript 跟踪*在 Windows 应用商店的应用程序中可用的 Windows 8 应用程序。 在 Windows 应用商店的应用程序中使用科尔多瓦，正如在其他科尔多瓦支持的平台上公开相同的 Api。
+
+* 打开 Visual Studio 2012 并选择**新的项目**.
+
+* 从项目列表从树，然后**空白应用程序**选择**安装 → 模板 → 其它语言 → JavaScript → Windows 存储区**。 输入你喜欢的如无论项目名称 `CordovaWin8Foo` 如本示例所示。
+
+ ![][4]
+
+* Microsoft 将继续使用 `default.html` 作为默认的主页，但大多数的 web 开发人员使用 `index.html` 。 （再加上它是有可能的在其他平台变形的您的项目中使用的 `index.html` 作为您的默认页的名称.)若要修复此问题，在解决方案资源管理器中重命名 `default.html` 文件到 `index.html` 。 然后双击 `package.appxmanifest` 文件，并将**起始页**该值更改为`index.html`.
+
+ ![][5]
+
+* 要包括 `cordova.js` 在项目中，右键单击 `js` 目录在解决方案资源管理器并选择**添加 → 新项目**。 找到 `cordova.js` 文件在 `lib\windows-8` 上面指出的目录。
+
+* 编辑的代码为 `index.html` 。将引用添加到 `cordova.js` 。您可以手动，或通过从解决方案资源管理器中拖动文件。
+
+ [4]: img/guide/platforms/win8/wsnewproject.png
+ [5]: img/guide/platforms/win8/wschangemanifest.png
+
+### 添加引用......
+
+ <! — — WinJS 的引用--> < 链接 href="//Microsoft.WinJS.1.0/css/ui-dark.css"rel ="样式表"/ >< 脚本 src="//Microsoft.WinJS.1.0/js/base.js">< / 脚本 >< 脚本 src="//Microsoft.WinJS.1.0/js/ui.js">< / 脚本 ><! — — 科尔多瓦--> < 脚本 src="/js/cordova.js">< / 脚本 ><! — — CordovaWin8Foo 的引用--> < 链接 href="/css/default.css"rel ="样式表"/ >< 脚本 src="/js/default.js">< / 脚本 >
+
+
+* 下一步，添加一些代码，演示科尔多瓦工作。
+
+### 添加 'deviceready' 处理......
+
+ <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>
+
+
+## 5.测试项目
+
+* 从 Visual Studio 中运行该项目。你会看到显示的消息框：
+
+ ![][6]
+
+ [6]: img/guide/platforms/win8/wsalert.png
+
+## 完成了 ！
+
+就这么简单 ！你现在准备好建立 Windows 应用商店的应用，科尔多瓦。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/guide/platforms/win8/tools.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/win8/tools.md b/docs/zh/edge/guide/platforms/win8/tools.md
new file mode 100644
index 0000000..e96e511
--- /dev/null
+++ b/docs/zh/edge/guide/platforms/win8/tools.md
@@ -0,0 +1,35 @@
+---
+
+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 的命令行工具
+
+`cordova`命令行实用程序是一个高级别的工具，允许您在一次跨几个平台生成的应用程序。 旧版本的科尔多瓦框架提供了特定于每个平台的命令行工具集。 若要使用它们作为 CLI 的替代，您需要从[cordova.apache.org][1]下载此版本的科尔多瓦。 下载文件中包含单独的档案，为每个平台。 展开您想要的目标平台。 这里描述的工具，通常可用在顶级 `bin` 目录中，否则为咨询**自述**文件，了解有关更多详细的指示。
+
+ [1]: http://cordova.apache.org
+
+## Windows 8
+
+Windows 8 的命令行工具仅支持创建新项目。必须从 cmd 或 powershell 的提示符下运行命令。
+
+## 创建一个项目
+
+运行 `create` 命令使用以下参数：
+
+* 您新的科尔多瓦 Windows 8 项目的路径
+
+* 之后反向域风格公约的包名称。这将成为默认 Namespace。
+
+* 项目名称
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/guide/platforms/win8/upgrading.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/win8/upgrading.md b/docs/zh/edge/guide/platforms/win8/upgrading.md
new file mode 100644
index 0000000..d886049
--- /dev/null
+++ b/docs/zh/edge/guide/platforms/win8/upgrading.md
@@ -0,0 +1,39 @@
+---
+
+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 版本。
+
+## 从 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