同包名安卓原生应用升级为React Native版本后能否访问原有Realm数据库数据
同包名升级后RN版读取旧原生Realm数据的可行性说明
核心结论
只要满足几个基础匹配条件,新版RN应用完全可以正常读取旧原生安卓版本存储的Realm数据。
必须满足的前提条件
- 存储路径对齐:安卓系统中同包名应用升级不会清空私有数据目录,原生端默认Realm文件存放在
/data/data/[应用包名]/files/下,只要RN端初始化Realm时没有自定义特殊路径,默认配置就会自动定位到同一个数据库文件。如果原生端自定义过存储路径,RN端初始化时要通过path参数指定完全相同的路径。 - Schema完全匹配:RN端定义的所有Realm数据模型,必须和原生端的模型名称、字段名、字段类型1:1对应,同时RN端初始化时传入的
schemaVersion参数要和原生端最后使用的Schema版本号完全一致。如果升级过程中需要调整Schema,要按照Realm官方迁移规则编写对应迁移逻辑,和原生端的升级逻辑对齐即可。 - 核心版本兼容:Realm的数据库文件格式是跨平台统一的,常规小版本差异不会影响读取,只要避免两端Realm大版本跨度超过2个主版本号即可。如果原生端使用的Realm Java版本过老(早于v10),可以先在测试环境验证兼容性,必要时做版本适配。
常见踩坑注意事项
- 如果原生端的Realm数据库设置了加密密钥,RN端初始化时必须传入完全相同的密钥,否则会报文件损坏错误
- 测试阶段不要在RN端的Realm初始化配置中加
deleteRealmIfMigrationNeeded参数,否则第一次启动会直接清空旧版本的全部数据 - 建议升级前先在测试机上安装旧原生版写入测试数据,再安装新版RN包直接覆盖安装,验证数据读取逻辑正常后再上线
内容的提问来源于stack exchange,提问作者Paulo Marcelo
相关产品推荐
相关产品推荐

