cordova-plugin-cronapp-migrate-storage

Cordova plugin that migrates WebSQL and localStorage data when you start using the `cordova-plugin-ionic-webview` plugin. This works only for Android!

Usage no npm install needed!

<script type="module">
  import cordovaPluginCronappMigrateStorage from 'https://cdn.skypack.dev/cordova-plugin-cronapp-migrate-storage';
</script>

README

cordova-plugin-cronapp-migrate-storage

Cordova plugin that migrates WebSQL and localStorage data when you start using the cordova-plugin-ionic-webview plugin. This works only for Android!

Installation

Straight forward, just via cordova plugin add.

cordova plugin add cordova-plugin-cronapp-migrate-storage --save

The plugin uses the WKPort preference supplied to the ionic webview. If that was not found, the no port will be used.

Testing

To test this, you will have to do the following:

  • Delete the app from your device
  • Remove the webview and migrate plugins from your app:
cordova plugin rm --save cordova-plugin-ionic-webview cordova-plugin-cronapp-migrate-storage
  • Build your app and run it. Store something in localStorage, WebSQL and IndexedDB.
  • Add the plugins back:
cordova plugin add --save cordova-plugin-ionic-webview@^5.0.0 cordova-plugin-cronapp-migrate-storage
  • Build your app and run it. The stored data must all exist!

Caveats / Warnings / Gotchas

  • This has been tested only with cordova-plugin-ionic-webview@5.0.0!
  • Currently, this plugin does not work on simulators. PRs welcome!
  • IndexedDB migration has not been implemented in Android, because it looks tricky.
  • IndexedDB migration on iOS may be buggy, a PR or two will be needed to make it better.
  • This copy is uni-directional, from old webview to new webview. It does not go the other way around. So essentially, this plugin will run only once!

Thanks

Most of the code in this plugin was either adapted or inspired from a plethora of other sources. Creating this plugin would not have been possible if not for these repositories and their contributors:

TODO

  • Pull out debug flags to make them platform specific and not rely on booleans in the code.
  • Add some unit testing.