Maven 学习总结 (六) 之 版本
版本管理
版本管理是指项目整体版本的演变过程管理。版本控制是指借助版本控制工具(如Subversion)追踪代码的每一个变更。
为了方便团队合作,项目开发过程中,大家应该使用快照版本,快照版本机制促进团队内部的交流,但是当项目需要对外发布时,我们显然需要提供非常稳定的版本,
使用该版本应当永远只能定位到唯一的构件,而不是像快照版本那样,定位的构件随时可能发生变化。我们称这类稳定的版本为发布版。项目发布了一个版本之后,就
进入下一个开发阶段,项目也就自然转到新的快照版本中。
版本管理关心的问题之一就是这种快照版和发布版之间的转换。项目经过了一段时间的 x.0-SNAPSHOT开发之后,在某个时刻发布了x.0正式版,
然后项目进入了x.1-SNAPSHOT的开发。
理想的发布版本应当对应了项目某个时刻比较稳定的状态,这包括源代码的状态以及构建状态,因此这个时候项目的构建应当满足以下的条件:
- 自动化测试应当全部通过
- 项目没有配置任何快照版本的依赖
- 项目没有配置任何快照版本的插件
- 项目所包含的代码已经全部提交到版本控制体系中
版本控制系统记录了代码的每个变化,通常这些变化都被维护在主干(Trunk)中,当项目发布的时候,开发人员应该使用标签记录这一特殊时刻的状态,
这样可以明确将某个源码版本从主干中标记出来,放到单独的位置,这样在之后的任何时刻,我们都能够快速地得到版本的源代码,从而能够比较各个版本
的差异,甚至重新构建一个同样版本的构建。
Maven的版本号定义约定是这样的:
<主版本>.<次版本>.<增量版本>-<里程碑版本>
- 主版本,表示了项目的重大架构变更。
- 次版本, 表示较大范围的功能增加和变化,及Bug修复。
- 增量版本, 一般表示重大Bug的修复。
- 里程碑版本, 这往往指某一个版本的里程碑。例如,Maven3已经发布了很多里程碑版本,如 3.0-alpha-1等。这样的版本与正式的3.0相比,往往表示不是非常稳定,
还要更多测试。
主干、标签与分支,使用版本控制工具时我们都会遇到主干(trunk)、标签(tag)和branch(分支)的概念。
- 主干,项目开发代码的主体,是从项目开始直到当前都处于活动的状态。从这里可以获得项目最新的源代码以及几乎所有的变更历史。
- 分支, 从主干的某个点分离出来的代码拷贝,通常可以在不影响主干的前提下在这里进行重大Bug的修复,或者做一些实验性质的开发。如果分支达到了预期的目的
通常发生在这里的变更会被合并(merge)到主干中。
- 标签, 用来标识主干或者分支的某个点的状态,以代表项目的某个稳定状态,通常是版本的发布时状态。
使用maven管理项目版本的时候,涉及了很多版本控制系统操作,下面的例子介绍这些操作如何执行。该图展示的是一个典型的项目版本变化过程。
自动化版本发布,当熟悉了版本发布流程之后,就会希望借助工具将这一流程自动化,Maven Release Plugin提供了这样的功能,只要提供一些必要的信息,它就能
帮我们完成上述所有版本发布所涉及的操作。
Maven Release Plugin主要由三个目标,他们分别为:
- release:prepare 准备版本发布,依次执行下列操作
检查项目是否有未提交的代码
检查项目是否有快照版本依赖
根据用户的输入将快照版本升级为发布版本
将POM中的SCM信息更新为标签地址
基于修改后的POM执行Maven构建
提交POM变更
基于用户输入为代码打标签
将代码从发布版升级为新的快照版
提交POM变更
- release : rollback 回退release : prepare所执行的操作。将POM回退至release: prepare之前的状态,并提交。需要注意的是,该步骤不会删除release:prepare生成的标签,
因此用户需要手动删除。
- release: perform 执行版本发布。签出release: prepare生成的标签中的源代码,并在此基础上执行mvn deploy命令打包并部署构件至仓库。
要为项目发布版本,首先需要为其添加正确的版本控制系统信息,这是因为maven release plugin需要知道版本控制系统的主干、标签等地址信息后才能执行相关的操作。
一般项目配置信息代码如下图:
connection表示一个只读的scm地址,developerConnection元素表示可写的scm地址,url则表示可以在浏览器中访问的scm地址。为了能让Maven识别,connection和developerConnection
必须以scm开头,冒号之后的部分表示版本控制工具的类型。该配置只告诉Maven当前代码的位置(主干),而版本发布还要涉及标签操作。还需要配置Maven Release Plugin告诉其标签基础
目录,如图:
一切就绪之后运行命令:$mvn release:prepare , Maven Release Plugin开始准备发布版本,如果检测到项目有未提交代码,或者有快照版本的依赖,则会提示出错。如果没有问题,则会提示
用户输入想要发布的版本号、标签的名称以及新的快照版本号。
如果项目的artifactId为app,发布前版本为1.0.0-SNAPSHOT,则Maven Release Plugin会提示使用发布版本号1.0.0,使用标签名app-1.0.0,新的开发版本为1.0.0-SNAPSHOT。如果这些
值是你想要的直接按ENTER,否则填入想要值按ENTER。
基于这些信息,Maven Release Plugin会将版本从1.0.0-SNAPSHOT更新为1.0.0,并更新SCM地址http://192.168.1.103/app/trunk至http://192.168.1.103/app/tags/tag/app-1.0.0.并运行一
次Maven防止意外的错误出现,然后提交变化。为该版本打上标签。标签地址是http://192.168.1.103/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会提示用户设定每个模块发布版本号及新的开发版本号。
如果检查release:prepare结果没有问题,标签和新的发布版本都是正确的,可以执行$mvn release:perfom, 该命令将标签中的代码签出执行mvn deploy命令构建版本,并部署到仓库中。
自动化构建分支,在正式发布版本1.0.0的同时,还可以穿件一个分支来修复将来这个版本可能遇到的中大的Bug。这个过程可以手动完成,如使用svn copy操作将主干代码复制到一个名为
1.1.x的分支中,然后修改分支中的POM文件,升级其版本为1.1.1-SNAPSHOT,这会设计很多操作。
使用Maven Release Plugin的branch目标,它能帮我们自动化这些过程:
- 检查本地有无未提交的代码
- 为分支更改POM的版本,例如从11.0-SNAPSHOT改成1.1.1-SNAPSHOT
- 将POM中的SCM信息改为分支地址
- 提交以上更改
- 将主干的代码复制到分支中
- 修改本地代码使其回退到分支之前的版本
- 提交本地更改
为了让Maven Release Plugin正常工作,和版本发布一样,必须在POM中提供正确的SCM信息。此外由于分支操作会涉及版本控制系统里的分支地址,因此还要为其配置分支基础目录。
然而tagBase和branchBase并非是一定要配置的。如果为版本控制仓库使用了标准的布局,即在平行的trunk/tags/branches目录下分别放置项目主干代码、标签代码和
分支代码。那么Maven Release Plugin就能够自动根据主干代码位置计算出标签及分支代码的位置,因此你就可以省略这两项配置。