Eclipse(2023-12)+Buildship：导入项目库测试构件时类路径错误

问题背景 #

我有两个Gradle项目：

• Lib2：包含业务代码和测试工具类，这些测试工具类需要提供给其他项目用于测试
• Lib3：业务代码依赖Lib2，且其测试代码需要使用Lib2的测试工具类（无论Lib3是库还是应用类型项目都会出问题）

导入/刷新Lib3项目时，Eclipse生成的类路径存在错误：Lib2仅对测试源可见，但不包含测试代码。这导致主代码和测试代码中的所有导入都失败，完全无法满足需求。

相关配置 #

Lib2的build.gradle #

apply plugin: 'java'
apply plugin: 'java-library'
apply plugin: 'eclipse'

//Test Utils Part
sourceSets {
  testUtils {
    compileClasspath += sourceSets.main.output
    runtimeClasspath += sourceSets.main.output
  }
  test {
    compileClasspath += sourceSets.testUtils.output
    runtimeClasspath += sourceSets.testUtils.output
  }
}

/*
 * To compile testUtils sourceSet we need to exends the configuration for the 'main' sourceSet.
 * And, since we define dependencies only for testUtils, test must have to extends from it.
 */
configurations {
    testUtilsImplementation.extendsFrom implementation
    testUtilsRuntime.extendsFrom runtime
    testCompile.extendsFrom testUtilsImplementation
    testImplementation.extendsFrom testUtilsImplementation
}

configurations {
    testUtilsArtifacts.extendsFrom testUtilsImplementation
}

task testUtilsJar(type: Jar) {
    archiveClassifier.set("test")
    from sourceSets.testUtils.output
}

artifacts {
    testUtilsArtifacts testUtilsJar
}

// End test utils part

Lib3的build.gradle #

apply plugin: 'java'
apply plugin: 'java-library'
apply plugin: 'eclipse'

repositories {
     mavenCentral()
}

dependencies {
      /*Leo*/
    api project(":Lib2")
    testImplementation project(path: ":Lib2", configuration: 'testUtilsArtifacts')    
 }

settings.gradle #

include (":Lib2")
project(":Lib2").projectDir = file("../Lib2")

这是基础配置，但无法正常工作，我认为需要调整Eclipse插件的相关设置，但不知从何入手。

解决方案 #

问题根源在于Gradle Eclipse插件默认不会处理自定义的testUtilsArtifacts配置，也无法自动识别自定义的testUtils源码集，需要手动调整类路径生成规则。

1. 修改Lib2的Eclipse插件配置 #

在Lib2的build.gradle末尾添加以下代码，让Eclipse识别testUtils源码集并正确关联测试工具类的发布配置：

eclipse {
    sourceSets {
        testUtils {
            eclipse.sourceDirs = [sourceSets.testUtils.java.srcDirs, sourceSets.testUtils.resources.srcDirs]
            eclipse.outputDir = sourceSets.testUtils.output.classesDirs.singleFile
        }
    }
    classpath {
        plusConfigurations += configurations.testUtilsArtifacts
    }
}

2. 修改Lib3的Eclipse插件配置 #

在Lib3的build.gradle末尾添加以下代码，强制插件将Lib2的主代码和测试工具类分别放到正确的类路径层级：

eclipse {
    classpath {
        file {
            whenMerged { cp ->
                cp.entries.each { entry ->
                    if (entry instanceof org.gradle.plugins.ide.eclipse.model.ProjectDependency && entry.path == "/Lib2") {
                        entry.entryAttributes['gradle_scope'] = 'compile'
                        entry.entryAttributes['test'] = 'false'
                    }
                }
            }
        }
        plusConfigurations += configurations.testImplementation
    }
}

3. 刷新项目 #

完成配置修改后，在Eclipse中对两个项目执行：右键 → Gradle → Refresh Gradle Project，等待同步完成后检查类路径错误是否消失。

关键说明 #

• Gradle Eclipse插件仅默认处理main、test标准源码集，自定义源码集需手动配置才能被Eclipse识别
• 通过plusConfigurations将自定义配置加入类路径，确保测试工具类Jar被正确引入
• 修改ProjectDependency的属性，避免Lib2主代码被错误标记为仅测试可见

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