迁移至Version Catalogs后配置kotlin-kapt及注解处理器的问题

一、在Version Catalogs中配置kotlin-kapt插件 #

1. 打开项目根目录下的libs.versions.toml文件，在[plugins]区块添加kotlin-kapt的配置：

[plugins]
kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
kotlin-kapt = { id = "org.jetbrains.kotlin.kapt", version.ref = "kotlin" }
# 若使用Hilt，同时添加Hilt插件配置
hilt-android = { id = "com.google.dagger.hilt.android", version.ref = "hilt" }

（注：kotlin、hilt版本需在[versions]区块提前定义，比如kotlin = "1.9.0"、hilt = "2.45"）

2. 在模块级build.gradle（或build.gradle.kts）中引用插件：

plugins {
    alias(libs.plugins.kotlin.android)
    alias(libs.plugins.kotlin.kapt)
    alias(libs.plugins.hilt.android) // 使用Hilt则添加此行
}

二、在Version Catalogs中配置annotationProcessor与kapt依赖 #

1. 在libs.versions.toml的[libraries]区块定义处理器依赖：

[libraries]
room-compiler = { group = "androidx.room", name = "room-compiler", version.ref = "room" }
hilt-compiler = { group = "com.google.dagger", name = "hilt-compiler", version.ref = "hilt" }

（room版本需在[versions]区块定义，比如room = "2.5.2"）

2. 在模块级build.gradle中引入依赖：

dependencies {
    // Room处理器（兼容Kotlin+Java）
    kapt(libs.room.compiler)
    annotationProcessor(libs.room.compiler)
    
    // Hilt处理器
    kapt(libs.hilt.compiler)
}

三、解决处理器选项未识别警告 #

该警告是因为kotlin-kapt插件未正确生效，导致注解处理器无法读取配置参数，按以下步骤处理：

• 确认kotlin-kapt插件已正确引入并应用到目标模块
• 若使用Room，确保room.schemaLocation等参数已配置在android区块：

android {
    defaultConfig {
        javaCompileOptions {
            annotationProcessorOptions {
                arguments += mapOf(
                    "room.schemaLocation" to "$projectDir/schemas"
                )
            }
        }
    }
}

• 若使用Hilt，确保hilt-android插件和hilt-compiler依赖都已正确配置

四、解决MergeJavaRes文件路径冲突 #

针对重复的META-INF/gradle/incremental.annotation.processors文件，在模块级build.gradle的android区块添加打包配置排除重复文件：

android {
    packagingOptions {
        exclude 'META-INF/gradle/incremental.annotation.processors'
    }
}

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