maven.变成了-release

Posted 2023-03-16

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版本。
流程：

发版之前需要保证本地文件提交，否则会导致发版失败 =>发版前要commit
发版之前需要保证本地成功执行 mvn checkstyle:checkstyle，否则会导致发版失败(可选)
发版之前需要保证mvn仓库无重复版本，git上无重复的Tag，否则会导致发版失败
要清楚本地tag和远程tag
发布之前需要保证本地成功执行mvn clean install -Dmaven.test.skip=true，否则会导致发版失败，而且有效性只有一次，修改代码后需要重新执行该命令。
发版命令：
mvn release:prepare -Darguments="-DskipTests" 预准备
mvn release:perform -Darguments="-DskipTests" 发布
mvn release:rollback -Darguments="-DskipTests" 回滚命令
关于上面三条命令的更详细解释：
release:prepare这条命令主要是做打包前的准备：
输入对应的release需要打包的版本等信息，如果不输入有默认的内容
将需要记录和准备的内容缓存到pom.xml目录下的release.properties文件中
在本地和远程库的GIT中打上对应版本的tag
在准备过程中还会run 单元测试等phase，如果没有异常的话可以继续最后一步。如果git还没有commit或单元测试失败会导致prepare失败，这时候你就需要到下面一个命令了。
release:rollback
如果在准备阶段发生错误，或者需要修改某些地方的话。就需要到这个命令了，这个命令执行以后会做以下这些事
删除线上git库tag，但是本地库tag没有被删除，需要手动使用git tag -d XXX进行删除。如果不将本地库中的tag删除将会导致prepare失败。
删除之前缓存在pom.xml统一目录下的配置
release:perform
如果确认无误了以后，就可以执行perform命令了。这个命令干了以下这些事：
验证代码合法性
将你之前的1.0-SNAPSHOT改为1.1-SNAPSHOT
将1.0版本deploy至scm配置的nexus release库中
jar打包上传至nexus库
恭喜，你已经把你的1.0-SNAPSHOT成功的打包成1.0的release版本了。同时你会发现你的pom.xml文件会自动的变成1.1-SNAPSHOT版本。虽然这一系列操作都可以通过手动完成。但是有这个工具的存在，免去了很多步骤。
QA
实际发包过程中，会遇到一些报错，这个时候通过执行 rollback外加删除远程和本地的 tag基本可以解决问题。 参考技术A ma等ven待.变成.了-r.ele.ase.

M.ave.n-release