C4－Cordova在iOS平台的使用
一、创建工程及运行
1、安装部署工具
ios-sim和ios-deploy工具，可以使你通过命令行在iOS模拟器和iOS设备上面启动app。
$ npm install -g ios-sim
$ npm install -g ios-deploy
2、Create a New Project
$ cordova create hello com.example.hello "HelloWorld" $ cd hello $ cordova platform add ios $ cordova prepare # or "cordova build"
3、部署运行app
部署在一个已经连接的iOS设备上：
$ cordova run ios --device
部署在一个默认的iOS模拟器上：
$ cordova emulate ios
二、config.xml详解
config.xml文件控制了app的一些基本设置信息。
1、EnableViewportScale (boolean类型, 默认是false): 设置为true，允许meta标签的视窗在用户限定的范围内缩放或者禁用。
<preference name="EnableViewportScale" value="true"/>
像如下的html一样来创建一个视窗，可以禁止缩放，可以在渲染的WebView里灵活缩放。
<meta name='viewport' content='width=device-width, initial-scale=1, user-scalable=no' />
2、MediaPlaybackAllowsAirPlay (boolean类型, 默认是true): 设置false会阻止view对Air Play的支持。默认在UIWebView和WKWebView是可用的。
<preference name="MediaPlaybackAllowsAirPlay" value="false"/>
3、MediaPlaybackRequiresUserAction (boolean类型, 默认是false): 设置true禁止HTML5上面的音视频响应自动播放属性的设置或者js代码的调用引起的自动播放事件。
<preference name="MediaPlaybackRequiresUserAction" value="true"/>
4、AllowInlineMediaPlayback (boolean类型, 默认是false): 设置true允许HTML5内联媒体在屏幕范围内播放，通过浏览器支持控制而不是远胜控制。可以通过给任意<video>元素添加webkit-playsinline属性来实现。
<preference name="AllowInlineMediaPlayback" value="true"/>
5、BackupWebStorage (string类型, 可以设置为none，local或者默认是cloud): 设置cloud允许备份数据到iCloud。设置local仅允许通过iTunes同步备份。设置none禁止备份。
<preference name="BackupWebStorage" value="local"/>
6、TopActivityIndicator (string类型, 默认是gray): 控制ActivityIndicator在状态栏的显示，可选的有whiteLarge, white, and gray。
<preference name="TopActivityIndicator" value="white"/>
7、KeyboardDisplayRequiresUserAction (boolean类型, 默认是true): 设置为false允许键盘响应inputs元素的调用。
<preference name="KeyboardDisplayRequiresUserAction" value="false"/>
8、SuppressesIncrementalRendering (boolean类型, 默认是false): 设置true的话，元素渲染到屏幕前会等待所有的内容获取完全。
<preference name="SuppressesIncrementalRendering" value="true"/>
9、GapBetweenPages (float类型, 默认是0): 表示页面间距。
<preference name="GapBetweenPages" value="0"/>
10、PageLength (float类型, 默认是0): 在页面滚动方向上的页面长度。当页面滚动方式是由右到左或者由左到右的时候，这个属性代表的是每个页面的宽度。当页面滚动方式是由上到下或者由下到上的时候，这个属性代表的是每个页面的高度。默认值是0，意味着页面的尺寸有视图决定。
<preference name="PageLength" value="0"/>
11、PaginationBreakingMode (string类型, 默认是page): 可选项有page和column。这个属性决定了CSS属性设置的column-和page-breaking是否能生效。此属性设置了column的时候，由CSS控制的页面元素内容就会由column-breaking替代page-breaking。
<preference name="PaginationBreakingMode" value="page"/>
12、PaginationMode (string类型, 默认是unpaginated): 可选项有unpaginated, leftToRight, topToBottom, bottomToTop, and rightToLeft。这个属性决定了webview的内容在充满视窗的时候是分页还是显示一个长的滑动的view。如果设置了分页格式，内容元素的分页会导致webview调用PageLength和GapBetweenPages的value去布局内容。
<preference name="PaginationMode" value="unpaginated"/>
13、UIWebViewDecelerationSpeed (string类型, 默认是normal): 可选项有normal, fast。这个属性控制了滑动的减速度。默认的normal是最接近原生app效果的，而fast选项是针对移动端Safari的。
<preference name="UIWebViewDecelerationSpeed" value="fast" />
14、ErrorUrl (string类型, 默认无设置): 如果设置了，在app里引用此本地页面文件会报错。
<preference name="ErrorUrl" value="myErrorPage.html"/>
15、OverrideUserAgent (string类型, 默认无设置): 如果设置了，设置的值就会替代webview原来的UserAgent（用户代理），在确定获取远端页面的请求是由app发出的还是由浏览器发出的时候UserAgent是很有用的。使用警告，这可能导致服务兼容问题。大多数情况下，用AppendUserAgent代替。
<preference name="OverrideUserAgent" value="Mozilla/5.0 My Browser" />
16、AppendUserAgent (string类型, 默认无设置): 如果设置了，设置的值就会加到webview原来的UserAgent后面。设置OverrideUserAgent的时候，此设置会被忽略。
<preference name="AppendUserAgent" value="My Browser" />
17、target-device (string类型, 默认是universal): 可选项有handset, tablet, universal。此属性直接显示在Xcode工程的TARGETED_DEVICE_FAMILY上面。注意，如果你的target设置了universal，你提交应用的时候需要同时提供iPhone和iPad的截屏，否则可能被拒。
<preference name="target-device" value="universal" />
18、deployment-target (string类型, 默认无设置): 设置了应用支持的iOS系统最低版本。详细信息可以查看苹果官方文档Deployment Target Settings
<preference name="deployment-target" value="7.0" />
19、CordovaWebViewEngine (string类型, 默认是 'CDVUIWebViewEngine'): 设置WebView的引擎插件提供给本地的app，插件必须遵守CDVWebViewEngineProtocol协议。设置的value必须匹配已安装的WebView引擎插件在'feature'标签内的名字。此设置通常为自动设置安装。
<preference name="CordovaWebViewEngine" value="CDVUIWebViewEngine" />
20、SuppressesLongPressGesture (boolean类型, 默认是false): 设置为true避免了iOS9+的长按webview显示一个放大镜控件的效果出现。测试你的应用程序，因为这可能影响文本选择的功能。
<preference name="SuppressesLongPressGesture" value="true" />
21、Suppresses3DTouchGesture (boolean类型, 默认是false): 设置为true避免支持3D Touch的设备在用户用力长按webview的时候出现一个放大镜控件。请测试你的应用，因为这禁止了onclick操作，但是ontouchend依然生效。如果此设置为true，SuppressesLongPressGesture同样会被设置为true并有效。
<preference name="Suppresses3DTouchGesture" value="true" />
22、CDVSystemSchemesOverride (string类型, 默认是 maps,tel,telprompt): 用逗号分隔的URL schemes列表里的URL是被允许进入系统的，而不是由科尔多瓦WebView本身。
<preference name="CDVSystemSchemesOverride" value="maps,tel,telprompt" />
