如何在构建文件外部访问Gradle项目属性？

完全可以在主构建文件（比如build.gradle）外部引用sourceSets这类Gradle项目属性，常见的实现方式有以下几种，附示例代码：

1. 使用独立的Gradle脚本文件 #

将sourceSets的配置抽离到单独的脚本中，再在主构建文件中引入，适合复用配置。

外部脚本文件（sourceSets-config.gradle） #

// 配置sourceSets
sourceSets {
    main {
        java {
            srcDirs = ['src/main/java', 'src/custom/java']
        }
        resources {
            srcDirs = ['src/main/resources', 'src/custom/resources']
        }
    }
}

// 验证配置的任务
task printSourceSetPaths {
    doLast {
        println "Main Java源码目录: ${sourceSets.main.java.srcDirs}"
        println "Main资源目录: ${sourceSets.main.resources.srcDirs}"
    }
}

主构建文件（build.gradle）引入 #

// 引入外部配置脚本
apply from: 'sourceSets-config.gradle'

// 主文件中也可直接引用sourceSets属性
task confirmSourceSetInMain {
    doLast {
        println "主构建文件中访问到的sourceSet名称: ${sourceSets.main.name}"
    }
}

2. 使用Gradle初始化脚本（init.gradle） #

初始化脚本会在项目加载前执行，适合全局统一配置多个项目的sourceSets。

初始化脚本（init.gradle） #

allprojects {
    // 等待项目评估完成，确保Java插件已应用
    afterEvaluate { project ->
        if (project.plugins.hasPlugin('java')) {
            project.sourceSets {
                main {
                    java {
                        srcDirs += 'src/extra/java'
                    }
                }
            }

            project.task('printExtraSourceDirs') {
                doLast {
                    println "额外添加的Java源码目录: ${project.sourceSets.main.java.srcDirs}"
                }
            }
        }
    }
}

使用方式 #

执行Gradle命令时指定初始化脚本：

./gradlew printExtraSourceDirs --init-script init.gradle

3. 自定义Gradle插件 #

通过插件封装sourceSets的配置逻辑，适合复杂场景或跨项目复用。

插件实现（放在buildSrc/src/main/groovy/com/example/plugins/SourceSetsPlugin.groovy） #

package com.example.plugins

import org.gradle.api.Plugin
import org.gradle.api.Project
import org.gradle.api.tasks.SourceSet

class SourceSetsPlugin implements Plugin<Project> {
    void apply(Project project) {
        // 先应用Java插件
        project.plugins.apply('java')

        // 获取并配置main sourceSet
        def mainSourceSet = project.sourceSets.getByName(SourceSet.MAIN_SOURCE_SET_NAME)
        mainSourceSet.java.srcDirs += project.file('src/plugin/java')
        mainSourceSet.resources.srcDirs += project.file('src/plugin/resources')

        // 添加验证任务
        project.task('printPluginConfiguredSources') {
            doLast {
                println "插件配置的Java源码目录: ${mainSourceSet.java.srcDirs}"
            }
        }
    }
}

插件配置文件（buildSrc/src/main/resources/META-INF/gradle-plugins/com.example.plugins.source-sets.properties） #

implementation-class=com.example.plugins.SourceSetsPlugin

主构建文件中应用插件 #

plugins {
    id 'java'
    id 'com.example.plugins.source-sets'
}

这些方式的核心是Gradle的项目模型是全局可访问的，只要确保在项目上下文（比如通过afterEvaluate等待插件加载完成）中操作，就能正常引用sourceSets这类扩展属性。

内容的提问来源于stack exchange，提问作者A. J. Green