cordova-plugin-ionic-migrate-localstorage

0.0.2 • Public • Published

Migrate LocalStorage from UIWebview to Ionic WKWebView

This plugin can be used in conjunction with cordova-plugin-ionic-webview to persist LocalStorage data when migrating from UIWebView to ionic's WKWebView. All related files will be copied over automatically during startup so the user can simply pick up where they left of.

How to use

Simply add the plugin to your cordova project via the cli:

cordova plugin add cordova-plugin-ionic-migrate-localstorage

Notes

  • LocalStorage files are only copied over once and only if no LocalStorage data exists for ionic's WKWebView yet. This means that if you've run your app with WKWebView before this plugin will likely not work. To test if data is migrated over correctly:

    1. Delete the app from your emulator or device
    2. Remove cordova-plugin-ionic-migrate-localstorage
    cordova plugin rm cordova-plugin-ionic-migrate-localstorage
    
    1. Remove the cordova-plugin-ionic-webview
    cordova plugin rm cordova-plugin-ionic-webview
    
    1. Run your app and store some data in LocalStorage
    2. Add both plugins back
    cordova plugin add cordova-plugin-ionic-webview@1.1.16
    
    cordova plugin add cordova-plugin-ionic-migrate-localstorage
    
    1. Run your app again. Your data should still be there!
  • Once the data is copied over, it is not being synced back to UIWebView so any changes done in WKWebView will not persist should you ever move back to UIWebView. If you have a problem with this, let us know in the issues section!

Background

One of the drawbacks of migrating Cordova apps to WKWebView is that LocalStorage data does not persist between the two. Unfortunately, cordova-plugin-ionic-webview does not offer a solution for this out of the box.

Disclaimer

This plugin has only been tested with cordova-plugin-ionic-webview v1.1.16, so use at your own risk.

Credits

This plugin is a fork of a fork of a copy of the Telerik WKWebView source, so all props go to someone else. #open-source

Package Sidebar

Install

npm i cordova-plugin-ionic-migrate-localstorage

Weekly Downloads

2

Version

0.0.2

License

Apache 2.0

Unpacked Size

18.5 kB

Total Files

6

Last publish

Collaborators

  • paulpatarinski