有一个示例Spring Boot项目here,其中包含两个模块。
其中一个模块的build.gradle
如下所示:
buildscript {
ext { springBootVersion = '2.1.4.RELEASE' }
repositories { mavenCentral() }
dependencies { classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}") }
}
plugins {
id "io.spring.dependency-management" version "1.0.5.RELEASE"
}
apply plugin: 'java'
apply plugin: 'eclipse'
apply plugin: 'org.springframework.boot'
apply plugin: 'io.spring.dependency-management'
bootJar {
baseName = 'gs-multi-module-application'
version = '0.0.1-SNAPSHOT'
}
sourceCompatibility = 1.8
repositories { mavenCentral() }
dependencies {
compile('org.springframework.boot:spring-boot-starter-actuator')
compile('org.springframework.boot:spring-boot-starter-web')
compile project(':library')
testCompile('org.springframework.boot:spring-boot-starter-test')
}
另一个模块的build.gradle
如下所示:
buildscript {
repositories { mavenCentral() }
}
plugins { id "io.spring.dependency-management" version "1.0.5.RELEASE" }
ext { springBootVersion = '2.1.4.RELEASE' }
apply plugin: 'java'
apply plugin: 'eclipse'
jar {
baseName = 'gs-multi-module-library'
version = '0.0.1-SNAPSHOT'
}
sourceCompatibility = 1.8
repositories { mavenCentral() }
dependencies {
compile('org.springframework.boot:spring-boot-starter')
testCompile('org.springframework.boot:spring-boot-starter-test')
}
dependencyManagement {
imports { mavenBom("org.springframework.boot:spring-boot-dependencies:${springBootVersion}") }
}
在两个模块中都声明了springBootVersion = '2.1.4.RELEASE'
。对于一个2个模块的项目来说可能不是问题,但是如果我的项目有10个模块,并且我想确保所有模块始终依赖于同一版本的Spring Boot,那么重复此版本将很不方便且容易出错在每个模块中。
类似地,我可能想向这两个模块添加对commons-io
的依赖,并确保它们始终都依赖于commons-io
的相同版本。
如何避免在每个build.gradle
文件中重复版本号?
答案 0 :(得分:1)
您可以将ext{}
块移动到新文件,并通过build.gradle
语句在项目的apply from:
文件中对其进行引用。
// project/versions.gradle
ext {
springBootVersion = '2.1.4.RELEASE'
}
// project/build.gradle
buildscript {
apply from: 'versions.gradle'
}
// module/build.gradle
dependencies {
implementation "some.dependency:dependency:$springBootVersion"
}
现在,您只需要在一个位置定义依赖项版本即可。
通常,一个项目除了特定于模块的build.gradle
文件外,还将具有一个项目级别的build.gradle
文件。但是,您共享的存储库缺少项目级别的构建脚本。这就是在每个模块的构建脚本中定义ext{}
块的原因。这可能不是最佳选择,我建议您查看其他存储库,以了解不同的开发人员如何解决此问题。
答案 1 :(得分:1)
参见this Gradle documentation:Gradle中的一个好习惯是在单个位置配置共享共同特征的子项目,例如在root project
的构建脚本中(或使用自定义插件)
在您从Spring引导文档中获取的示例中,此模式可以应用于将Spring引导和其他常见依赖项版本集中在一个地方,但是您可以走得更远,还可以配置其他常见特征(Java插件配置,存储库等) ..)
这是我将重写Spring示例以使其更整洁和干燥的方法:
根项目
/**
* Add Springboot plugin into build script classpath (without applying it)
* This is this only place where you need to define the Springboot version.
*
* See https://docs.spring.io/spring-boot/docs/current/gradle-plugin/reference/html/#managing-dependencies-using-in-isolation
*/
plugins {
id "org.springframework.boot" version "2.1.4.RELEASE" apply false
}
// Set version for dependencies share between subprojects
ext {
commonsIoVersion = "2.6"
}
subprojects {
// common config for all Java subprojects
apply plugin: "java"
apply plugin: "eclipse"
sourceCompatibility = 1.8
repositories {
mavenCentral()
}
// apply Spring Boot's dependency management plugin
apply plugin: "io.spring.dependency-management"
}
图书馆子项目
// no need for additional plugins
jar {
baseName = 'gs-multi-module-library'
version = '0.0.1-SNAPSHOT'
}
dependencies {
implementation('org.springframework.boot:spring-boot-starter')
implementation "commons-io:commons-io:${commonsIoVersion}"
testCompile('org.springframework.boot:spring-boot-starter-test')
}
dependencyManagement {
imports {
mavenBom org.springframework.boot.gradle.plugin.SpringBootPlugin.BOM_COORDINATES
}
}
应用子项目
plugins {
id "org.springframework.boot"
}
bootJar {
baseName = 'gs-multi-module-application'
version = '0.0.1-SNAPSHOT'
}
dependencies {
implementation project(':library')
implementation ('org.springframework.boot:spring-boot-starter-actuator')
implementation ('org.springframework.boot:spring-boot-starter-web')
implementation "commons-io:commons-io:${commonsIoVersion}"
// could also be configured in root project.
testCompile('org.springframework.boot:spring-boot-starter-test')
}
注释
plugins {}
DSL(不需要旧的buildscript
块)io.spring.dependency-management
的版本不应显式配置,它将从Spring启动插件继承