一文搞懂Maven Wrapper

介绍

Maven Wrapper是受到Gradle Wrapper的启发而来的。它使Maven的一些配置 wrap 到项目里面,同时赋予了项目使用执行Maven版本的能力。

安装

  • 方式一:在项目根目录下执行:
mvn -N io.takari:maven:0.7.6:wrapper

执行后,会在项目跟路径下生成mvnw,mvnw.cmd两个文件 及一个 .mvn/wrapper 目录。

注:

  • 参数N(non-recursive)是指不在每个子模块中生成文件,只在当前目录下生成。
  • 此方式需要提前安装Maven
  • 方式二:从别的项目中将mvnw和mvnw.cmd文件以及.mvn目录copy过来

    copy过来后,执行任何mvnw命令都会先下载Maven环境。

maven环境都会下载到${home}/.m2/dist目录下。

如果需要修改Maven版本,只需要修改项目下的 .mvn/wrapper/maven-warper.properties文件即可:

distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.1/apache-maven-3.6.1-bin.zip

mvnw会在每次执行命令时检测${home}/.m2/wrapper/dists目录下是否有maven-wrapper.properties中指定Maven版本,如果没有就自动下载。

使用

和使用mvn指令一样,只需要将Maven命令中的mvn替换成./mvnw即可。例如以前运行的mvn clean,现在运行./mvnw clean就可以了。

windown系统下还可以使用 .\mvnw.\mvnw.cmd

Maven配置

通常我们都会使用自己的私服,还会将一些通用的profile配置到settings.xml文件中。
在使用maven wrapper时,settings.xml只有放在 ${home}/.m2/目录下才会起效。

jvm配置

在项目的.mvn/wrapper目录下增加 jvm.config文件,通过配置该文件指定maven执行时如何使用jvm。例如:

-Xmx4G -Xms2G -Duser.timezone=GMT+08

此功能一般用不上。

总结

站在Maven3发展多年后的今天,对一个企业内部研发团队来说,除了 可以不安装maven+不用配置path 能给研发提供帮助外,其他功能感觉意义不大。

  • 当升级Maven版本时,如果用户管理多个项目,可能就需要一个一个的修改maven版本
  • 对使用统一构建环境的场景,可能不适用。比如不同的maven版本可能使构建机的配置失效;另外,构建机可能不能访问外网等。

综上,如果要是用mvnw,建议只在研发本地使用,在统一的构建环境中仍使用mvn

上一篇:dubbo3 源码学习 编译报错的解决


下一篇:formatter-maven-plugin formatter validate问题