versions-maven-plugin · JAVA

[TOC] # 简介这个插件是用来修改pom的版本的，几乎是所有的版本号，比如工程，依赖和插件等等。 maven的版本管理经验，所有依赖都有一个root-pom来统一管理。这样的话，每发一个release的包，其实就应该同时也修改了root-pom中这个包的版本号，这样，其他工程才能依赖到最新的代码。那么修改root-pom版本号的任务就可以交给versions插件。这个可以放在jenkins中作为一个post-action来处理。每构建一个release包就触发一次root-pom修改 ~~~ <plugins> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>versions-maven-plugin</artifactId> <version>2.3</version> </plugin> </plugins> ~~~ # 常用命令 **修改本工程的版本号：** ~~~ mvn versions:set -DnewVersion=xxx ~~~ 然后install生成包 ~~~ mvn clean install -Dmaven.test.skip=true ~~~ **回滚：** versions的任何目标，最终都会先记录一个pom.xml.versionsBackup文件暂存改动，可以使用 `mvn versions:revert`来回滚，这样就会恢复成`pom.xml.versionsBackup`文件的样子同时删除`pom.xml.versionsBackup`。当然也可以`mvn versions:commit`来提交修改，删除`pom.xml.versionsBackup`文件 **修改依赖的版本：** * versions:use-next-release在pom中搜索所有新版本的非快照版本，并将它们替换为下一个版本。 * versions:use-latest-releases 在pom中搜索所有新版本的非快照版本，并用最新版本替换它们。 * versions:use-next -SNAPSHOT在pom中搜索所有新的非快照版本，并将它们替换为新的快照版本。 * versions:use-latest-snapshots在pom中搜索所有最新的非快照版本，并将它们替换为最新的快照版本。 * versions:use-next-versions在pom中搜索更新版本的所有版本，并用新版本替换它们。 * versions:use-latest-versions在pom中搜索所有更新的版本，并用最新的版本替换它们。其实主要就这六个。前四个只会修改pom中的release依赖版本号，修改为下一个release或者snapshot。后两个会修改所有的依赖为下一个或者最新的版本号。注意2.0版本的下一个snapshot为2.1-SNAPSHOT而非3.0-SNAPSHOT。当然可以指定修改特定的依赖的版本号，通过添加`-Dincludes=group:artifact`即可，并且支持通配符。另外，默认会修改dependency和dependencyMangement的版本号，可以加参数限定： ~~~ mvn versions:use-next-releases -DprocessDependencies=false mvn versions:use-next-releases -DprocessDependencyManagement=false ~~~ # 修改pom中的property 可以使用set-property目标来修改pom中定义的property。这个在修改root-pom中的依赖版本会很有用。因为一般root-pom中的依赖的版本都是通过property来定义的，这样通过修改property就能修改依赖版本了，更新一个工程之后修改root-pom会很有用。 ~~~ <dependency> <groupId>com.liyao</groupId> <artifactId>libJar</artifactId> <version>${lib.version}</version> </dependency> <lib.version>1.0-SNAPSHOT</lib.version> ~~~ ~~~ mvn versions:set-property -Dproperty=lib.version -DnewVersion=1.1-SNAPSHOT ~~~ # 参数介绍 |参数 |默认值 |说明 | | --- | --- | --- | |allowSnapshots |false |是否更新-snapshot快照版| |artifactId |${project.artifactId} |指定artifactId | |generateBackupPoms |true |是否备份pom文件 | |groupId |${project.groupId} |指定groupId | |newVersion | |设置的新版本号 | |nextSnapshot |false |更新版本号为下一个快照版本号| |oldVersion |${project.version} |指定需要更新的版本号可以使用缺省‘*’| |processAllModules |false |是否更新目录下所有模块无论是否声明父子节点| |processDependencies |true |是否更新依赖其的版本号| |processParent |true |是否更新父节点的版本号| |processPlugins |true |是否更新插件中的版本号| |processProject |true |是否更新模块自身的版本号| |removeSnapshot |false |移除snapshot快照版本，使之为release稳定版| |updateMatchingVersions |true |是否更新在子模块中显式指定的匹配版本(如/项目/版本)。| # 版本控制 ## 修改全模块版本号修改版本的时候，必须规范模块中pom.xml文件的编写，显式声明其父子节点信息(`<parent></parent>|<modules></modules>`)，需要修改全部模块的版本号为1.0.1-SNAPSHOT,可以在最顶层的根目录，如产品主干在src下，cmd进入根目录，运行命令 ~~~ mvn versions:set -DoldVersion=* -DnewVersion=1.0.1-SNAPSHOT -DprocessAllModules=true -DallowSnapshots=true ~~~ 修改后输入: ~~~ mvn clean install -DskipTests ~~~ 成功后,输入: ~~~ mvn dependency:tree -Dverboss -Dincludes=${project.groupId}:${project.artifactId} ~~~ 检查工程的依赖树是否全部依赖了1.0.1-SNAPSHOT的base模块如果全部模块版本号都改为了:1.0.1-SNAPSHAOT，即修改成功。若修改失败,可是使用命令回退版本号: ~~~ mvn versions:revert ~~~ 若确认版本，可使用命令: ~~~ mvn versions:commit ~~~ 修改版本所产生的backup文件会自动删除。 ## 修改模块版本若开需要推进某模块版本号，或有问题需要回退某模块的版本，或者区域分支想更新某模块为新版本，例如修改base模块的版本号为1.0.1-SNAPSHOT,cmd命令行进入模块目录。 ~~~ mvn versions:set -DnewVersion=1.0.1-SNAPSHOT -DprocessAllModules=true -DallowSnapshots=true ~~~ 即可修改该模块及依赖该模块的版本号为1.0.1-SNAPSHOT，其中参数-DallowSnapshots=true,表示允许release版修改为snapshot版。加上参数`-DprocessAllModules=true`表示该模块下的子模块及依赖其的版本号都改成`1.0.1-SNAPSHOT`。 ## 修改指定模块版本号如果想修改指定模块的版本号即整个模块中依赖其的版本号,比如`groupId:groupId:{artifact}`的版本号修改为1.0.2-SNAPSHOT,可以运行命令: ~~~ mvn versions:set -DgroupId=${groupId} -DartifactId=${artifact} -DoldVersion=* -DnewVersion=1.0.2-SNAPSHOT -DallowSnapshots=true ~~~ 其中，artifactId、groupId和version在maven中形成三维坐标以指定模块，而在这里指定`-DgroupId=${groupId} -DartifactId=${artifact}` 确定制定修改的模块为`${groupId}:${artifact}`。如果不希望修改依赖mongodb的模块也修改mongodb的版本号，可以使用参数-DprocessDependencies=false取消依赖其的修改，从而只修改xxx工程的版本号: ~~~ mvn versions:set -DgroupId=${groupId} -DartifactId=xxx -DoldVersion=* -DnewVersion=1.0.2-SNAPSHOT -DallowSnapshots=true -DprocessDependencies=false ~~~ # 快照版与正式版切换有些时候我们会先用SnapShot版本，当他发布正式版本的时候，我们就需要换过来，例如 ~~~ <dependency> <groupId>org.codehaus.cargo</groupId> <artifactId>cargo-core-api</artifactId> <version>1.0-alpha-7-SNAPSHOT</version> </dependency> ~~~ 然后我们执行 ~~~ mvn versions:unlock-snapshots ~~~ 版本就可以变成，SNAPSHOT就去掉了 ~~~ <dependency> <groupId>org.codehaus.cargo</groupId> <artifactId>cargo-core-api</artifactId> <version>1.0-alpha-7</version> </dependency> ~~~ 也可以指定具体的库进行更新 ~~~ mvn versions:use-releases -Dincludes=org.codehaus.plexus:plexus-utils ~~~ 默认情况下dependencyManagment和dependencies区域内的版本都会被更新，需要指定特定版本的话就需要使用 ~~~ mvn versions:use-releases -DprocessDependencies=false mvn versions:use-releases -DprocessDependencyManagement=false ~~~