Gradle之apt, annotationProcessor和kapt

最新推荐文章于 2026-03-28 03:24:57 发布

原创最新推荐文章于 2026-03-28 03:24:57 发布 · 1.1w 阅读

13 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#gradle #apt #kapt #annotation处理器

gradle 专栏收录该内容

3 篇文章

订阅专栏

本文详细介绍了APT(Annotation Processing Tool)在Java与Kotlin中的不同配置及使用方式，包括APT、annotationProcessor和kapt的区别，以及在实际项目中使用阿里路由框架ARouter时遇到的配置问题。

1. APT

APT(Annotation Processing Tool)，即注解处理工具，在代码编译期对源代码进行扫描，找出代码中的注解，根据开发者定义的解析规则生成新的Java文件，新生成的Java文件最终也会生成class文件。APT处理流程如下：
在这里插入图片描述

2. annotationProcessor

annotationProcessor在Android Gradle 2.2之后由Google引入的，是Gradle中内置的APT工具，同时支持 javac 和 jack 编译方式。使用方式（即Java语言下的使用方式）如下：

dependencies {
    annotationProcessor "com.alibaba:arouter-compiler:1.2.2"
}

3. kapt

Kotlin中不使用annotationProcessor，而是使用kapt，其使用方式为：

apply plugin: 'kotlin-kapt'
dependencies {
    kapt "com.alibaba:arouter-compiler:1.2.2"
}

此外在Java和Kotlin两种语言下APT的配置命令也不一样：
Java下：

android {
    defaultConfig {
        javaCompileOptions {
            annotationProcessorOptions {
                arguments = [AROUTER_MODULE_NAME: project.getName()]
            }
        }
    }
}

Kotlin下：

apply plugin: 'kotlin-kapt'

kapt {
    arguments {
        arg("AROUTER_MODULE_NAME", project.getName())
    }
}

4. 踩过的坑

之前用阿里的路由框架ARouter时，项目采用Kotlin，未注意到Java和Kotlin语言下APT配置的不同，导致编译时无法扫描到注解，在项目运行时始终提示：

There is no route match the path [/xxx/xxx], in group [xxx][ ]

Github博客地址
 知乎