You are viewing a plain text version of this content. The canonical link for it is here.

Posted to commits@cordova.apache.org by GitBox <gi...@apache.org> on 2020/03/16 19:36:23 UTC

[GitHub] [cordova-docs] NiklasMerz opened a new pull request #1066: Add howto for WKWebViewOnly

NiklasMerz opened a new pull request #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066
 
 
   We recently got a lot of duplicate questions about the WKWebViewOnly flag. I think we should post this quick reference to direct people towards until the new cordova-ios major release is released.
   
   Most of the text is copied from @erisu s response https://github.com/apache/cordova-ios/issues/661#issuecomment-599500855 and this issue thread is a good example why we need such summary.
   
   I would love to hear feedback and fixes for this post and post this in the next days.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#discussion_r393381331

##########
File path: www/_posts/2020-03-18-wkwebviewonly.md
##########
@@ -0,0 +1,52 @@
+---
+layout: post
+author:
+ name: Niklas Merz
+ url: https://twitter.com/niklasmaerz
+title: "How To Use 'WKWebViewOnly'"
+categories: howto
+tags: ios
+---
+
+Apple started to reject apps with UIWebView references. The next major version of cordova-ios will contain no usage of UIWebView. You might need to update your app to fix this before the next version is released and this post sums up the required steps.
+
+This should solve the warning after uploading the app to App Store connect:
+
+> ITMS-90809: Deprecated API Usage - Apple will stop accepting submissions of apps that use UIWebView APIs.
+
+A new so called build flag `WKWebViewOnly` was introduced some versions ago to remove all UIWebView references from Cordovas code at build time.
+
+
+
+## Use a WKWebView plugin.
+
+The following example uses the cordova-plugin-wkwebview-engine plugin:
+
+* Add plugin cordova-plugin-wkwebview-engine, preferably the latest version 1.2.1
+* Add preference attribute CordovaWebViewEngine to the config.xml.
+* Add feature attribute CDVWKWebViewEngine to the config.xml.
+* Add preference `WKWebViewOnly` to the config.xml.
+
+Example config.xml with cordova-plugin-wkwebview-engine plugin
+
+```xml
+<platform name="ios">
+ <preference name="WKWebViewOnly" value="true" />
+
+ <feature name="CDVWKWebViewEngine">
+ <param name="ios-package" value="CDVWKWebViewEngine" />
+ </feature>
+
+ <preference name="CordovaWebViewEngine" value="CDVWKWebViewEngine" />
+</platform>
+```
+
+## Still getting the warning?
+If you are still getting the warning, most likely a plugin that you are using still references UIWebView. You will need to identify which plugin and contact the plugin developers on their support channel (plugin's repo) and request them to fix it. They can either remove the references or make use of this flag to wrap the references.
+
+## Using other WKWebView plugin
+
+There are alternatives to the official WKWebView plugin from the examples above. Make sure they are updated and you use the latest version. If you have any issue or usage questions with these plugins. Read their docs and request help from their support channels.

Review comment:
```suggestion
## Using other WKWebView plugin

There are alternatives to the official WKWebView plugin from the examples above. Make sure they are updated and you use the latest version. If you have any issue or usage questions with these plugins. Read their docs and request help from their support channels.

## Future Roadmap

The next major release of `cordova-ios` will remove all references of `UIWebView` from code. The flag will also be removed in the next major release as `WKWebView` will be Cordova's default webview. There is currently *no ETA* for the next major release.
```

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#discussion_r393379789
 
 

 ##########
 File path: www/_posts/2020-03-18-wkwebviewonly.md
 ##########
 @@ -0,0 +1,52 @@
+---
+layout: post
+author:
+    name: Niklas Merz
+    url: https://twitter.com/niklasmaerz
+title:  "How To Use 'WKWebViewOnly'"
+categories: howto
+tags: ios
+---
+
+Apple started to reject apps with UIWebView references. The next major version of cordova-ios will contain no usage of UIWebView. You might need to update your app to fix this before the next version is released and this post sums up the required steps.
+
+This should solve the warning after uploading the app to App Store connect:
+
+> ITMS-90809: Deprecated API Usage - Apple will stop accepting submissions of apps that use UIWebView APIs.
+
+A new so called build flag `WKWebViewOnly` was introduced some versions ago to remove all UIWebView references from Cordovas code at build time.
 
 Review comment:
   ```suggestion
   A new `preference` flag `WKWebViewOnly` was introduced to remove all `UIWebView` references from Cordova's code during compile-time. It is recommended to upgrade the `cordova-ios` platform to version `5.1.1`.
   ```

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#discussion_r393380142

Review comment:
```suggestion
If you are still getting the warning, it is most likely one or more plugins in your project are still references `UIWebView`. You will need to identify which plugins and contact those plugin's developers through their support channel (plugin's repo). They will need to fix their plugins by either remove the references or wrap them with the new flag.
```

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#discussion_r393381331

Review comment:
```suggestion
## Using other WKWebView plugin

There are alternatives to the official WKWebView plugin from the examples above. Make sure they have been updated and use the latest version. If you have any issues or usage questions with their plugins, please read their docs and request help through their support channels.

## Future Roadmap

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] NiklasMerz merged pull request #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

NiklasMerz merged pull request #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066
 
 
   

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#discussion_r393387218
 
 

 ##########
 File path: www/_posts/2020-03-18-wkwebviewonly.md
 ##########
 @@ -0,0 +1,52 @@
+---
+layout: post
+author:
+    name: Niklas Merz
+    url: https://twitter.com/niklasmaerz
+title:  "How To Use 'WKWebViewOnly'"
+categories: howto
+tags: ios
+---
+
+Apple started to reject apps with UIWebView references. The next major version of cordova-ios will contain no usage of UIWebView. You might need to update your app to fix this before the next version is released and this post sums up the required steps.
 
 Review comment:
   I moved the information about next major in its own section at the bottom. `Future Roadmap`

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] timbru31 edited a comment on issue #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

timbru31 edited a comment on issue #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#issuecomment-600550451
 
 
   Great! Thanks, Niklas!

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#discussion_r393378033

Review comment:
```suggestion
The following example uses the `[cordova-plugin-wkwebview-engine](https://github.com/apache/cordova-plugin-wkwebview-engine)` plugin:

* Add plugin `cordova-plugin-wkwebview-engine`, preferably the latest version **1.2.1**
* Add `preference` attribute `CordovaWebViewEngine` to the `config.xml`.
* Add `feature` attribute `CDVWKWebViewEngine` to the `config.xml`.
* Add `preference` `WKWebViewOnly` to the `config.xml`.

**Example `config.xml` with `cordova-plugin-wkwebview-engine` plugin**
```

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#discussion_r393381331

Review comment:
```suggestion
## Using other WKWebView plugin

## Future Road Map

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] timbru31 commented on issue #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

