Added NPM Package for Cordova 7 ====== Project cloned from https://github.com/ionic-team/cordova-plugin-wkwebview-engine Cordova WKWebView Engine ====== This plugin is an extension of the [Apache Cordova WKWebView plugin](https://github.com/apache/cordova-plugin-wkwebview-engine). It includes enhancements to resolve some of the issues surrounding XHR requests, along with some DOM exception issues. Ionic is working with the Cordova team to fully test these changes with the eventual goal of merging the updates into the official Cordova plugin. After the beta testing period, our hope is to make the WKWebView plugin an Ionic default so all users can easily take advantage of this plugin's improved performance over UIWebView. This plugin only supports iOS 9 and above and will fall back to UIWebView on iOS 8. The WKWebView plugin is only used by iOS, so ensure the `cordova-ios` platform is installed. Additionly, the `cordova-ios` platform version must be `4.0` or greater. Installation Instructions ------------------- Ensure the latest Cordova CLI is installed: (Sudo may be required) ``` npm install cordova -g ``` Ensure the `ios` platform has been added: ``` ionic cordova platform ls ``` If the iOS platform is not listed, run the following command: ``` ionic cordova platform add ios ``` If the iOS platform is installed but the version is < `4.x`, run the following commands: ``` ionic cordova platform update ios ionic cordova plugin save # creates backup of existing plugins rm -rf ./plugins # delete plugins directory ionic cordova prepare # re-install plugins compatible with cordova-ios 4.x ``` Install the WKWebViewPlugin: ``` ionic cordova plugin add https://github.com/ionic-team/cordova-plugin-wkwebview-engine.git --save ``` **Note:** If you already had [apache/cordova-plugin-wkwebview-engine](https://github.com/apache/cordova-plugin-wkwebview-engine) install make sure that is removed before using this version. ``` ionic cordova plugin rm cordova-plugin-wkwebview-engine ``` Build the platform: ``` ionic cordova prepare ``` Test the app on an iOS 9 or 10 device: ``` ionic cordova run ios ``` An easy way to verify that WKWebView has been installed on iOS is to check if `window.indexedDB` exists. For example: ``` if (window.indexedDB) { console.log("I'm in WKWebView!"); } else { console.log("I'm in UIWebView"); } ``` Required Permissions ------------------- WKWebView may not fully launch (the deviceready event may not fire) unless if the following is included in config.xml: #### config.xml ``` ``` Application Transport Security (ATS) in iOS 9 ----------- The next released version of the [cordova-cli 5.4.0](https://www.npmjs.com/package/cordova) will support automatic conversion of the [<access>](http://cordova.apache.org/docs/en/edge/guide/appdev/whitelist/index.html) tags in config.xml to Application Transport Security [ATS](https://developer.apple.com/library/prerelease/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW33) directives. Upgrade to the version 5.4.0 to use this new functionality. Apple Issues ------- The `AllowInlineMediaPlayback` preference will not work because of this [Apple bug](http://openradar.appspot.com/radar?id=6673091526656000). This bug [has been fixed](https://issues.apache.org/jira/browse/CB-11452) in [iOS 10](https://twitter.com/shazron/status/745546355796389889). Limitations -------- There are several [known issues](https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20labels%20%3D%20wkwebview-known-issues) with the official Cordova WKWebView plugin. The Ionic team thinks we have resolved several of the major issues. Please [let us know](https://github.com/driftyco/cordova-plugin-wkwebview-engine/issues) if something isn't working as expected.