Maven版本号管理

背景

A，B项目依赖C项目，开发时候C项目使用快照版本，发布前修改为正式版本号，但是每次都需要ABC项目修改代码，有没有不修改代码的实现方式？

方案1: 打包时动态修改

可以使用 Maven 的 Profiles 和 Properties 来实现不修改代码的情况下，在开发时使用快照版本，发布前自动切换为正式版本。

方法 1：使用 Profiles

在 **pom.xml** 中定义 Profiles
你可以为开发和发布分别定义两个 Profiles。开发时使用快照版本，发布时使用正式版本。

<project><profiles><!-- 开发环境配置 --><profile><id>dev</id><properties><c.version>1.0.0-SNAPSHOT</c.version></properties></profile><!-- 发布环境配置 --><profile><id>release</id><properties><c.version>1.0.0</c.version></properties></profile></profiles><dependencies><dependency><groupId>com.example</groupId><artifactId>C</artifactId><version>${c.version}</version></dependency></dependencies>
</project>

使用不同的 Profile 构建
- 开发时使用 dev Profile：

mvn clean install -Pdev

- 发布时使用 `release` Profile：

mvn clean install -Prelease

方法 2：使用 Maven Properties

如果你不想使用 Profiles，还可以直接通过命令行参数来传递版本号：

在 **pom.xml** 中定义版本号属性

<properties><c.version>${c.version}</c.version>
</properties><dependencies><dependency><groupId>com.example</groupId><artifactId>C</artifactId><version>${c.version}</version></dependency>
</dependencies>

在构建时指定版本号
- 开发时：

mvn clean install -Dc.version=1.0.0-SNAPSHOT

- 发布时：

mvn clean install -Dc.version=1.0.0

通过这两种方式，你可以避免在每次开发和发布时手动修改代码，只需通过不同的构建参数或 Profile 来自动切换版本号。

方案2: Dependency Management

方法 1：使用父项目管理版本依赖

你可以创建一个父项目来管理所有子项目的版本依赖。这样，当项目 C 升级版本时，只需要在父项目中修改版本号，项目 A 和 B 就会自动继承。

**创建父项目的 ****pom.xml**
在父项目中定义项目 C 的版本号：

<project><modelVersion>4.0.0</modelVersion><groupId>com.example</groupId><artifactId>parent-project</artifactId><version>1.0.0-SNAPSHOT</version><packaging>pom</packaging><properties><c.version>1.0.0</c.version></properties><dependencyManagement><dependencies><dependency><groupId>com.example</groupId><artifactId>C</artifactId><version>${c.version}</version></dependency></dependencies></dependencyManagement>
</project>

在项目 A 和 B 中继承父项目
项目 A 和 B 的 pom.xml 继承父项目，并使用项目 C 的依赖而不指定版本号：

<project><modelVersion>4.0.0</modelVersion><parent><groupId>com.example</groupId><artifactId>parent-project</artifactId><version>1.0.0-SNAPSHOT</version></parent><artifactId>A</artifactId><dependencies><dependency><groupId>com.example</groupId><artifactId>C</artifactId></dependency></dependencies>
</project>

项目 B 的 pom.xml 类似。

升级项目 C 的版本号
当需要升级项目 C 的版本号时，只需在父项目的 pom.xml 中修改 c.version 属性，然后重新构建父项目，项目 A 和 B 会自动获取更新后的版本。

mavenplugin_145">方法 2：使用 Maven 的 `versions-maven-plugin`

你可以使用 versions-maven-plugin 来自动化版本更新流程。

**在项目 A 和 B 中配置 ****versions-maven-plugin** 在项目 A 和 B 的 pom.xml 中添加以下插件配置：

<build><plugins><plugin><groupId>org.codehaus.mojo</groupId><artifactId>versions-maven-plugin</artifactId><version>2.8.1</version></plugin></plugins>
</build>

