您可以在支持Gradle的IDE中打开此示例。

定义和使用复合构建

本示例展示了两个通常单独开发并通过二进制集成组合的 Gradle 构建如何通过源集成连接成一个复合构建。my-utils 多项目构建生成两个不同的 Java 库,而 my-app 构建使用这些库中的函数生成一个可执行文件。

请注意,my-app 构建不直接依赖于 my-utils。相反,它声明了对 my-utils 生成的库的模块依赖。

my-app/app/build.gradle.kts
plugins {
    id("application")
}

application {
    mainClass = "org.sample.myapp.Main"
}

dependencies {
    implementation("org.sample:number-utils:1.0")
    implementation("org.sample:string-utils:1.0")
}
my-app/app/build.gradle
plugins {
    id 'application'
}

application {
    mainClass = 'org.sample.myapp.Main'
}

dependencies {
    implementation 'org.sample:number-utils:1.0'
    implementation 'org.sample:string-utils:1.0'
}

使用命令行复合构建

使用复合构建时,构建之间不需要共享仓库,也不需要更改构建脚本。

  1. 更改 Number.java 的源文件

  2. 运行 my-app 应用程序,包括 my-utils 构建。

cd my-app
gradle --include-build ../my-utils run

使用 _依赖项替换_,对 util 库的模块依赖被替换为对 my-utils 的项目依赖。

my-app 转换为复合构建

通过将 my-app 转换为包含 my-utils 的复合构建,可以使上述安排持久化。

cd my-app
echo "includeBuild '../my-utils'" >> settings.gradle
gradle run

通过此配置,从 my-appmy-utils 的模块依赖将始终被项目依赖替换。

虽然简单,但这种方法修改了 my-app 构建,这是其缺点。

使用单独的复合构建

也可以创建一个单独的复合构建,其中包含 my-appmy-utils 构建。

settings.gradle.kts
rootProject.name = "my-composite"

includeBuild("my-app")
includeBuild("my-utils")
settings.gradle
rootProject.name = 'my-composite'

includeBuild 'my-app'
includeBuild 'my-utils'

完成此操作后,您可以在命令行上直接引用包含的构建中的任何任务以执行它们。

gradle :my-app:app:run

或者,您可以在复合项目中创建委托任务以执行任务,而无需指定完整的任务路径。

build.gradle.kts
tasks.register("run") {
    dependsOn(gradle.includedBuild("my-app").task(":app:run"))
}
build.gradle
tasks.register('run') {
    dependsOn gradle.includedBuild('my-app').task(':app:run')
}
gradle run