在实际开发过程中，特别是现在推崇的敏捷开发，项目版本的发布非常频繁，有可能是一周就一个版本。对于多模块构建的项目，如何在发布时统一升级项目版本，如果都由人来操作，很容易就漏改某个模块的版本，导致出现问题。
本文要介绍的就是使用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准备过程截图:

image.png

image.png

image.png

image.png

image.png

• 执行版本发布截图:

  
  
  image.png
  
  
  image.png

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

  
  
  image.png

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

  
  
  image.png

# 源代码

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