首页 > 代码库 > Maven实战读书笔记(14)

Maven实战读书笔记(14)

什么是版本管理?

版本管理是指项目整体版本的演变过程管理,如从1.0-SNAPSHOT1.0再到1.1-SNAPSHOT

 

什么是版本控制?

版本控制是指借助版本控制工具(如Subversion)追踪代码的每一个变更

 

什么时候可以将快照版本更新为发布版本

1、所有自动化测试应当全部通过

2、项目没有配置任何快照版本的依赖

3、项目没有配置任何快照版本的插件

4、项目所包含的代码已经全部提交到版本控制系统中

 

Maven的版本号定义约束

可能有个版本号是这样的,1.3.4-beta-2

Maven的版本号定义约定是这样的,<主版本>.<次版本>.<增量版本>-<里程碑版本>

1、主版本:表示项目的重大架构变更

2、次版本:表示较大范围的功能增加和变化

3、增量版本:一般表示重大Bug的修复

4、里程碑版本:顾名思义,这往往指某一个版本的里程碑。例如,Maven 3已经发布了很多里程碑版本,如3.0-alpha-13.0-alpha-23.0-beta-1等,这样的版本与正式的3.0相比,往往表示不是非常稳定,还需要很多测试

 

关于版本号需要注意的地方

1、不是每个版本号都必须拥有这四个部分,一般来说,主版本和次版本都会声明,但增量版本和里程碑就不一定了

2、当用户在声明依赖或插件未声明版本时,Maven就会根据上述版本号约定自动解析最新版本。这个时候就需要对版本号进行排序,对于主版本、次版本和增量版本来说,比较是基于数字的,因此1.5>1.4>1.3.11>1.3.9。而对于里程碑版本,Maven则只进行简单的字符串比较,因此会得到1.2-beta-3>1.2-beta-11的结果

 

理解主干、标签与分支

1、主干:项目开发代码的主体,是从项目开始直到当前都处于活动的状态。从这里可以获得项目最新的源代码以及几乎所有的变更历史

2、分支:从主干的某个点分离出来的代码拷贝,通常可以在不影响主干的前提下在这里进行重大Bug的修复,或者做一些实验性质的开发。如果分支达到了预期的目的,通常发生在这里的变更会被合并(merge)到主干中

3、标签:用来标识主干或者分支的某个点的状态,以代表项目的某个稳定状态,这通常就是版本发布时的状态

 

使用Maven管理项目版本,可能有这样的场景

技术分享

项目最初的版本是1.0.0-SNAPSHOT,经过一段时间的开发后,1.0.0版本发布,这个时候就需要打一个标签,图中用一个长条表示。然后项目进入1.1.0-SNAPSHOT状态,大量的开发工作都完成在主干中,添加了一些新特性并修复了很多Bug之后。项目1.1.0发布,同样,这时候需要打另一个标签。发布过后,项目进入1.2.0-SNAPSHOT阶段,可这个时候用户报告1.1.0版本有一个重大的Bug,需要尽快修复,我们不能在主干中修Bug,因为主干有太多的变化,无法在短时间内测试完毕并发布,我们也不能停止1.2.0-SNAPSHOT的开发,因此这时候可以基于1.1.0创建一个1.1.1-SNAPSHOT的分支,在这里进行Bug修复,然后为用户发布一个1.1.1增量版本,同时打上标签。当然,还不能忘了把Bug修复涉及的变更合并到1.2.0-SNAPSHOT的额主干中,主干在开发一段时间之后,发布1.2.0版本,然后进入到新版本1.3.0-SNAPSHOT的开发过程中

 

使用Maven Release Plugin插件,流程化管理版本发布

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

n         releaseprepare,准备版本发布

n         releaserollback,回退releaseprepare所执行的操作

n         releaseperform,执行版本发布

 

releaseperpare目标都做了哪些操作?

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

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

n         根据用户的输入将快照版本升级为发布版

n         POM中的SCM信息更新为标签地址

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

n         提交POM变更

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

n         对代码从发布版升级为新的快照版

n         提交POM变更

 

releaserollback目标都做了哪些操作?

POM回退至releaseprepare之前的状态,并提交。需要注意的是,该步骤不会删除releaseprepare生成的标签,因此用户需要手动删除

 

releaseperform目标都做了哪些操作?

签出releaseprepare生成的标签中的源代码,并在此基础上执行mvn deploy命令打包并部署构件至仓库

 

另外,使用Maven Release Plugin插件需要注意

1、要为项目发布版本,首先需要为其添加正确的版本控制系统信息

2、这是因为Maven Release Plugin需要知道版本控制系统的主干、标签等地址信息后才能执行相关的操作

 

一般的SCM,版本发布配置SCM信息如下

<project>

...

       <scm>

              <connection>scm:svn:http://10.1.0.56/app/trunk</connection>

              <developerConnection>scm:svn:http://10.1.0.56/app/trunk</developerConnection>

              <url>http://10.1.0.56/account/trunk</url>

       </scm>
...

</project>

对上面配置进行说明

1connection元素表示一个只读的scm地址

2developerConnection元素表示可写的scm地址

3url表示可以在浏览器中访问的scm地址

4、为了让Maven识别,connectiondeveloperConnection必须以scm开头,冒号之后的部分表示版本控制工具类型(这里是svn),Maven还支持cvsgit

5、接下来才是实际的scm

地址,该配置中的connection使用了http协议,而developerConnection则由于涉及写操作,使用https协议进行了保护

 

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

 

配置maven-release-plugin提供标签基础目录

<plugin>

       <groupId>org.apache.maven.plugins</groupId>

       <artifactId>maven-release-plugin</artifactId>

       <version>2.0</version>

       <configuration>

              <tagBase>http://10.1.0.56/app/tags/</tagBase>

       </configuration>

</plugin>

 

在执行releaseprepare之前还有两个注意点

1、系统必须要提供svn命令行工具,Maven需要svn命令行工具执行相关操作,而无法使用图形化工具,如TortoiseSVN

2POM必须配置了可用的部署仓库,因为releaseperform会执行deploy操作将构件发布到仓库中

 

maven-release-plugin提供autoVersionSubmodules参数

使用这个参数,maven-release-plugin会自动为所有子模块使用与父模块一致的发布版本和新的SNAPSHOT版本:

mvn release:prepare -DautoVersionSubmodules=true

 

如果使用release:prepare命令执行的结果没有问题,就执行mvn release:perform命令

这部分会出现很多问题!~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 

执行release:performrelease:branch命令以后再试

 

如何保障构件的安全性

当从中央仓库下载第三方构件的时候,你可能会想要验证这些文件的合法性,例如它们是由开源项目官方发布的,并且没有被篡改过,同样地,当发布自己项目给客户使用的时候,你的客户也会想要验证这些文件是否是由你的项目组发布的,且没有被恶意篡改过PGP (Pretty Good Privacy)就是这样一个用来帮助提高安全性的技术。PGP最常用来给电子邮件进行加密、解密以及提供签名,以提高点子邮件交流的安全性

 

基于PGP标准的GPG

GnuPG (简称GPG,来自http://www.gnupg.org/ PGP标准的一个免费实现,无论是类UNIX平台还是Windows平台,都可以使用它。GPG能够帮助我们为文件生成签名、管理密钥以及验证签名等

 

具体如何使用GnuPG以后用到再说吧


Maven实战读书笔记(14)