Как избежать повторения версий зависимостей в многомодульном проекте Gradle?

Существует пример проекта 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 файле?

5
0
2 838
2
Перейти к ответу Данный вопрос помечен как решенный

Ответы 2

Вы можете переместить блок 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

Просто примечание о текущем состоянии: этот подход не рекомендуется gradle, см. docs.gradle.org/current/userguide/…

buggy 23.12.2021 10:51

да, ты прав, @buggy. я добавил примечание в ответ

M.Ricciuti 23.12.2021 15:49

Другие вопросы по теме