1. 场景与目标
1.1 场景描述
多模块构建 场景下，常常需要在某些模块的打包阶段把同一个工程树中“兄弟项目”产出的 JAR 文件聚合进目标目录，以便后续的打包或部署流程统一处理。这种需求在微服务、插件化组件库以及持续交付流水线中尤为常见。
目标目录 通常是一个固定的输出路径，例如根项目下的 build/deploy/libs 或者外部的 ./output/libs，以确保后续的打包任务能稳定定位到需要的依赖 JAR。
1.2 需要自动复制的 JAR
兄弟项目 指同一个根项目下的其他子模块；JAR 指由这些模块的 Jar 任务产出的输出文件，需要在目标模块的打包阶段一起拷贝到指定目录。
产物的统一性 通过自动化拷贝来实现，避免手动配置每个依赖的路径，提升构建的可维护性与稳定性，尤其是在模块数量增多时更能体现优势。
2. 实现思路与架构
2.1 设计思路
中心思想 是在根项目的构建脚本中定义一个 Copy 任务，遍历同一 Gradle 构建树中的兄弟模块，筛选出具备 Guava、日志框架等常见依赖的子模块的 Jar 产物，并将它们复制到指定的目标目录。
执行阶段 使用 Copy 任务的 from 语法指向兄弟模块的 jar 产物任务，这样可以确保每次构建时产物都是最新的而非缓存文件。
2.2 目标实现的插件与能力
Java 插件 的 Jar 产物是最容易定位的来源，因此需要在兄弟模块和目标模块都应用 java 插件或 java-library 插件。
生命周期与依赖 通过为拷贝任务添加合适的依赖关系，可以确保在打包阶段前完成拷贝，从而避免找不到目标文件的问题。
2.3 架构与可维护性
模块解耦 通过在根项目集中管理拷贝逻辑，可以避免在每个子模块中重复实现同样的拷贝行为，提升可维护性。
扩展性 当新增子模块时，拷贝逻辑会自动识别并包含符合条件的 Jar 产物，减少人工干预。
3. Gradle 实践配置
3.1 根项目中实现 Copy 任务
核心任务 是在根项目的 build.gradle 中定义一个 Copy 任务，指定目标目录，并在来源处动态收集兄弟模块的 Jar 输出。
实现要点 是用 from(sp.tasks.jar) 将每个符合条件的子模块 Jar 任务的输出作为拷贝来源，并用 into(...) 指定目标目录。
// 根项目的 build.gradle（Groovy DSL）
plugins {id 'java'
}def targetDir = "$buildDir/combined-jars"task copySiblingJars(type: Copy) {description = 'Copy JARs from sibling projects into targetDir'into(targetDir)// 动态收集兄弟模块中的 Jar 输出from({subprojects.findAll { sp ->sp.name != project.name && sp.plugins.hasPlugin('java')}.collect { sp ->def jarTask = sp.tasks.findByName('jar')jarTask != null ? sp.tasks.jar : null}.findAll { it != null }})
}
3.2 确保 Jar 任务可用的时机
afterEvaluate 的使用可以确保在所有子模块完成配置后再建立拷贝来源，以避免在构建初期找不到 jar 任务的问题。
可靠性 = 在 afterEvaluate 里对子模块进行检查，若没有 java 插件或 jar 任务则跳过，这样即使存在非 Java 模块也不会导致构建失败。
// 继续在根项目的 build.gradle 中
subprojects { sp ->afterEvaluate {if (sp.plugins.hasPlugin('java')) {// 确保 jar 任务已经创建if (sp.tasks.findByName('jar') == null) {// 默认不处理，避免空指针}}}
}
3.3 将拷贝任务绑定到构建生命周期
阶段绑定 可以通过在 assemble、build 等生命周期任务之间建立依赖关系来确保拷贝在打包前完成。
稳定性 通过显式的任务依赖，可以避免某些环境下的并发执行导致的竞态条件。
4. 进阶技巧与容错
4.1 过滤条件与范围定义
选择性拷贝 可以通过在 from 语句中添加过滤条件，只拷贝特定子模块的 Jar，例如只拷贝名称以 core、util 结尾的模块产物，以减少无关文件的干扰。
灵活性 允许在 rootProject.ext 中暴露一个 includes 列表，以便在不同环境下灵活开启或关闭某些模块的拷贝行为。
4.2 处理不同输出名的 JAR
标准 Jar 的输出通常是 module.jar；自定义输出 例如 sourcesJar、javadocJar 可能需要排除或单独处理，避免污染目标目录。
策略 可以在收集来源时对 jar 任务进行条件判断，确保只有实际产物被拷贝。
4.3 Kotlin DSL 的实现方式
若使用 Kotlin DSL，可以使用类似的思路实现拷贝任务，只是语法有差异，保持目标一致即可。
代码示例 面向 Kotlin DSL 的实现，帮助团队在 Kotlin 项目中保持一致性。
// 根项目的 build.gradle.kts
plugins {java
}val targetDir = layout.buildDirectory.dir("combined-jars")tasks.register("copySiblingJars") {description = "Copy JARs from sibling projects into targetDir"into(targetDir)from(subprojects.filter { it.name != project.name && it.plugins.hasPlugin("java") }.mapNotNull { it.tasks.findByName("jar")?.let { it } })
}
