使用独立配置的Gradle项目该如何正确声明依赖？

核心实现思路 #

通过Gradle自定义配置和构件声明能力，将配置模块的资源/产物暴露为可被其他模块依赖的构件，完全符合Gradle依赖管理规范，无需硬编码路径，构建缓存可正常生效。

步骤1：配置存储配置的模块的build.gradle #

// 声明自定义配置，专门用来对外暴露部署配置
configurations {
    deployConfig {
        canBeConsumed = true
        canBeResolved = false
    }
}

// 保留你原有的打包zip的逻辑，示例如下：
task packageDeployConfig(type: Zip) {
    // 替换为你实际存放配置文件的目录
    from "src/main/deploy-config"
    archiveClassifier.set("deploy")
}

// 将zip产物注册为自定义配置的构件
artifacts {
    deployConfig packageDeployConfig
}

如果不需要传递zip包，想直接暴露原始配置目录，可将artifacts部分替换为：

artifacts {
    // 替换为你实际存放配置文件的目录
    deployConfig file("src/main/deploy-config")
}

步骤2：配置依赖配置模块的业务模块的build.gradle #

// 声明用于接收配置模块产物的自定义配置
configurations {
    deployConfig {
        canBeConsumed = false
        canBeResolved = true
    }
}

dependencies {
    // 替换为你的配置模块的项目路径
    deployConfig project(path: ":config-module", configuration: "deployConfig")
}

// 如果配置模块对外暴露的是zip包，添加解压任务
task importDeployConfig(type: Copy) {
    from zipTree(configurations.deployConfig.singleFile)
    // 替换为你需要把配置放到的目标路径，比如构建产物的资源目录
    into "${buildDir}/resources/main/deploy-config"
}

// 如果配置模块对外暴露的是原始目录，导入任务改为：
// task importDeployConfig(type: Copy) {
//     from configurations.deployConfig
//     into "${buildDir}/resources/main/deploy-config"
// }

// 将导入任务绑定到构建流程，确保构建时自动拉取配置
processResources.dependsOn importDeployConfig

// 如果需要配置文件进入运行时classpath，添加如下依赖：
implementation files(importDeployConfig.destinationDir)

原fileTree方案不生效的常见原因 #

你之前使用的compile fileTree方案不生效，通常是因为没有将对应目录的文件绑定到processResources等构建阶段的任务中，文件不会被自动复制到构建产物目录，自然不会参与后续构建流程。

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