Maven发版

起源

最近会改组内一些公共jar包，为了不影响已发布的 jar包，增加新功能时需要发布新版本的 jar包。之前没搞过这一块，最近遇到就总结下操作流程。

主体

maven会根据模块的版本号(pom文件中的version)中是否带有-SNAPSHOT来判断是快照版本还是正式版本。

deploy发布

传统的web项目一般会有一个api模块，用于发布对外的RPC接口，如Dubbo。这个时候一般通过发布jar包，提供maven坐标的方式，让别人引入你的依赖。这个时候可以直接通过maven deploy命令直接发布快照版本到私服。

像IDEA这种集成环境，可以通过简单的点击直接发布。

同时需要注意，maven基于 POM文件中的 version来确定你将要发布的 SNAPSHOT还是 release。所以不能瞎命名，容易把不稳定的 jar包发布到 release仓库。

Release命令发布

比较复杂的是通过 mvn release:prepare和 mvn release:perform来发布，这种发布会自动升级版本，不用手动维护POM文件中的version版本。

下面的流程我就直接摘抄组内大佬写的 wiki：

1. 发版之前需要保证本地文件提交，否则会导致发版失败 =>发版前要commit
2. 发版之前需要保证本地成功执行 mvn checkstyle:checkstyle，否则会导致发版失败（可选）
3. 发版之前需要保证mvn仓库无重复版本，git上无重复的Tag，否则会导致发版失败

要清楚本地tag和远程tag

# 列出本地tag
git tag
# 删除V0.1.2标签
git tag -d v0.1.2 
# 删除远程标签protobuf-2.5.0rc1
git push origin :refs/tags/protobuf-2.5.0rc1
更多操作可以参见网络资料

1. 发布之前需要保证本地成功执行mvn clean install -Dmaven.test.skip=true，否则会导致发版失败，而且有效性只有一次，修改代码后需要重新执行该命令。
2. 发版命令：
   • mvn release:prepare -Darguments="-DskipTests" 预准备
   • mvn release:perform -Darguments="-DskipTests" 发布
   • mvn release:rollback -Darguments="-DskipTests" 回滚命令

关于上面三条命令的更详细解释：

release:prepare这条命令主要是做打包前的准备：

1. 输入对应的release需要打包的版本等信息，如果不输入有默认的内容
2. 将需要记录和准备的内容缓存到pom.xml目录下的release.properties文件中
3. 在本地和远程库的GIT中打上对应版本的tag

在准备过程中还会run 单元测试等phase，如果没有异常的话可以继续最后一步。如果git还没有commit或单元测试失败会导致prepare失败，这时候你就需要到下面一个命令了。

release:rollback

如果在准备阶段发生错误，或者需要修改某些地方的话。就需要到这个命令了，这个命令执行以后会做以下这些事

1. 删除线上git库tag，但是本地库tag没有被删除，需要手动使用git tag -d XXX进行删除。如果不将本地库中的tag删除将会导致prepare失败。
2. 删除之前缓存在pom.xml统一目录下的配置

release:perform

如果确认无误了以后，就可以执行perform命令了。这个命令干了以下这些事：

1. 验证代码合法性
2. 将你之前的1.0-SNAPSHOT改为1.1-SNAPSHOT
3. 将1.0版本deploy至scm配置的nexus release库中
4. jar打包上传至nexus库

恭喜，你已经把你的1.0-SNAPSHOT成功的打包成1.0的release版本了。同时你会发现你的pom.xml文件会自动的变成1.1-SNAPSHOT版本。虽然这一系列操作都可以通过手动完成。但是有这个工具的存在，免去了很多步骤。

QA

实际发包过程中，会遇到一些报错，这个时候通过执行 rollback外加删除远程和本地的 tag基本可以解决问题。

参考文献

• Maven Release发布指南---Git版
• Maven deploy部署jar包到远程私仓

来自为知笔记(Wiz)