Существует пример проекта Spring Boot здесь, который содержит два модуля.
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'
объявлен в обоих модулях. Для проекта с двумя модулями это может не быть проблемой, но если бы в моем проекте было 10 модулей, и я хотел бы убедиться, что все модули всегда зависят от одной и той же версии Spring Boot, было бы неудобно и подвержено ошибкам повторять эту версию. в каждом модуле.
Точно так же я мог бы добавить зависимость от commons-io
к обоим этим модулям и убедиться, что они оба всегда зависят от одной и той же версии commons-io
.
Как избежать повторения номеров версий в каждом build.gradle
файле?
Вы можете переместить блок 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{}
определен в скрипте сборки каждого модуля. Вероятно, это не оптимально, и я рекомендую посмотреть другие репозитории, чтобы увидеть, как разные разработчики решали эту проблему.
См. эта документация Gradle: хорошей практикой в Gradle является настройка подпроектов, которые имеют общие черты, в одном месте, например, в скрипте сборки root project
(или с использованием пользовательских плагинов).
РЕДАКТИРОВАТЬ предложенное здесь решение больше не считается хорошей практикой команды Gradle (ссылка выше даже не упоминает блок subproject
в последней версии документа Gradle); спасибо @buggy за предупреждение.
В вашем примере, взятом из документации по загрузке 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да, ты прав, @buggy. я добавил примечание в ответ
Просто примечание о текущем состоянии: этот подход не рекомендуется gradle, см. docs.gradle.org/current/userguide/…