【工具篇】Maven使用${revision}实现多模块版本统一管理

news2024/11/24 23:02:26

背景说明

在使用Maven多模块结构工程时,版本管理是一件很繁琐且容易出错的事情。每次升级版本号都要手动调整或者通过mvn versions:set -DnewVerion=xx命令去更改每一个子模块的版本号,非常的不方便,而且会改动所有的模块,出现如下效果:
在这里插入图片描述

解决方法

其实Maven已经提供了这种CI版本的管理方式,下面来介绍一下具体使用方法。

Maven官方文档说:自 Maven 3.5.0-beta-1 开始,可以使用 ${revision}, ${sha1} and/or ${changelist} 这样的变量作为版本占位符。

即在maven多模块项目中,可配合插件flatten-maven-plugin${revision}属性来实现全局版本统一管理。

环境说明

Maven Version:Apache Maven 3.5.0-beta-1及以上版本
Maven Plugin:flatten-maven-plugin
IDE: IntelliJ IDEA 2021.3
JDK: 1.8.0_301
POM文件:使用占位符${revision}

注意事项

① 只能命名成revision,不可以更改成其他命名;
② Idea下使用${revision}定义Parent版本时会提示错误“Reports that usage of properties in modules parent definition is prohibited”,但并不影响使用,只是Idea不支持这种写法而已,升级IDea版本也可以解决 【可忽略】

代码示例

父模块配置

在properties标签中定义revision标签:

<project>
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.4.RELEASE</version>
        <relativePath/>
    </parent>

    <groupId>org.sssss.maven</groupId>
    <artifactId>sssss-parent</artifactId>
    <version>${revision}</version>
    <packaging>pom</packaging>

    <properties>
        <!-- 全局版本控制,如果要修改版本号,修改此处即可-->
        <revision>1.0.0-SNAPSHOT</revision>
    </properties>

    <modules>
        <module>sssss-child1</module>
        ...
    </modules>

    <build>
        <plugins>
            <!-- 添加flatten-maven-plugin插件 -->
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>flatten-maven-plugin</artifactId>
                <version>1.5.0</version>
                <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>
                <inherited>true</inherited>
                <configuration>
                    <!-- 避免IDE将 .flattened-pom.xml 自动识别为功能模块 -->
                    <updatePomFile>true</updatePomFile>
                    <flattenMode>resolveCiFriendliesOnly</flattenMode>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

关键点:
① 父子模块需遵循父子目录层次;
② 在父模块中引入插件flatten-maven-plugin
③ 修改.gitignore文件,增加一行.flattened-pom.xml
④ 不可混合使用${revision}和明确字符串版本号,若出现父子模块版本号混合使用${revision}和明确字符串形式如1.0.0.-SNAPSHOT,在mvn package会出现类似如下错误:

[FATAL] Non-resolvable parent POM for org.sssss.maven:child1:[unknown-version]:
Could not find artifact org.sssss.maven:sssss-parent:pom:1.0.0-SNAPSHOT and ‘parent.relativePath’ points at wrong local POM @ line 5, column 13

关于子模块中parent.relativePath使用:

  • 默认值,不设置relativePath即为默认值,等价于<relativePath>../pom.xml</relativePath>,即遵循父子目录层次
    • 即优先查找上层目录…/pom.xml
    • 然后查找本地仓库
    • 最后查找远程仓库
    • 推荐自定义的开发项目遵循此种方式(即父子模块需遵循父子目录层次,且保持parent.relativePath的默认值)
  • 空值,即跳过本地文件目录查找
    • 直接查找本地仓库
    • 最后查找远程仓库
    • 适用于父依赖为第三方公有仓库中的依赖,如spring-boot-starter-parent
  • 其他值,可根据目录层次自行定义(推荐使用相对目录层次),如<relativePath>../module-1/pom.xml</relativePath>

子模块配置

子模块可以直接使用${revision}指定父模块的版本:

<project>
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.sssss.maven</groupId>
        <artifactId>sssss-parent</artifactId>
        <version>${revision}</version>
        <relativePath>../pom.xml</relativePath> <!-- 可忽略 -->
    </parent>

    <artifactId>sssss-child1</artifactId>
    <packaging>jar</packaging>

</project>

子模块依赖

多模块工程结构下,会有子模块相互依赖的情况,使用${revision}会导致构建失败,应该使用${project.version}来定义依赖 (同父工程下的依赖) 的版本,请勿使用${parent.version}

