SQLDelight 2.x版本中模块依赖配置问题解析

问题背景

在使用SQLDelight 2.0.2及以上版本时，开发者可能会遇到一个关于模块依赖配置的兼容性问题。具体表现为当尝试通过Gradle版本目录(Versions Catalog)方式配置SQLDelight数据库模块依赖时，系统会抛出类型转换异常。

问题现象

开发者在build.gradle.kts配置文件中使用如下方式声明SQLDelight数据库时：

sqldelight {
  databases {
    create("MyDb") {
      dialect(libs.sqldelight.dialect)
      module(libs.sqldelight.module.json)
    }
  }
}

其中版本目录(libs.versions.toml)中相关依赖定义为：

sqldelight-dialect = { module = "app.cash.sqldelight:sqlite-3-38-dialect", version.ref = "sqldelight" }
sqldelight-module-json = { module = "app.cash.sqldelight:sqlite-json-module", version.ref = "sqldelight" }

执行构建时会收到如下错误：

org.gradle.internal.typeconversion.UnsupportedNotationException: 
Cannot convert the provided notation to an object of type Dependency: map(valueof(DependencyValueSource)).

技术分析

根本原因

这个问题源于SQLDelight插件在处理Gradle版本目录(Versions Catalog)提供的依赖表示法时存在兼容性问题。插件内部无法正确处理通过版本目录传递的依赖映射(Map)结构。

临时解决方案

目前可行的临时解决方案是直接使用字符串形式指定完整的依赖坐标：

module("app.cash.sqldelight:sqlite-json-module:${libs.versions.sqldelight.get()}")

这种方式绕过了版本目录的依赖映射表示法，直接使用Gradle原生支持的字符串依赖表示法。

深层技术背景

Gradle 7.0引入的版本目录功能提供了一种集中管理依赖版本的新方式。它允许开发者通过类型安全的方式引用依赖，但在插件实现层面需要特别处理这种新的依赖表示法。

SQLDelight插件在2.x版本中对此支持不完善，导致无法正确解析通过版本目录传递的依赖映射。这属于插件与Gradle新特性的集成问题。

影响范围

此问题影响：

• SQLDelight 2.0.2及以上版本
• 使用Gradle版本目录功能配置模块依赖的场景
• 主要出现在Kotlin DSL构建脚本中

最佳实践建议

对于当前版本，建议开发者：

1. 对于模块依赖，暂时使用字符串表示法
2. 对于方言(dialect)依赖，版本目录方式仍然可用
3. 关注SQLDelight的更新日志，等待官方修复此兼容性问题

总结

SQLDelight作为优秀的SQL与Kotlin互操作工具，在2.x版本中引入了一些兼容性问题。开发者在使用新特性时需要留意此类边界情况。理解Gradle依赖表示法的不同形式及其转换规则，有助于快速定位和解决类似构建问题。