本教程旨在指导开发者如何使用 Gradle 构建脚本，将一个兄弟项目（项目 B）编译生成的 JAR 文件，自动复制到另一个项目（项目 A）的指定目录下。通过自定义 Gradle 任务，实现在项目 A 构建过程中，自动完成项目 B 的编译和 JAR 文件复制，无需手动操作，提高开发效率。
在实际开发中，有时我们需要将一个项目的构建产物（例如 JAR 文件）复制到另一个项目中，但又不想建立直接的依赖关系。这种情况常见于一些测试场景，或者需要将一些独立的模块集成到主项目中。本文将介绍如何使用 Gradle 实现这一需求，即在项目 A 的构建过程中，自动编译项目 B，并将项目 B 生成的 JAR 文件复制到项目 A 的指定目录下。
实现步骤
-
定义复制 JAR 文件的任务（copyB）
该任务负责将项目 B 编译生成的 JAR 文件复制到项目 A 的指定目录。
task copyB(type: Copy) { from './B/build/libs/B.jar' // 项目 B 的 JAR 文件路径 into '.' // 项目 A 的目标目录 } tasks.named("copyB") { finalizedBy("buildBJar") }- from: 指定要复制的文件来源，这里指向项目 B 的构建输出目录下的 JAR 文件。
- into: 指定复制的目标目录，这里 '.' 表示项目 A 的根目录，可以根据实际需求修改。
- finalizedBy("buildBJar"): 确保 buildBJar 任务在 copyB 任务之前执行。
-
定义编译项目 B 的任务（buildBJar）
该任务负责编译项目 B，生成 JAR 文件。
task buildBJar(type: Exec) { workingDir '.\\B' // 项目 B 的根目录 commandLine("cmd", "/c", "gradle", "build") // 执行 Gradle 构建命令 doLast { println "B has been built and now JAR will be copied" } } } tasks.named("build") { finalizedBy("copyB") }- workingDir: 指定执行 Gradle 命令的工作目录，这里指向项目 B 的根目录。
- commandLine: 指定要执行的命令行命令，这里使用 gradle build 命令编译项目 B。
- doLast: 在任务执行完成后执行的操作，这里打印一条消息。
- finalizedBy("copyB"): 确保 copyB 任务在 build 任务之后执行。
-
将 copyB 任务添加到项目 A 的构建流程中
为了在项目 A 构建时自动执行上述两个任务，需要将 copyB 任务添加到项目 A 的构建流程中。可以使用 finalizedBy 属性来实现。
tasks.named("build") { finalizedBy("copyB") }这条语句表示在项目 A 的 build 任务完成后，执行 copyB 任务。
完整示例
将以上代码片段添加到项目 A 的 build.gradle 文件中，完整的 build.gradle 文件如下所示：
plugins {
id 'java'
}
group 'org.example'
version '1.0-SNAPSHOT'
repositories {
mavenCentral()
}
dependencies {
testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.1'
testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.1'
}
test {
useJUnitPlatform()
}
task copyB(type: Copy) {
from './B/build/libs/B.jar'
into '.'
}
tasks.named("copyB") { finalizedBy("buildBJar") }
task buildBJar(type: Exec) {
workingDir '.\\B'
commandLine("cmd", "/c", "gradle", "build")
doLast {
println "B has been built and now JAR will be copied"
}
}
}
tasks.named("build") { finalizedBy("copyB") }注意事项
-
确保项目 A 和项目 B 位于同一父目录下，并且目录结构正确，例如：
parent_directory/ ├── project_A/ │ └── build.gradle │ └── ... └── project_B/ └── build.gradle └── ... 根据实际情况修改 from 和 into 属性，确保指向正确的 JAR 文件路径和目标目录。
commandLine 中的命令需要根据操作系统进行调整。在 Windows 系统中，可以使用 cmd /c gradle build 命令；在 Linux 或 macOS 系统中，可以使用 ./gradlew build 命令。
如果项目 B 的构建过程比较复杂，可以考虑使用 Gradle 的 dependsOn 属性来显式地声明任务之间的依赖关系。
总结
通过自定义 Gradle 任务，我们可以方便地将兄弟项目的构建产物复制到指定目录，从而实现更灵活的构建流程。本文提供了一种简单的实现方式，可以根据实际需求进行扩展和修改。 这种方法适用于需要在不同项目之间共享构建产物，但又不想建立直接依赖关系的场景。
