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

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

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

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

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

MAVEN多個子模塊項目

以上是一個基本的

主項目parent包

maven-multily-module/pom.xml

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

項目子模塊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保持一致）
子模塊無需定義groupId
子模塊所有的依賴包版本全部集成parent模塊，即：子模塊不得定義依賴包版本號
子模塊需定義是否需要deploy到私服<maven.deploy.skip>true</maven.deploy.skip>
對于需要depoly的子模塊【對外發(fā)布的，比如dubbo提供的api包】不應(yīng)該依賴重量級jar包(比如：spring,mybatis等)

子模塊packaging為pom

app-core/pom.xml

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

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

MAVEN聚合多個子模塊項目版本號修改

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

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

這種手工修改方式極容易遺漏，導致項目內(nèi)部模塊版本依賴存在問題。

我們可以通過maven的插件方式來升級整個項目的版本號。方案如下：

在項目頂層pom中添加version插件

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

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

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

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

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

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