【Kotlin】Android 项目中从 KAPT 迁移到 KSP
一、KAPT 与 KSP 简介
| 特性 | KAPT (Kotlin Annotation Processing Tool) | KSP (Kotlin Symbol Processing) |
|---|---|---|
| 解析方式 | 生成 Java Stub 文件，再使用 Java APT | 直接解析 Kotlin 源码 |
| 编译速度 | 较慢（需要生成 stub） | 快 2 倍以上 |
| 支持语言 | Kotlin/Java 混合 | 原生 Kotlin |
| 维护状态 | 维护模式 | 官方推荐 |
| 兼容性 | 更好（老旧库） | 主流库已支持 |
二、 版本对照表（Kotlin 与 KSP）
| Kotlin 版本 | KSP 版本 |
|---|---|
| 2.0.21 | 2.0.21-1.0.27 |
| 2.0.20 | 2.0.20-1.0.25 |
| 2.0.10 | 2.0.10-1.0.24 |
| 2.0.0 | 2.0.0-1.0.22 |
| 1.9.24 | 1.9.24-1.0.20 |
| 1.9.23 | 1.9.23-1.0.19 |
三、常见库的 KSP 支持状态
| 库 | KSP 支持 | 说明 |
|---|---|---|
| Room | ✅ 支持 | 2.4.0+ 完全支持 |
| Hilt | ✅ 支持 | 2.40+ 支持 |
| Moshi | ✅ 支持 | 使用moshi-kotlin-codegen |
| Glide | ✅ 支持 | 4.14.0+ 支持 |
| Dagger | ✅ 支持 | 2.40+ 支持 |
| DataBinding | ⚠️ 部分 | 仍需 kapt（见下方） |
| Lombok | ❌ 不支持 | 仍需 kapt 或移除 |
四、迁移步骤
1、settings.gradle.kts 配置插件仓库
- 确保项目的 settings.gradle.kts 中包含 gradlePluginPortal() 和 Google 仓库。
pluginManagement{repositories{google