自动更新项目 A 和 B 中的 C 版本号 当项目 C 发布新版本后，可以在项目 A 和 B 中运行以下命令来自动更新依赖的版本号：

mvn versions:use-latest-versions -Dincludes=com.example:C

这个命令会自动扫描项目 A 和 B 中的所有依赖，并将项目 C 的依赖版本更新为最新的发布版本。

确认更新后提交代码 确认 pom.xml 中的版本号更新正确后，提交更新后的代码。

方法 3：使用 Maven BOM（Bill of Materials）

Maven 的 BOM 是一个特殊的 pom.xml 文件，用于管理多个项目的依赖版本。通过使用 BOM 文件，可以将多个项目的依赖版本集中管理，从而避免在每个项目中手动维护依赖版本号。当项目 C 升级时，A 和 B 项目可以自动获取最新的依赖版本，而无需修改它们的 pom.xml。

1. 创建 BOM 项目

首先，创建一个专门用于管理依赖版本的 BOM 项目。在 BOM 项目的 pom.xml 中，定义项目 C 的版本号。

<project><modelVersion>4.0.0</modelVersion><groupId>com.example</groupId><artifactId>project-bom</artifactId><version>1.0.0-SNAPSHOT</version><packaging>pom</packaging><dependencyManagement><dependencies><dependency><groupId>com.example</groupId><artifactId>C</artifactId><version>1.0.0</version></dependency></dependencies></dependencyManagement>
</project>

在上面的配置中，project-bom 是 BOM 项目的 artifactId，C 是你要集中管理版本号的依赖（即项目 C）。version 字段指定了项目 C 的具体版本号。

2. 在项目 A 和 B 中导入 BOM

在项目 A 和 B 的 pom.xml 中，通过 dependencyManagement 的 import 机制导入 BOM 文件。这将使项目 A 和 B 自动继承 BOM 中定义的依赖版本号，而无需在每个项目中手动指定。

项目 A 的 pom.xml 示例：

<project><modelVersion>4.0.0</modelVersion><groupId>com.example</groupId><artifactId>A</artifactId><version>1.0.0</version><packaging>jar</packaging><dependencyManagement><dependencies><dependency><groupId>com.example</groupId><artifactId>project-bom</artifactId><version>1.0.0-SNAPSHOT</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement><dependencies><dependency><groupId>com.example</groupId><artifactId>C</artifactId></dependency></dependencies>
</project>

项目 B 的 pom.xml 配置类似。

3. 升级项目 C 的版本号

当项目 C 发布新版本时，只需要在 BOM 项目的 pom.xml 中更新项目 C 的版本号。例如，将项目 C 的版本号从 1.0.0 更新为 1.1.0：

<dependencyManagement><dependencies><dependency><groupId>com.example</groupId><artifactId>C</artifactId><version>1.1.0</version></dependency></dependencies>
</dependencyManagement>

之后，重新构建项目 A 和 B，它们会自动使用项目 C 的新版本 1.1.0，无需在 A 和 B 的 pom.xml 中进行任何修改。

优点

集中管理版本：所有项目的依赖版本都在一个 BOM 文件中统一管理，减少了版本号不一致的风险。
自动继承版本更新：通过更新 BOM 文件中的版本号，所有依赖 BOM 的项目都会自动继承最新的版本号。
减少手动修改：当依赖的项目（如 C）发布新版本时，只需更新 BOM 文件，而不需要修改每个依赖项目的 pom.xml。

这种方式在管理多个相互依赖的项目时非常有效，特别是当这些项目经常需要同步升级依赖版本时。

总结

Dependency Management的管理方式很好，代码层面解决不会遗漏，但是需要parent或者bom使用快照版本号
打包时动态修改，可以避免生产出现快照包场景，但是需要在打包时确认具体的版本号，或者容易遗漏，例如打包时忘记指定某个版本号，当业务依赖包多的时候，mvn命令会很长很容易出现遗漏或修改错误问题