快捷導(dǎo)航

Maven多模塊及version修改的實(shí)現(xiàn)方法

更新時(shí)間：2019年06月04日 14:27:25 作者：曹金桂

這篇文章主要介紹了Maven多模塊及version修改的實(shí)現(xiàn)方法，小編覺(jué)得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧

對(duì)于使用maven構(gòu)建的java項(xiàng)目，通常聚合多個(gè)子模塊項(xiàng)目。在版本迭代的過(guò)程中經(jīng)常變更版本號(hào)，更新parent版本號(hào)，發(fā)現(xiàn)子模塊版本號(hào)沒(méi)有更新，需要一個(gè)個(gè)的手動(dòng)去更新，太麻煩，且容易出錯(cuò)。

在版本更新之后，內(nèi)部模塊之間的依賴也需要變更，往往存在遺漏。

MAVEN多個(gè)子模塊項(xiàng)目

以上是一個(gè)基本的

主項(xiàng)目parent包

maven-multily-module/pom.xml

指定整個(gè)應(yīng)用的dependencyManagement
定義項(xiàng)目的發(fā)布的倉(cāng)庫(kù)地址distributionManagement
所有第三方依賴的版本號(hào)全部定義在properties下
所有內(nèi)部模塊依賴版本號(hào)統(tǒng)一使用**${project.version}**
指定所有的子模塊modules

項(xiàng)目子模塊pom.xml

app-api/pom.xml;app-dao/pom.xml;util/pom.xml;trade-core/pom.xlm;user-core/pom.xml

明確定義parent模塊的artifactId，groupId，version
不要定義子模塊的version（同parent保持一致）
子模塊無(wú)需定義groupId
子模塊所有的依賴包版本全部集成parent模塊，即：子模塊不得定義依賴包版本號(hào)
子模塊需定義是否需要deploy到私服<maven.deploy.skip>true</maven.deploy.skip>
對(duì)于需要depoly的子模塊【對(duì)外發(fā)布的，比如dubbo提供的api包】不應(yīng)該依賴重量級(jí)jar包(比如：spring,mybatis等)

子模塊packaging為pom

app-core/pom.xml

指定所有的子模塊modules
無(wú)需定義groupId
明確定義parent模塊的artifactId，groupId，version

以上定義規(guī)則保證了項(xiàng)目?jī)?nèi)部模塊之間的依賴版本統(tǒng)一，第三方依賴包版本不沖突

MAVEN聚合多個(gè)子模塊項(xiàng)目版本號(hào)修改

雖然按照以上的規(guī)則定義模塊及依賴，但是在版本迭代過(guò)程中需要修改對(duì)應(yīng)的版本號(hào)，還是需要頂級(jí)pom的版本號(hào)，及每個(gè)子模塊內(nèi)部parent的版本號(hào)。

 <parent>
  <groupId>com.maven.multily.module</groupId>
  <artifactId>parent</artifactId>
  <!--版本升級(jí)需要修改每個(gè)子模塊 parent.version的值-->
  <version>1.1.0-SNAPSHOT</version>
 </parent>

這種手工修改方式極容易遺漏，導(dǎo)致項(xiàng)目?jī)?nèi)部模塊版本依賴存在問(wèn)題。

我們可以通過(guò)maven的插件方式來(lái)升級(jí)整個(gè)項(xiàng)目的版本號(hào)。方案如下：

在項(xiàng)目頂層pom中添加version插件

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>versions-maven-plugin</artifactId>
  <version>2.3</version>
  <configuration>
   <generateBackupPoms>false</generateBackupPoms>
  </configuration>
 </plugin>

在項(xiàng)目根目錄下執(zhí)行以下命令修改版本號(hào)

// 設(shè)置新的版本號(hào)未1.2.0-SNAPSHOT
mvn versions:set -DnewVersion=1.2.0-SNAPSHOT

以上命令會(huì)將maven-multily-module/pom.xml版本修改為1.2.0-SNAPSHOT，且會(huì)修改所有子模塊內(nèi) parent的version為1.2.0-SNAPSHOT。所以建議子模塊不設(shè)置version，自動(dòng)從parent繼承version即可

相關(guān)參數(shù)說(shuō)明

參數(shù)	默認(rèn)值	說(shuō)明
allowSnapshots	false	是否更新-snapshot快照版
artifactId	${project.artifactId}	指定artifactId
generateBackupPoms	true	是否備份pom文件
groupId	${project.groupId}	指定groupId
newVersion		設(shè)置的新版本號(hào)
nextSnapshot	false	更新版本號(hào)為下一個(gè)快照版本號(hào)
oldVersion	${project.version}	指定需要更新的版本號(hào)可以使用缺省‘*'
processAllModules	false	是否更新目錄下所有模塊無(wú)論是否聲明父子節(jié)點(diǎn)
processDependencies	true	是否更新依賴其的版本號(hào)
processParent	true	是否更新父節(jié)點(diǎn)的版本號(hào)
processPlugins	true	是否更新插件中的版本號(hào)
processProject	true	是否更新模塊自身的版本號(hào)
removeSnapshot	false	移除snapshot快照版本，使之為release穩(wěn)定版
updateMatchingVersions	true	是否更新在子模塊中顯式指定的匹配版本(如/項(xiàng)目/版本)。