Android 之 Kotlin中的kapt
kapt（Kotlin Annotation Processing Tool） 是 Kotlin 生态中专用于处理注解的工具，其核心作用是将 Java 的注解处理器适配到 Kotlin 代码中，从而实现在 Kotlin 项目中使用依赖注入（如 Dagger Hilt）、ORM 框架（如 Room）等依赖注解处理的库。以下是其关键特性和工作原理的详细解析：
核心功能与工作原理
跨语言注解处理
- 问题背景：Java 生态的注解处理器（APT）无法直接解析 Kotlin 特有的语法（如扩展函数、伴生对象等）。
- 解决方案：kapt 在编译时生成 Java 存根（Stub）文件，将 Kotlin 代码转换为 Java 注解处理器能识别的形式，再调用原有处理器处理注解
。 - 示例场景：在 Kotlin 项目中使用 Dagger 时，通过 kapt 生成
DaggerComponent类。
集成方式
- Gradle 配置：
plugins {id("kotlin-kapt") // 应用 kapt 插件
}
dependencies {implementation("com.google.dagger:dagger:2.x")kapt("com.google.dagger:dagger-compiler:2.x") // 替换 annotationProcessor
}关键点：kapt 替代 Java 项目的 annotationProcessor 依赖，确保注解处理器能处理 Kotlin 代码
kapt 与其他工具对比
| 工具 | 适用语言 | 工作原理 | 性能 | 使用场景 |
|---|---|---|---|---|
| APT | Java | 直接调用 Java 注解处理器 | 高效（纯 Java 场景） | 纯 Java 项目 |
| kapt | Kotlin/混合 | 生成 Java 存根文件再调用处理器 | 较慢（存根生成开销） | Kotlin 项目（如 Android + Dagger） |
| KSP | Kotlin 优先 | 直接解析 Kotlin 符号（无存根） | 更快（编译提速 2 倍+） | 新项目或追求性能的 Kotlin 项目 |
- 性能瓶颈：kapt 因生成存根文件需额外编译步骤，显著拖慢构建速度（尤其大型项目）
。 - 演进替代：KSP（Kotlin Symbol Processing）通过直接读取编译器符号信息，避免了存根生成，成为 kapt 的优化替代方案
典型应用场景
依赖注入框架
- Dagger Hilt：通过 kapt 生成依赖注入组件代码。
dependencies {implementation("com.google.dagger:hilt-android:2.x")kapt("com.google.dagger:hilt-compiler:2.x")
}
2 .数据库框架（Room）
- 使用 kapt 生成
Dao实现类和Database结构：
dependencies {implementation("androidx.room:room-runtime:2.x")kapt("androidx.room:room-compiler:2.x")
}