如何改写Gradle依赖语句，兼容IntelliJ IDEA自动导入且不改变构建逻辑？

问题分析 #

直接引用子项目的sourceSets.test.output作为依赖，Gradle构建逻辑可正常运行，但IntelliJ IDEA 2022.3的Gradle同步机制无法正确解析这种直接的内部输出引用，导致依赖导入失败。

解决方案 #

通过给子项目定义可消费的自定义配置，将测试源码集的输出暴露为标准依赖配置，既保留原有构建逻辑，又能让IDEA正确识别依赖。

步骤1：在各子项目中添加自定义配置

在:graphics、:base、:controls、:swing这些子项目的build.gradle（或build.gradle.kts）中，添加以下配置以暴露测试代码的输出：

// Groovy DSL
configurations {
    testOutput {
        // 标记该配置可被其他项目依赖消费
        canBeConsumed = true
        canBeResolved = false
        // 配置属性，让Gradle和IDEA识别该配置的类型
        attributes {
            attribute(Category.CATEGORY_ATTRIBUTE, objects.named(Category, Category.LIBRARY))
            attribute(Bundling.BUNDLING_ATTRIBUTE, objects.named(Bundling, Bundling.EXTERNAL))
            attribute(LibraryElements.LIBRARY_ELEMENTS_ATTRIBUTE, objects.named(LibraryElements, LibraryElements.CLASSES))
        }
        // 将测试源码集的输出作为该配置的构件
        outgoing.artifact(sourceSets.test.output)
    }
}

若使用Kotlin DSL，对应代码如下：

// Kotlin DSL
configurations.create("testOutput") {
    isCanBeConsumed = true
    isCanBeResolved = false
    attributes {
        attribute(Category.CATEGORY_ATTRIBUTE, objects.named(Category.LIBRARY))
        attribute(Bundling.BUNDLING_ATTRIBUTE, objects.named(Bundling.EXTERNAL))
        attribute(LibraryElements.LIBRARY_ELEMENTS_ATTRIBUTE, objects.named(LibraryElements.CLASSES))
    }
    outgoing.artifact(sourceSets.test.get().output)
}

步骤2：修改主项目的依赖声明

将主项目中原来的依赖语句，替换为依赖子项目的自定义testOutput配置：

// Groovy DSL
dependencies {
    testImplementation project(path: ":graphics", configuration: "testOutput")
    testImplementation project(path: ":base", configuration: "testOutput")
    testImplementation project(path: ":controls", configuration: "testOutput")
    testImplementation project(path: ":swing", configuration: "testOutput")
}

Kotlin DSL版本：

// Kotlin DSL
dependencies {
    testImplementation(project(mapOf("path" to ":graphics", "configuration" to "testOutput")))
    testImplementation(project(mapOf("path" to ":base", "configuration" to "testOutput")))
    testImplementation(project(mapOf("path" to ":controls", "configuration" to "testOutput")))
    testImplementation(project(mapOf("path" to ":swing", "configuration" to "testOutput")))
}

效果说明 #

• 原有构建逻辑完全保留：Gradle构建时依然会使用子项目测试源码集的编译输出，和之前直接引用sourceSets.test.output的效果一致。
• IDEA可正常导入依赖：通过标准的项目依赖配置方式，IDEA的Gradle同步机制能正确识别并加载这些测试依赖，解决导入失败的问题。

内容的提问来源于stack exchange，提问作者Thiago Sayão