开发Kotlin注解处理器库遇报错：需显式声明注解处理器

嘿，我之前开发Kotlin注解处理器库的时候也踩过这个坑，这就给你捋清楚解决方案！

这个错误是Android Gradle插件（AGP）3.0及以上版本的新要求——所有注解处理器必须显式声明，不能再通过隐式依赖让Gradle自动识别了。你的:compiler模块就是那个包含注解处理器的依赖，所以得按下面的方式配置：

方案一：显式声明注解处理器（推荐） #

这是官方推荐的做法，能让Gradle更高效地处理编译流程，也避免潜在的依赖冲突。

1. 配置App模块的依赖 #

根据你用的是Groovy还是Kotlin DSL，修改app模块的build.gradle/build.gradle.kts：

• Groovy版本：

plugins {
    id 'com.android.application'
    id 'kotlin-android'
    id 'kotlin-kapt' // 如果你用Kotlin写注解处理器，必须加这个插件
}

dependencies {
    // 先添加注解模块的依赖（如果你的注解和处理器是分开的模块）
    implementation project(':annotations')
    // 显式声明注解处理器依赖
    kapt project(':compiler') // Kotlin项目用kapt，Java项目用annotationProcessor
}

• Kotlin DSL版本：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("org.jetbrains.kotlin.kapt")
}

dependencies {
    implementation(project(":annotations"))
    kapt(project(":compiler")) // Java项目替换为annotationProcessor(project(":compiler"))
}

2. 确保Compiler模块正确配置 #

在:compiler模块的build文件里，要添加注解处理器API的依赖，并且用@AutoService标记你的Processor类，这样Gradle才能识别它是注解处理器：

// Groovy示例
dependencies {
    implementation 'com.google.auto.service:auto-service:1.0.1'
    kapt 'com.google.auto.service:auto-service:1.0.1' // Kotlin用kapt，Java用annotationProcessor
}

然后在你的Processor类上添加注解：

@AutoService(Processor::class)
class YourAnnotationProcessor : AbstractProcessor() {
    // 你的处理器逻辑
}

方案二：关闭显式声明检查（不推荐） #

如果你只是临时测试，不想改太多配置，可以通过关闭includeCompileClasspath来绕过检查，但这个方式不符合官方规范，后续AGP版本可能会移除这个选项：

• Groovy版本：

android {
    defaultConfig {
        javaCompileOptions {
            annotationProcessorOptions {
                includeCompileClasspath = true
            }
        }
    }
}

• Kotlin DSL版本：

android {
    defaultConfig {
        javaCompileOptions {
            annotationProcessorOptions {
                isIncludeCompileClasspath = true
            }
        }
    }
}

建议优先用方案一，既能保证兼容性，也能让项目结构更清晰。

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