zoukankan      html  css  js  c++  java
  • [转]Maven多模块结构下版本管理的正确姿势-revision

    转自: Maven多模块结构下版本管理的正确姿势(CI Friendly Versions) - ${revision}

    在使用Maven多模块结构工程时,配置版本是一个比较头疼的事。继承版本,依赖版本,自身版本,都需要单独定义,很是麻烦。但其实Maven已经提供了这种CI版本的管理方式,下面来介绍具体用法。

    从Maven 3.5.0-beta-1版本开始,就可以使用{sha1} 和 ${changelist}作为占位符来替换pom文件了。

    注意:Idea下使用${revision}定义Parent版本时会提示错误“Reports that usage of properties in modules parent definition is prohibited”,但并不影响使用,只是Idea不支持这种写法而已。

    单模块项目

    <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}来替换版本。

    还可以用另一种动态添加参数的方式来指定版本

    $ mvn -Drevision=1.0.0-SNAPSHOT clean package
    

    -D 代表设置环境变量

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

    或者在(父)项目的properties中定义版本:

    <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将如下所示:

    <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>
       ...
    </project>
    

    多模块项目中子模块的版本应该使用父工程的版本,单独设置版本的话会导致版本混乱。

    依赖

    多模块工程结构下,会有很多模块依赖的情况,应该使用${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}替换为实际的版本。

    install/deploy后会在项目目录下生成文件:.flattened-pom.xml , 这是替换版本号后的pom.xml文件 , 也是最终打进 jar 包里的文件 .

    参考

  • 相关阅读:
    《ML in Action》笔记(2) —— ID3决策树
    《ML in Action》笔记(1) —— kNN分类器
    MYSQL笔记
    Javascript代码摘录
    初试mysql存储过程&触发器
    百度地图API应用实践(一) —— 栅格图(草稿)
    2020年8月9日, 网吧, 歌单, 极客时间, 龙岩网络图书馆, 正则, WPS, Python
    2020年8月3日, 网吧 ,
    2020年7月13日,想在网吧搞学习,实属想多了
    账号被盗,什么原因呢?是我的操作系统太脆弱,还是博客园存在安全隐患?
  • 原文地址:https://www.cnblogs.com/ElEGenT/p/12938773.html
Copyright © 2011-2022 走看看