您可以在支持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'
}
使用命令行复合构建
使用复合构建时,构建之间不需要共享仓库,也不需要更改构建脚本。
-
更改
Number.java
的源文件 -
运行
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-app
到 my-utils
的模块依赖将始终被项目依赖替换。
虽然简单,但这种方法修改了 my-app
构建,这是其缺点。
使用单独的复合构建
也可以创建一个单独的复合构建,其中包含 my-app
和 my-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