测试已测试 | ✓ |
语言语言 | Obj-CObjective C |
许可证 | Apache 2 |
发布最后发布 | 2016年11月 |
由 Holly Schinsky、Shazron Abdullah 维护。
该插件使 Cordova
使用 WKWebView
组件而非默认的 UIWebView
组件,且只能在拥有 iOS 9.0 SDK 的系统上安装。
在 iOS 9 中,苹果修复了 iOS 8 中存在的 问题,即无法使用 file:// 加载本地文件,必须依赖本地 web 服务器。但是,在没有在您的服务器上启用 CORS 的情况下,您仍然无法使用来自 file:// 协议的 XHR。
此插件需要 cordova-ios > 4.0.0。
为了安装当前版本
cordova create wkwvtest my.project.id wkwvtest
cd wkwvtest
cordova platform add ios@4
cordova plugin add cordova-plugin-wkwebview-engine
为了测试开发版本
cordova create wkwvtest my.project.id wkwvtest
cd wkwvtest
cordova platform add https://github.com/apache/cordova-ios.git#master
cordova plugin add https://github.com/apache/cordova-plugin-wkwebview-engine.git#master
你还必须安装 Xcode 7(iOS 9 SDK)。通过运行以下命令检查 Xcode 版本
xcode-select --print-path
除非在 config.xml 中包含以下内容,否则 WKWebView 可能无法完全启动(deviceready 事件可能不会触发)
<feature name="CDVWKWebViewEngine">
<param name="ios-package" value="CDVWKWebViewEngine" />
</feature>
<preference name="CordovaWebViewEngine" value="CDVWKWebViewEngine" />
在 iOS 8 系统上,Apache Cordova 在运行时会切换到使用 UIWebView 引擎而不是使用此插件。如果您想在 iOS 8 和 iOS 9 平台上都使用 WKWebView,您将不得不依赖本地 web 服务器。
我们有一个 实验性插件 可以做到这一点。您应使用该插件而不是这个插件。
即将发布的 cordova-cli 5.4.0 的下一个版本将支持自动转换 config.xml 中的 <access> 标签到应用传输安全 (ATS) 指令。升级到版本 5.4.0 以使用此新功能。
如果您是从UIWebView升级的,请注意WKWebView的使用限制,这些限制在[我们的问题跟踪器](https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20labels%20%3D%20wkwebview-known-issues)中有详细介绍。
AllowInlineMediaPlayback
设置将不会工作,因为这是一个[Apple的bug](http://openradar.appspot.com/radar?id=6673091526656000)。此bug已在iOS 10中得到修复。