<project>
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.sssss.maven</groupId>
        <artifactId>sssss-parent</artifactId>
        <version>${revision}</version>
        <relativePath>../pom.xml</relativePath> <!-- 可忽略 -->
    </parent>

    <artifactId>sssss-child2</artifactId>
    <packaging>jar</packaging>
    
    <dependencies>
        <dependency>
            <groupId>org.sssss.maven</groupId>
            <artifactId>child1</artifactId>
            <version>${project.version}</version>
      </dependency>
  </dependencies>

install / depoy

执行install/deploy后,会将该模块的pom文件中的${revision}替换为实际的版本,每个模块下都会生成一个.flattened-pom.xml文件。

基于以上操作,每次版本号变更,只需要修改父模块POM文件中的revision即可。还可以用另一种动态添加参数的方式来指定版本:

mvn clean install -Drevision=1.0.0-SNAPSHOT  # -D代表设置环境变量

参考文章

maven-ci-friendly
flatten-maven-plugin
spring-boot-project
maven-relativepath
Maven多模块结构下版本管理的正确姿势

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/644458.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

Vue语法(4)

目录 1. 自定义指令 1.1 使用方法 1.2 实际案例 1.3 全局指令和局部指令 2. 组件对象 2.1 组件基础 2.2 组件对象 2.3 组件的属性——props 2.4 全局组件和局部组件 2.5 单文件组件 1. 概念&#xff1a; 2. 配置开发环境的指令&#xff1a; 3. 单文件组…

云迁移为业务赋能,跨出数字化转型第一步

新钛云服已累计为您分享752篇技术干货 云迁移如何赋能企业业务 随着科技的迅猛发展和数字化转型的浪潮席卷全球&#xff0c;越来越多的企业开始意识到云计算的重要性和潜力。在这个数字化时代&#xff0c;企业不再满足于传统的IT架构和数据中心&#xff0c;而是追求更高效、灵活…

《JAX可微分编程》包邮送书五本

文章目录 前言JAX到底是什么&#xff1f;书籍内容介绍包邮送书5本 前言 2015年&#xff0c;Google Brain开放了一个名为「TensorFlow」的研究项目&#xff0c;这款产品迅速流行并成为人工智能业界的主流深度学习框架&#xff0c;塑造了现代机器学习的生态系统。 7年后&#x…

Shell脚本文本三剑客之sed编辑器

目录 一、sed编辑器简介 二、sed工作流程 三、sed命令 四、sed命令的使用 1.sed打印文件内容&#xff08;p&#xff09; &#xff08;1&#xff09;打印文件所有行 &#xff08;2&#xff09;打印文件指定行 2.sed增加、插入、替换行&#xff08;a、i、c&#xff09; …

CVPR 2023 | 视频AIGC,预测/插帧/生成/编辑

1、A Dynamic Multi-Scale Voxel Flow Network for Video Prediction 视频预测&#xff08;video prediction&#xff09;的性能已经通过先进的深度神经网络大幅提高。然而&#xff0c;大多数当前的方法存在着大的模型尺寸和需要额外的输入&#xff08;如&#xff0c;语义/深度…

【Instruction Tuning】ChatGLM 微调实战(附源码)

在之前的文章中&#xff0c;我们已经讲过了 ChatGPT 的三个主要流程&#xff1a; SFT&#xff1a;通过 Instruction Tuning 来微调一个监督学习模型。Reward Model&#xff1a;通过排序序列来训练一个打分模型。Reinforcement Learning&#xff1a;通过强化学习来进一步优化模…

【MySQL新手入门系列一】:手把手教你入门MySQL

如果您是一位刚刚开始学习MySQL的新手&#xff0c;本文将为您提供一些实用的入门知识和技巧&#xff0c;帮助您快速上手。 本篇文章将以windows为例&#xff0c;介绍MySQL的基础知识&#xff0c;以及如何安装、卸载、配置和使用它。 导读 一、概览1.1 MySQL是什么1.2 为什么要学…

一文掌握linux网络相关命令

欢迎关注博主 Mindtechnist 或加入【Linux C/C/Python社区】一起学习和分享Linux、C、C、Python、Matlab&#xff0c;机器人运动控制、多机器人协作&#xff0c;智能优化算法&#xff0c;滤波估计、多传感器信息融合&#xff0c;机器学习&#xff0c;人工智能等相关领域的知识和…

阿里企业邮箱登录入口

阿里企业邮箱登录入口&#xff1a;https://qiye.aliyun.com/ 阿里企业邮箱可以使用邮箱账号登录&#xff0c;也可以使用钉钉账号登录&#xff0c;打开登录入口&#xff0c;如下图&#xff1a; 阿里企业邮箱登录入口 企业邮箱购买页面&#xff1a;aliyunbaike.com/go/mail免费企…

