在实际开发过程中，特别是现在推崇的敏捷开发，项目版本的发布非常频繁，有可能是一周就一个版本。对于多模块构建的项目，如何在发布时统一升级项目版本，如果都由人来操作，很容易就漏改某个模块的版本，导致出现问题。本文要介绍的就是使用Maven插件来统一管理这些模块的版本，规范化这一过程。

• 插件: maven-release-plugin

一、 环境与目标

1. 示例环境: 基于Maven构建的多模块项目

• 父项目坐标

    <groupId>com.futao</groupId><artifactId>starter-fustack</artifactId><version>0.0.1-SNAPSHOT</version><name>starter-fustack</name>

• 子模块列表:

    <modules><!--微信小程序--><module>fustack-wx-mini-program</module><!--自动配置--><module>fustack-autoconfiguration</module><!--常量--><module>fustack-consts</module><module>demo-test</module><!--数据库--><module>fustack-db</module><!--基础--><module>fustack-foundation</module><!--腾讯短信--><module>fustack-tencent-cloud-short-message</module><!--WEB支持--><module>fustack-web</module><!--权限控制--><module>fustack-auth</module><!--异常体系--><module>fustack-exceptions</module><!--Redis--><module>fustack-redis</module><!--工具包--><module>fustack-utils</module></modules>

2. 示例目标: 当前处于开发阶段，项目的版本为: 0.0.1-SNAPSHOT，即将需要发布该版本的正式版本: 0.0.1，且在正式版发布之后，下一个开发版本为: 0.0.2-SNAPSHOT。并同时将构建好的构件发布到maven私服。

二、 插件介绍

• 插件: maven-release-plugin

• 命令:

• • mvn release:prepare: 准备发布版本

1. 检查项目是否有未提交的代码，有的话会报错。

2. 检查项目是否有快照版本的依赖。

3. 提示用户输入将要发布的版本号，并且自动将项目中pom文件中的版本号更新为用户输入的版本号。

4. 提示用户输入一个tagName。

5. 基于修改后的pom执行构建。

6. 提交pom变更到VCS。

7. 提示用户输入下一个开发版的版本号，并且自动将项目中pom文件中的版本号更新为用户输入的版本号。

8. 提交pom变更到VCS。

• mvn release:rollback: 回滚prepare阶段的操作，将pom回退至之前的状态并提交，但是不会删除prepare生成的tag标签。

• mvn release:perform: 执行版本发布，执行mvn deploy命令打包并部署构件到远程仓库。

• 三、 演示过程

  1. 添加release插件支持

  <plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-release-plugin</artifactId><configuration><!--<tagBase>https://github.com/FutaoSmile/starter-fustack</tagBase>--><!--是否自动为子模块分配父版本。如果设置为false，将提示用户输入每个子模块的版本。--><autoVersionSubmodules>true</autoVersionSubmodules><!--tag标签名--><tagNameFormat>release-by-maven-${version}</tagNameFormat></configuration>
  </plugin>
  

  • 如果需要将构建好的构件发布到自己的maven私服，需要进行以下配置:

  • • 在~/.m2/settings.xml中添加maven私服的用户名和密码

    • 在项目的pom.xml文件中配置repository

  <distributionManagement><repository><id>对应settings中设置的id</id><url>需要上传到的maven私服地址</url></repository>
  </distributionManagement>
  

  2. 在pom.xml中设置SCM地址

  <scm><!--可读的SCM地址--><!--<connection>scm:git:https://github.com/FutaoSmile/starter-fustack</connection>--><!--可写的SCM地址--><developerConnection>scm:git:https://github.com/FutaoSmile/starter-fustack</developerConnection><!--可以在浏览器中访问的scm地址--><!--<url>https://github.com/FutaoSmile/starter-fustack</url>--><!--设置tagName--><tag>v-release-0.0.1</tag>
  </scm>
  

  3. 执行命令

  • mvn release:prepare

  • mvn relase:perform

  • prepare准备过程截图:

  

  • 执行版本发布截图:

  

  • 检查maven私服，构件是否上传成功

  

  • 代码已自动更新至下一个开发版

  

  # 源代码

  • https://gitee.com/FutaoSmile/starter-fustack

  • https://github.com/FutaoSmile/starter-fustack

  特别推荐一个分享架构+算法的优质内容，还没关注的小伙伴，可以长按关注一下：

  

  

  

  长按订阅更多精彩▼

  

  如有收获，点个在看，诚挚感谢