Cordova Plugin: Migrate iOS LocalStorage

A Cordova plugin that migrates localStorage data from UIWebView to WKWebView on iOS. This plugin is useful when transitioning from UIWebView to WKWebView in Capacitor or Cordova iOS applications.

Description

When migrating a Cordova app from UIWebView to WKWebView, localStorage data is stored in different locations, which can cause users to lose their data during the transition. This plugin handles the migration of localStorage data from the UIWebView storage location to the WKWebView storage location.

Installation

cordova plugin add cordova-plugin-migrate-ios-localstorage

Or directly from GitHub:

cordova plugin add https://github.com/Chuckv01/cordova-plugin-migrate-ios-localstorage.git

Usage

The plugin provides a simple API to migrate localStorage data. Call the migrate method early in your app initialization:

import 'cordova-plugin-migrate-ios-localstorage';
...

document.addEventListener('deviceready', function() {
  (window as any).cordova.plugins.MigrateLocalStorage.migrate();
    .then(success => {
      console.log('Migration completed successfully: ' + success);
    })
    .catch(error => {
      console.error('Migration failed: ' + error);
    });
}, false);

API

migrate()

Migrates localStorage data from UIWebView to WKWebView.

Returns a Promise that resolves to a boolean indicating success or rejects with an error.

How it Works

1. The plugin checks if localStorage already has data in WKWebView format
2. If not, it initializes localStorage with a marker
3. It polls until storage is confirmed ready
4. Then it copies the SQLite database records from the UIWebView location to the WKWebView location

Requirements

• Capacitor OR Cordova iOS 4.0.0+
• iOS 9.0+

License

This project is licensed under the Apache License 2.0.