timbru31 commented on issue #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#issuecomment-600550451
 
 
   Great, thanks Niklas!

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#discussion_r393378070
 
 

 ##########
 File path: www/_posts/2020-03-18-wkwebviewonly.md
 ##########
 @@ -0,0 +1,52 @@
+---
+layout: post
+author:
+    name: Niklas Merz
+    url: https://twitter.com/niklasmaerz
+title:  "How To Use 'WKWebViewOnly'"
+categories: howto
+tags: ios
+---
+
+Apple started to reject apps with UIWebView references. The next major version of cordova-ios will contain no usage of UIWebView. You might need to update your app to fix this before the next version is released and this post sums up the required steps.
+
+This should solve the warning after uploading the app to App Store connect:
+
+> ITMS-90809: Deprecated API Usage - Apple will stop accepting submissions of apps that use UIWebView APIs.
+
+A new so called build flag `WKWebViewOnly` was introduced some versions ago to remove all UIWebView references from Cordovas code at build time.
+
+<!--more-->
+
+## Use a WKWebView plugin.
+
+The following example uses the cordova-plugin-wkwebview-engine plugin:
+
+* Add plugin cordova-plugin-wkwebview-engine, preferably the latest version 1.2.1
+* Add preference attribute CordovaWebViewEngine to the config.xml.
+* Add feature attribute CDVWKWebViewEngine to the config.xml.
+* Add preference `WKWebViewOnly` to the config.xml.
+
+Example config.xml with cordova-plugin-wkwebview-engine plugin
+
+```xml
+<platform name="ios">
+    <preference name="WKWebViewOnly" value="true" />
+
+    <feature name="CDVWKWebViewEngine">
+        <param name="ios-package" value="CDVWKWebViewEngine" />
+    </feature>
+
+    <preference name="CordovaWebViewEngine" value="CDVWKWebViewEngine" />
+</platform>
+```
+
+## Still getting the warning?
 
 Review comment:
   ```suggestion
   ## Still getting the warning?
   
   ```

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#discussion_r393377057
 
 

 ##########
 File path: www/_posts/2020-03-18-wkwebviewonly.md
 ##########
 @@ -0,0 +1,52 @@
+---
+layout: post
+author:
+    name: Niklas Merz
+    url: https://twitter.com/niklasmaerz
+title:  "How To Use 'WKWebViewOnly'"
+categories: howto
+tags: ios
+---
+
+Apple started to reject apps with UIWebView references. The next major version of cordova-ios will contain no usage of UIWebView. You might need to update your app to fix this before the next version is released and this post sums up the required steps.
 
 Review comment:
   ```suggestion
   Apple started to reject apps with `UIWebView` references. You will need to update your app to fix this and this post sums up the required steps.
   ```

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#discussion_r393380142

Review comment:
```suggestion
If you are still getting the warning, most likely a plugin that you are using still references `UIWebView`. You will need to identify which plugin and contact the plugin developers on their support channel (plugin's repo) and request them to fix it. They can either remove the references or make use of this flag to wrap the references.
```

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] NiklasMerz commented on issue #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

NiklasMerz commented on issue #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#issuecomment-599911527
 
 
   @erisu Thank you for your edits. Good to merge and deployment?

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

erisu commented on a change in pull request #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#discussion_r393377057
 
 

 ##########
 File path: www/_posts/2020-03-18-wkwebviewonly.md
 ##########
 @@ -0,0 +1,52 @@
+---
+layout: post
+author:
+    name: Niklas Merz
+    url: https://twitter.com/niklasmaerz
+title:  "How To Use 'WKWebViewOnly'"
+categories: howto
+tags: ios
+---
+
+Apple started to reject apps with UIWebView references. The next major version of cordova-ios will contain no usage of UIWebView. You might need to update your app to fix this before the next version is released and this post sums up the required steps.
 
 Review comment:
   ```suggestion
   Apple started to reject apps with `UIWebView` references. You will need to update your app to fix and this post sums up the required steps.
   ```

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org

[GitHub] [cordova-docs] timbru31 edited a comment on issue #1066: Add howto for WKWebViewOnly

Posted by GitBox <gi...@apache.org>.

timbru31 edited a comment on issue #1066: Add howto for WKWebViewOnly
URL: https://github.com/apache/cordova-docs/pull/1066#issuecomment-600550451
 
 
   Great thanks, Niklas!

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org