如何解决SQLDelight提示的IDE与Gradle版本不兼容错误？

1. 核心问题定位 #

报错The IDE and Gradle versions of SQLDelight are incompatible的本质是Android Studio中安装的SQLDelight IDE插件版本与项目中配置的SQLDelight Gradle插件版本不一致，必须保证两者版本完全相同。

2. 解决升级SQLDelight 2.0.0时找不到插件的问题 #

SQLDelight从2.0.0开始更换了groupId，你之前的配置没更新groupId导致找不到依赖：

• 打开项目根目录的build.gradle（或build.gradle.kts），修改classpath配置：

  // 旧配置（1.x版本）
  classpath "com.squareup.sqldelight:gradle-plugin:1.5.5"
  // 替换为新配置（2.x版本）
  classpath "app.cash.sqldelight:gradle-plugin:2.0.0"
  

• 打开app/build.gradle，修改依赖配置：

  // 旧配置（1.x版本）
  implementation "com.squareup.sqldelight:android-driver:1.5.5"
  // 替换为新配置（2.x版本）
  implementation "app.cash.sqldelight:android-driver:2.0.0"
  

• 同步Gradle，即可解决找不到2.0.0插件的问题。

3. 确保IDE插件与Gradle版本一致 #

• 打开Android Studio的Settings > Plugins，找到SQLDelight插件，查看当前安装的版本号。
• 确保项目中配置的SQLDelight Gradle插件版本和IDE插件版本完全相同：
  • 如果IDE插件是2.x版本，就用上面的2.x配置；
  • 如果不想升级，就把IDE插件降级到1.5.5版本，同时保持项目中Gradle插件版本为1.5.5。

4. 清理缓存修复残留问题 #

如果上述操作后仍报错，执行以下步骤：

• 点击File > Invalidate Caches... > Invalidate and Restart，重启Android Studio；
• 删除项目根目录的.gradle文件夹和app/build文件夹；
• 重新同步项目。

补充说明 #

你的Android Studio Giraffe（2022.3.1）兼容SQLDelight 2.x版本，无需降级Gradle或AGP，只要保证SQLDelight的IDE插件和Gradle插件版本一致即可。

内容的提问来源于stack exchange，提问作者Malte Ge