如何将Cordova应用的window.localStorage迁移至Android原生应用SharedPreferences

嘿，这个场景我刚好处理过！要实现Cordova的window.localStorage到Android原生SharedPreferences的无缝迁移，核心就是找到Cordova存储数据的位置，把它读出来再写入原生的偏好设置里，具体步骤我给你拆解清楚：

Cordova在Android上是基于WebView运行的，它的localStorage本质是存在应用私有目录下的SQLite数据库文件里。我们要做的就是读取这个SQLite里的键值对，再写入到原生应用使用的SharedPreferences中。

1. 定位并读取Cordova的localStorage数据 #

Cordova的localStorage文件通常位于应用私有目录的app_webview/Local Storage/下，文件名一般是file__0.localstorage（不同WebView版本可能略有差异，你可以通过Android Studio的Device File Explorer查看旧版应用的实际路径）。因为是应用私有目录，不需要申请外部存储权限就能直接访问。

读取数据的示例代码：

private void migrateLocalStorageToPrefs() {
    // 构建Cordova localStorage的SQLite文件路径
    String storagePath = getApplicationContext().getFilesDir().getParent() + "/app_webview/Local Storage/file__0.localstorage";
    File localStorageFile = new File(storagePath);

    if (!localStorageFile.exists()) {
        // 没有旧数据，无需迁移
        return;
    }

    SQLiteDatabase db = null;
    Cursor cursor = null;
    try {
        // 以只读方式打开SQLite数据库
        db = SQLiteDatabase.openDatabase(storagePath, null, SQLiteDatabase.OPEN_READONLY);
        // 查询ItemTable表，这是localStorage存储键值对的表
        cursor = db.query("ItemTable", new String[]{"key", "value"}, 
                          null, null, null, null, null);
        
        if (cursor != null && cursor.moveToFirst()) {
            do {
                String key = cursor.getString(cursor.getColumnIndexOrThrow("key"));
                String value = cursor.getString(cursor.getColumnIndexOrThrow("value"));
                // 将读取到的键值对写入SharedPreferences
                saveToSharedPreferences(key, value);
            } while (cursor.moveToNext());
        }

        // 迁移完成后可以删除原文件，避免重复迁移
        localStorageFile.delete();
    } catch (SQLiteException e) {
        e.printStackTrace();
    } finally {
        // 关闭游标和数据库连接
        if (cursor != null) cursor.close();
        if (db != null) db.close();
    }
}

2. 写入Android SharedPreferences #

写一个工具方法，把读取到的键值对存入你原生应用使用的SharedPreferences（注意要和原生应用的偏好设置名称一致，比如示例中的MyAppUserPrefs）：

private void saveToSharedPreferences(String key, String value) {
    SharedPreferences prefs = getApplicationContext()
            .getSharedPreferences("MyAppUserPrefs", Context.MODE_PRIVATE);
    SharedPreferences.Editor editor = prefs.edit();
    editor.putString(key, value);
    // 用apply()异步提交，避免阻塞主线程
    editor.apply();
}

3. 合理触发迁移逻辑 #

建议在原生应用的Application类的onCreate()方法或者启动页的初始化阶段执行迁移，同时要加一个迁移完成标记，避免每次启动都重复执行：

@Override
public void onCreate() {
    super.onCreate();
    SharedPreferences prefs = getApplicationContext()
            .getSharedPreferences("MyAppUserPrefs", Context.MODE_PRIVATE);
    boolean isMigrationDone = prefs.getBoolean("localStorageMigrationDone", false);
    
    if (!isMigrationDone) {
        migrateLocalStorageToPrefs();
        // 标记迁移完成
        prefs.edit().putBoolean("localStorageMigrationDone", true).apply();
    }
}

• 路径适配：不同Cordova版本、WebView版本可能会导致localStorage文件路径或文件名不同，一定要在真实设备上查看旧版应用的实际存储位置。
• 数据类型转换：Cordova的localStorage只能存储字符串，所以迁移时用putString()即可，如果原生应用需要其他数据类型（比如布尔值、整数），需要自行做类型转换。
• 测试验证：一定要做端到端测试：安装旧版Cordova应用→登录生成localStorage数据→安装新版原生应用→检查SharedPreferences中的数据是否正确，以及是否能自动登录。

内容的提问来源于stack exchange，提问作者raghu