如何在Room KMP中替换自带SQLite二进制文件为自定义版本

可以替换，但不同平台的实现方式有差异，以下是各平台的具体操作方案：

Android平台 #

• Android上Room默认优先使用系统自带SQLite，你可以通过引入自定义编译的SQLite库覆盖默认实现：
  1. 编译生成自定义SQLite的.aar或.so库文件。
  2. 在Android模块的build.gradle.kts中，排除Room依赖的默认SQLite组件，再引入自定义库：

     dependencies {
         implementation("androidx.room:room-runtime:${roomVersion}") {
             exclude(group = "androidx.sqlite", module = "sqlite")
             exclude(group = "androidx.sqlite", module = "sqlite-framework")
         }
         // 引入你的自定义SQLite库
         implementation(files("path/to/your-custom-sqlite.aar"))
     }
     

  3. 确保自定义SQLite库兼容Room的API要求，避免兼容性错误。

iOS平台 #

• iOS上BundledSQLiteDriver使用Room打包的SQLite二进制，替换步骤如下：
  1. 编译支持arm64、x86_64架构的iOS自定义SQLite静态库。
  2. 在KMP项目的iOS目标配置中，排除默认SQLite依赖并链接自定义库：

     iosX64 {
         binaries {
             framework {
                 export("androidx.room:room-runtime:${roomVersion}") {
                     exclude(group = "androidx.sqlite", module = "sqlite-bundled")
                 }
                 // 链接自定义SQLite库
                 linkerOpts.add("-L/path/to/your-custom-sqlite-lib")
                 linkerOpts.add("-lyour-custom-sqlite")
             }
         }
     }
     iosArm64 {
         // 复制上述iosX64的配置即可
     }
     

  3. 保证自定义SQLite的符号与Room期望一致，避免运行时链接异常。

桌面平台（Windows/macOS/Linux） #

• 桌面平台的处理逻辑与iOS类似：
  1. 编译对应平台的自定义SQLite库。
  2. 在KMP的桌面目标配置中，排除默认SQLite依赖，添加自定义库的链接参数。以macOS为例：

     macosX64 {
         binaries {
             executable {
                 exclude(group = "androidx.sqlite", module = "sqlite-bundled")
                 linkerOpts.add("-L/path/to/custom-sqlite")
                 linkerOpts.add("-lyour-custom-sqlite")
             }
         }
     }
     

关键注意事项 #

• 自定义SQLite版本必须兼容Room依赖的SQLite API，比如Room用到的扩展、函数等，自定义版本都需要支持，否则会触发运行时异常。
• 需在所有目标平台上完成测试，确保数据库操作正常，无崩溃或数据异常。
• 部分平台需额外配置，比如iOS要将自定义库加入项目的Frameworks, Libraries, and Embedded Content列表。

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