归并排序和快速排序(C++)

归并排序是一种经典的排序算法&#xff0c;也被称为“归并算法”。它的基本思想是将待排序数组分成若干个子数组&#xff0c;每个子数组都是有序的&#xff0c;然后将这些子数组合并成一个大的有序数组。 具体实现过程如下&#xff1a; 将待排序数组不断划分为左右两个子数组&…

IMX6ULL裸机篇之SPI实验-SPI主控代码实现

一. SPI 实验 SPI实验&#xff1a;学习如何使用 I.MX6U 的 SPI 接口来驱动 ICM-20608&#xff0c;读取 ICM-20608 的六轴数据。 本文学习 SPI主控芯片的代码编写。其中&#xff0c;包括SPI工作模式设置&#xff0c;主从模式设置&#xff0c;时钟配置等实现。 二. SPI 主控芯…

光学介质材料——光学膜

手机、平板、智能电视等设备之所以能够发光发亮离不开一个重要的组成材料——光学膜。那光学膜是什么回事呢&#xff1f; 光学膜是指在光学元件或独立基板上&#xff0c;制镀或涂布一层或多层介电质膜或金属膜或这两类膜的组合&#xff0c;以改变光波的传递特性&#xff0c;包…

MySQL索引:让你的数据库查询快到起飞!

&#x1f495;世界上最美好的东西之一&#xff0c;就是你每天都有机会开始全新的一天。&#x1f495; &#x1f43c;作者&#xff1a;不能再留遗憾了&#x1f43c; &#x1f386;专栏&#xff1a;MySQL学习&#x1f386; &#x1f697;本文章主要内容&#xff1a;详细介绍如何查…

SSD、内存和 L1 Cache 相比速度差多少倍

一道面试题&#xff1a;SSD、内存和 L1 Cache 相比速度差多少倍&#xff1f; 其实比起复杂的技术问题&#xff0c;我更喜欢在面试中提问这种像生活常识一样的简单问题。因为我觉得&#xff0c;复杂的问题是由简单的问题组成的&#xff0c;如果你把简单的问题学扎实了&#xff…

自动化运维工具—Ansible

一、Ansible概述 1.1 Ansible是什么 Ansible是一个基于Python开发的配置管理和应用部署工具&#xff0c;现在也在自动化管理领域大放异彩。它融合了众多老牌运维工具的优点&#xff0c;Pubbet和Saltstack能实现的功能&#xff0c;Ansible基本上都可以实现。 Ansible能批量配…

面试问题总结---嵌入式部分和项目部分

1、本栏用来记录社招找工作过程中的内容,包括基础知识学习以及面试问题的记录等,以便于后续个人回顾学习; 暂时只有2023年3月份,第一次社招找工作的过程; 2、个人经历: 研究生期间课题是SLAM在无人机上的应用,有接触SLAM、Linux、ROS、C/C++、DJI OSDK等; 3、参加工作后…

面试问题总结----ROS部分

1、本栏用来记录社招找工作过程中的内容,包括基础知识学习以及面试问题的记录等,以便于后续个人回顾学习; 暂时只有2023年3月份,第一次社招找工作的过程; 2、个人经历: 研究生期间课题是SLAM在无人机上的应用,有接触SLAM、Linux、ROS、C/C++、DJI OSDK等; 3、参加工作后…

Python3.9使用最新版pyinstaller将项目或程序打包成exe或者mac中的可执行文件

1、pyinstaller的说明&#xff1a; pyinstaller 能够在 Windows、Linux、Mac 等操作系统下将 Python 源文件打包&#xff0c;通过对源文件打包&#xff0c; Python 程序可以在没有安装 Python 的环境中运行&#xff0c;也可以作为一个独立文件方便传递和管理。 PyInstaller 支…

NLP-基于bertopic工具的新闻文本分析与挖掘

NLP-基于bertopic工具的新闻文本分析与挖掘 一&#xff0c;前言 最近简单接触了一些NLP的内容&#xff0c;练一下如何结合ChatGPT进行学习。 二&#xff0c;具体过程 &#xff08;1&#xff09;预处理文本&#xff0c;记录处理过程。 在使用Bertopic进行主题建模之前&…

【数据库一】MySQL数据库初体验

MySQL数据库初体验 1.数据库基本概念1.1 数据Data1.2 表1.3 数据库1.4 数据库管理系统1.5 数据库系统 2.数据库的发展3.主流的数据库介绍3.1 SQL Server&#xff08;微软公司产品&#xff09;3.2 Oracle &#xff08;甲骨文公司产品&#xff09;3.3 DB2&#xff08;IBM公司产品…