Java/Kotlin安卓应用迁移至React Native时如何保留SharedPreferences数据

核心前提：React Native官方/社区版AsyncStorage在安卓端的默认存储本质就是SharedPreferences，对应文件名为RKStorage.xml，和你原生应用的存量SharedPreferences文件同处于/data/data/[应用包名]/shared_prefs/目录下，迁移门槛极低。

方案1：原生层一次性全量迁移（推荐） #

该方案在应用启动阶段自动完成数据迁移，对用户完全无感知，完成后后续直接走RN的AsyncStorage逻辑即可。

实现步骤： #

• 在安卓原生工程的MainActivity或自定义Application类的onCreate生命周期中添加迁移逻辑，先判断是否已经完成过迁移，避免重复操作
• 读取原有存量SharedPreferences的所有键值对
• 将键值对批量写入AsyncStorage对应的RKStorage SharedPreferences实例
• 写入完成后标记迁移状态，下次启动不再执行迁移逻辑

代码示例（Kotlin）： #

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 替换为你原有应用的SharedPreferences文件名
    val oldSp = getSharedPreferences("custom_sp_file_name", MODE_PRIVATE)
    val isMigrated = oldSp.getBoolean("sp_migrated_finished", false)
    
    if (!isMigrated) {
        // 获取AsyncStorage对应的SharedPreferences实例
        val asyncStorageSp = getSharedPreferences("RKStorage", MODE_PRIVATE)
        val edit = asyncStorageSp.edit()
        
        // 遍历原有SP的所有键值对写入
        oldSp.all.forEach { (key, value) ->
            when(value) {
                is String -> edit.putString(key, value)
                is Int -> edit.putString(key, value.toString())
                is Boolean -> edit.putString(key, value.toString())
                is Long -> edit.putString(key, value.toString())
                is Float -> edit.putString(key, value.toString())
                // 复杂对象可转JSON字符串后存储
                else -> edit.putString(key, value.toString())
            }
        }
        // 标记迁移完成
        edit.putBoolean("sp_migrated_finished", true)
        edit.apply()
    }
}

注意：RN AsyncStorage默认只支持字符串类型的值，如果你原有SP中存在非字符串类型数据，迁移时建议统一转成字符串/JSON字符串存储，RN侧读取后再做类型解析即可。

特殊适配： #

如果你使用了自定义配置的AsyncStorage（比如切换为SQLite存储实现），不能直接操作RKStorage的SP文件，只需把读出来的SP键值对通过RN桥接模块传给JS层，调用AsyncStorage.multiSet批量写入即可。

方案2：封装原生SharedPreferences桥接模块供RN调用 #

如果不想做数据迁移，也可以直接把原生的SharedPreferences操作封装成RN原生模块，RN侧直接调用原生方法读写原有SP的内容，无需迁移数据。

实现步骤： #

• 安卓原生层实现SP读写的Native Module，暴露getItem、setItem、removeItem等方法给JS层
• JS层封装对应的工具类，直接调用原生方法操作数据，完全兼容原有存量数据

优缺点： #

• 优点：无需迁移数据，不会出现迁移失败导致的数据丢失风险
• 缺点：后续所有存储操作都走桥接，性能略低于直接用RN的AsyncStorage，而且如果后续要做iOS兼容需要再封装iOS端的NSUserDefaults对应逻辑

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