Maven-自动化版本发布

版本发布时所需要完成的工作,如检查是否有未提交代码、是否有快照依赖、更新快照版至发布版、执行Maven构建以及为源码打标签等完全可以手动的执行这些操作。事实上,如果对版本发布过程不是很熟悉,那么还是应该一步一步的操作一遍,以得到最直观的感受。

熟悉了版本发布流程之后,就会希望借助工具将这一流程自动化。Maven Release Plugin就提供了这样的功能,只要提供一些必要的信息,它就能帮助我们完成上述所有版本发布所涉及的操作。

Maven Release Plugin主要有三个目标,它们分别为:

release:prepare 准备版本发布,依次执行下列操作:

1)检查项目是否有未提交的代码

2)检查项目是否有快照版本依赖

3)根据用户输入将快照版升级为发布版

4)将POM中的SCM信息更新为标签地址

5)基于修改后的POM执行Maven构建

6)提交POM变更

7)基于用户输入为代码打标签

8)将代码从发布版升级为新的快照版

9)提交POM变更

release:rollback 回退release:prepare所执行的操作。将POM回退至release:prepare之前的状态,并提交。需要注意的是,该步骤不会删除release:prepare生成的标签,因此用户需要手动删除。

release:perform 执行版本发布。迁出release:prepare生成的标签中的源代码,并在此基础上执行mvn deploy命令打包并部署构件至仓库。

要为项目发布版本,首先需要为其添加正确的版本控制系统信息,这时因为MavenRelease Plugin需要知道版本控制系统的主干、标签等地址信息后才能执行相关的操作。一般配置项目的SCM信息如下:

上述代码中的connection元素表示一个只读的scm地址,而developerConnection元素表示可写的scm地址,url则表示可以在浏览器中访问的scm地址。为了能让Maven识别,connection和developerConnection必须以scm开头,冒号之后的部分表示版本控制工具类型(这里是svn),Maven还支持cvs、git等。接下来才是实际的scm地址,该例中connection使用了http协议,而developerConnection则由于涉及写操作,使用https协议进行了保护。

该配置只告诉Maven当前代码的位置(主干),而版本发布还要涉及标签操作。因此,还需要配置Maven Release Plugin告诉其标签的基础目录:

在执行release:prepare之前还有两个注意点:第一,系统必须要提供svn命令行工具,Maven需要svn命令行工具执行相关操作,而无法使用图形化的工具,如TortoiseSVN;第二,POM必须配置了可用的部署仓库,因为release:perform会执行deploy操作将构件发布到仓库中。

一切就绪后,在项目跟目录下运行如下命令:

mvn release:prepare

Maven Release Plugin开始准备发布版本,如果它检测到项目有未提交的代码,或者项目有快照版本的依赖,则会提示出错。如果一切都没有问题,则会提示用户输入想要发布的版本号、标签的名称以及新的快照版本号。

如果项目的artifactId为app,发布前的版本为1.0.0-SNAPSHOT,则maven Release Plugin会提示使用发布版本号1.0.0,使用标签名称app-1.0.0,新的开发版本1.0.1-SNAPSHOT。如果这些模式值正式你想要的,直接按Enter键即可,否则就输入想要的值再按Enter键。

基于这些信息,Maven Release Plugin会将版本1.0.0-SNAPSHOT更新为1.0.0,并更新SCM地址http://ip/app/trunk至http://ip/app/taps/app-1.0.0.在此基础上运行一次Maven构建以防止意外的错误出现,然后将这两个变化提交,并为该版本打上标签,标签地址是http://ip/app/tags/app-1.0.0。即tagBase路径加上标签名称。之后,Maven Release Plugin会将POM中的版本信息从1.0.0升级到1.1.0-SNAPSHOT并提交。

至此,release:prepare的工作完成。如果这时你发现了一些问题,例如将标签名称配置错了,则可以使用release:rollback命令回退发布,Maven Release Plugin会将POM的配置回退到release:prepare之前的状态。但需要注意的是,版本控制系统中标签并不会被删除,也就是说,用户需要手动执行版本控制系统命令删除该标签。

在多模块项目中执行release:prepare的时候,默认maven-release-plugin会提示用户设定每个模块版本号及新的开发版本号。在很多情况下,我们会希望所有模块的发布版本以及新的SNAPSHOT开发版本都保持一致。为了避免重复确认,maven-release-plugin提供了autoVersionSubmodules参数。例如,运行下面的命令后,maven-release-plugin就会自动为所有子模块使用与父模块一致的发布版本和新的SNAPSHOT版本:

$ mvn release:prepare -DautoVersionSubmodules=true

如果检查下来release:prepare的结果没有问题,标签和新的开发版本都是正确的,可以执行如下发布执行命令:

$ mvn release:perform

该命令将标签中的代码迁出,执行mvn deploy命令构建刚才准备的1.0.0版本,并部署到仓库中。至此,版本1.0.0正式发布完成。由于它已经被部署到了Maven仓库中,其他人可以方便的配置对它的依赖。

可以发现,如果发布项目的打包类型为jar,在执行release:perform之后,不仅项目的主构件会被生成并发布到仓库中,基于该构件的-sources.jar和-javadoc.jar也会生成并发布,这无疑是非常方便的,不仅能够下载主构件,还能够得到项目的源码和Javadoc。那么release:perform是怎样生成-sources.jar和-javadoc.jar的呢?所有Maven项目的POM都继承自超级POM,超级POM部分代码如下:

超级POM中定义了一个名为release-profile的Maven Profile,Profile是指一段在特定情况下激活并更改Maven行为的配置。这里看到activation元素下有一个名为performRelease、值为true的属性配置,这表示当Maven运行时,如果运行环境中有一个名为performRelease属性且值为true的时候,该profile就被激活。也就是说,该Profile下的配置会得到应用。那么,什么情况下Maven运行环境中会有名为performRelease、值为true的属性呢?可以在命令行指定:

$ mvn clean install -DperformRelease = true

在执行release:perform的时候,Maven Release Plugin会自动生成值为true的performRelease属性。这时,超级POM中的release-profile就会被激活。

这个Profile配置了3个Maven插件,maven-sources-plugin的jar目标会为项目生成-source.jar文件,maven-javadoc-plugin的jar目标会为项目生成-javadoc.jar文件,而maven-deploy-plugin的update-release-info配置则会在部署的时候更新仓库中的元数据,告诉仓库该版本是最新的发布版。每个插件配置中值为true的inherited元素则表示该插件配置可以被子POM继承。

出自《Maven实战》-许晓斌

猜你喜欢

转载自blog.csdn.net/tjsahwj/article/details/84585504
今日推荐