Android SqlCipher：从SafeHelperFactory迁移至SupportOpenHelperFactory

一、从SafeRoom到新版SQLCipher的迁移方案 #

SafeRoom是对Room的加密封装，底层依赖旧版SQLCipher for Android。要切换到官方新版SQLCipher Android库，可按以下步骤操作：

• 替换依赖：移除项目中SafeRoom及旧版SQLCipher的依赖，添加新版SQLCipher Android库的依赖包，注意选择与当前Room版本兼容的SQLCipher版本。
• 重构Room数据库配置：原项目中使用SafeRoomHelperFactory创建加密的Room数据库，现在需要自行实现SupportSQLiteOpenHelper.Factory接口，基于新版SQLCipher的API（如SQLiteDatabase.openOrCreateDatabase）构建加密数据库连接，将自定义Factory传入Room的数据库构建器。
• 数据库文件无需额外迁移：由于新旧SQLCipher底层加密核心逻辑一致，只要加密密钥正确，现有加密数据库文件可直接被新版SQLCipher读取，无需做文件格式转换。
• 全流程测试：替换完成后，需覆盖测试数据库的打开、CRUD操作、Room自带的版本迁移逻辑（如果有），确保加密解密流程正常运行。

二、架构兼容性确认 #

完全兼容。新旧SQLCipher Android库的核心都是基于SQLCipher加密引擎，仅API层面有调整（如初始化方式、Helper类的调用逻辑），架构设计上没有本质差异。SafeRoom的作用是将旧版SQLCipher适配到Room体系中，现在改用新版SQLCipher自行实现Room的加密Helper，只是用新API完成相同的适配工作，不会出现架构层面的冲突，符合迁移指南中“仅需调整API”的描述。

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