平台用于确保项目中的所有依赖项与一组一致的版本对齐。

平台帮助您管理和强制跨不同模块或库的版本一致性，尤其是在您使用需要保持同步的一组相关依赖项时。

使用平台

平台是一种专门的软件组件，用于控制传递依赖项版本。通常，它由 依赖项约束 组成，这些约束建议或强制特定版本。当您需要在多个项目之间共享一致的依赖项版本时，平台特别有用。

在典型的设置中，您有

  • 平台项目：它为跨不同子项目使用的依赖项定义约束。

  • 多个子项目：它们依赖于平台并声明依赖项，但不指定版本。

java-platform 插件 支持在 Java 生态系统中创建平台。平台通常也作为 Maven BOM（物料清单）发布，Gradle 原生支持 BOM。

要使用平台，请使用 platform 关键字声明依赖项

build.gradle.kts
dependencies {
    // get recommended versions from the platform project
    api(platform(project(":platform")))
    // no version required
    api("commons-httpclient:commons-httpclient")
}
build.gradle
dependencies {
    // get recommended versions from the platform project
    api platform(project(':platform'))
    // no version required
    api 'commons-httpclient:commons-httpclient'
}

此表示法自动执行多个操作

如果不需要 严格版本 强制执行，您可以使用 doNotEndorseStrictVersions 方法禁用它。

创建平台

在 Java 项目中，java-platform 插件与 依赖项约束 结合使用可以创建平台

plugins {
    id("java-platform")
}

dependencies {
    constraints {
        api("com.google.guava:guava:30.1-jre")
        api("org.apache.commons:commons-lang3:3.12.0")
    }
}

这定义了一个自定义平台，其中包含 guava 和 commons-lang3 的特定版本，可以在其他项目中应用。

导入平台

Gradle 支持导入 BOM，BOM 是包含管理依赖项版本的 <dependencyManagement> 部分的 POM 文件。

为了符合 BOM 的条件，.pom 文件需要设置 pom。这意味着 POM 文件应在其元数据中显式指定 <packaging>pom</packaging>。

Gradle 将 BOM 的 block 中的所有条目都视为类似于 添加依赖项约束。

常规平台

要导入 BOM，请使用 platform 依赖项修饰符方法在其上声明依赖项

build.gradle.kts
dependencies {
    // import a BOM
    implementation(platform("org.springframework.boot:spring-boot-dependencies:1.5.8.RELEASE"))
    // define dependencies without versions
    implementation("com.google.code.gson:gson")
    implementation("dom4j:dom4j")
}
build.gradle
dependencies {
    // import a BOM
    implementation platform('org.springframework.boot:spring-boot-dependencies:1.5.8.RELEASE')
    // define dependencies without versions
    implementation 'com.google.code.gson:gson'
    implementation 'dom4j:dom4j'
}

在此示例中，Spring Boot BOM 提供了 gson 和 dom4j 的版本，因此不需要显式版本。

强制平台

enforcedPlatform 关键字可用于覆盖依赖项图中找到的任何版本，但应谨慎使用，因为它实际上是传递性的，并将强制版本导出到项目的所有使用者

build.gradle.kts
dependencies {
    // import a BOM. The versions used in this file will override any other version found in the graph
    implementation(enforcedPlatform("org.springframework.boot:spring-boot-dependencies:1.5.8.RELEASE"))

    // define dependencies without versions
    implementation("com.google.code.gson:gson")
    implementation("dom4j:dom4j")

    // this version will be overridden by the one found in the BOM
    implementation("org.codehaus.groovy:groovy:1.8.6")
}
build.gradle
dependencies {
    // import a BOM. The versions used in this file will override any other version found in the graph
    implementation enforcedPlatform('org.springframework.boot:spring-boot-dependencies:1.5.8.RELEASE')

    // define dependencies without versions
    implementation 'com.google.code.gson:gson'
    implementation 'dom4j:dom4j'

    // this version will be overridden by the one found in the BOM
    implementation 'org.codehaus.groovy:groovy:1.8.6'
}

当使用 enforcedPlatform 时，如果您的软件组件旨在供其他人使用，请谨慎操作。此声明是传递性的，会影响使用者的依赖项图。如果他们不同意任何强制版本，则需要使用 exclude。相反，如果您的可重用组件强烈倾向于特定的第三方依赖项版本，请考虑使用带有 strictly 的 丰富版本 声明。