Maven多模塊結構下版本管理的正確姿式(CI Friendly Versions) - ${revision}

時間 2019-12-04

標籤 maven 多模塊結構版本管理正確 friendly versions revision 欄目 Maven 简体版

原文原文鏈接

在使用Maven多模塊結構工程時，配置版本是一個比較頭疼的事。繼承版本，依賴版本，自身版本，都須要單獨定義，非常麻煩。但其實Maven已經提供了這種CI版本的管理方式，下面來介紹具體用法。html

從Maven 3.5.0-beta-1版本開始，就能夠使用${revision}, ${sha1} 和 ${changelist}做爲佔位符來替換pom文件了。git

注意：Idea下使用${revision}定義Parent版本時會提示錯誤「Reports that usage of properties in modules parent definition is prohibited」，但並不影響使用，只是Idea不支持這種寫法而已。github

單模塊項目

<project>
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>org.apache</groupId>
    <artifactId>apache</artifactId>
    <version>18</version>
  </parent>
  <groupId>org.apache.maven.ci</groupId>
  <artifactId>ci-parent</artifactId>
  <name>First CI Friendly</name>
  <version>${revision}</version>
  ...
</project>

這種狀況比較簡單，只使用了${revision}來替換版本。spring

還能夠用另外一種動態添加參數的方式來指定版本apache

$ mvn -Drevision=1.0.0-SNAPSHOT clean package

-D表明設置環境變量bash

-D,--define <arg>                      Define a system property

或者在(父)項目的properties中定義版本：maven

<project>
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>org.apache</groupId>
    <artifactId>apache</artifactId>
    <version>18</version>
  </parent>
  <groupId>org.apache.maven.ci</groupId>
  <artifactId>ci-parent</artifactId>
  <name>First CI Friendly</name>
  <version>${revision}</version>
  ...
  <properties>
    <revision>1.0.0-SNAPSHOT</revision>
  </properties>
</project>

多模塊項目

如今來看看多模塊構建的狀況。有一個父項目和一個或多子模塊。父pom將以下所示：spring-boot

<project>
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>org.apache</groupId>
    <artifactId>apache</artifactId>
    <version>18</version>
  </parent>
  <groupId>org.apache.maven.ci</groupId>
  <artifactId>ci-parent</artifactId>
  <name>First CI Friendly</name>
  <version>${revision}</version>
  ...
  <properties>
    <revision>1.0.0-SNAPSHOT</revision>
  </properties>
  <modules>
    <module>child1</module>
    ..
  </modules>
</project>

子模塊配置：ui

<project>
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>org.apache.maven.ci</groupId>
    <artifactId>ci-parent</artifactId>
    <version>${revision}</version>
  </parent>
  <groupId>org.apache.maven.ci</groupId>
  <artifactId>ci-child</artifactId>
   ...
</project>

多模塊項目中子模塊的版本應該使用父工程的版本，單獨設置版本的話會致使版本混亂。code

依賴

多模塊工程結構下，會有不少模塊依賴的狀況，應該使用${project.version}來定義依賴（同父工程下的依賴）的版本

<project>
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>org.apache</groupId>
    <artifactId>apache</artifactId>
    <version>18</version>
  </parent>
  <groupId>org.apache.maven.ci</groupId>
  <artifactId>ci-parent</artifactId>
  <name>First CI Friendly</name>
  <version>${revision}</version>
  ...
  <properties>
    <revision>1.0.0-SNAPSHOT</revision>
  </properties>
  <modules>
    <module>child1</module>
    ..
  </modules>
</project>

子工程配置：

<project>
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>org.apache.maven.ci</groupId>
    <artifactId>ci-parent</artifactId>
    <version>${revision}</version>
  </parent>
  <groupId>org.apache.maven.ci</groupId>
  <artifactId>ci-child</artifactId>
   ...
  <dependencies>
        <dependency>
      <groupId>org.apache.maven.ci</groupId>
      <artifactId>child2</artifactId>
      <version>${project.version}</version>
    </dependency>
  </dependencies>
</project>

定義依賴版本時，使用${revision}會致使構建失敗，須要使用${project.version}。

install/deploy

若是使用以上設置來發布，必須使用flatten-maven-plugin

<project>
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>org.apache</groupId>
    <artifactId>apache</artifactId>
    <version>18</version>
  </parent>
  <groupId>org.apache.maven.ci</groupId>
  <artifactId>ci-parent</artifactId>
  <name>First CI Friendly</name>
  <version>${revision}</version>
  ...
  <properties>
    <revision>1.0.0-SNAPSHOT</revision>
  </properties>

 <build>
  <plugins>
    <plugin>
      <groupId>org.codehaus.mojo</groupId>
      <artifactId>flatten-maven-plugin</artifactId>
      <version>1.1.0</version>
      <configuration>
          是否更新pom文件，此處還有更高級的用法
        <updatePomFile>true</updatePomFile>
        <flattenMode>resolveCiFriendliesOnly</flattenMode>
      </configuration>
      <executions>
        <execution>
          <id>flatten</id>
          <phase>process-resources</phase>
          <goals>
            <goal>flatten</goal>
          </goals>
        </execution>
        <execution>
          <id>flatten.clean</id>
          <phase>clean</phase>
          <goals>
            <goal>clean</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
  </build>
  <modules>
    <module>child1</module>
    ..
  </modules>
</project>

最終執行install/deploy後，會將該模塊的pom文件中的${revision}替換爲實際的版本。