Maven
插件编写
构建模板
phase and goal
Introduction to the Build Lifecycle
一个lifecycle有多个phase,一个phase可以有多个goal
Mojo
三种内置的lifecycle:default、clean和site
列出所有的plugin、phase、id、goal
1 | mvn fr.jcgay.maven.plugins:buildplan-maven-plugin:list |
1 | # 打印插件的所有命令详情 |
1 | mvn clean install -DskipTests -Dfast -Drat.skip=true -Dhaoop.version=2.6.0-cdh5.15.1 -Pvendor-repos -Dinclude-hadoop -Dscala-2.11 -T2C |
1 | <plugin> |
shade
- 打包文件增加时间戳,并指定时间戳格式
- 排除代码路径与排除文件路径, 排除整个目录需要增加
**
1 | <maven.build.timestamp.format>yyyyMMdd-HHmmss</maven.build.timestamp.format> |
发布test jar
对那些有着良好设计,能够重复使用在项目的不同模块中、甚至不同项目中的测试代码,也需要打包成构件重复使用,从而减少编写测试代码的工作量。而 mvn package 只会对主代码和资源文件进行打包安装与部署,对测试代码和资源文件是不会处理的
发布
1 | <build> |
使用
maven-jar-plugin 有两个目标:一个是 jar;另一个是 test-jar。
jar 目标有内置绑定到 Maven 的 default 生命周期的 package 阶段,会在 Maven 工程进行构建的时候自动执行,将项目的主代码和资源文件进行打包。
test-jar 目标没有内置绑定,所以需要用户在插件配置中声明该目标,从而达到在 Maven 工程构建的时候将测试代码和资源文件打包。
test-jar 目标是默认绑定到 default 生命周期的 package 阶段,
所以当运行 mvn clean package 命令的时候,能同时将主代码和测试代码分别打包。
1 | <dependency> |
module-dependency-tree
https://github.com/ferstl/depgraph-maven-plugin
https://ferstl.github.io/depgraph-maven-plugin/plugin-info.html
https://ferstl.github.io/depgraph-maven-plugin/graph-mojo.html#graphFormat
1 | mvn com.github.ferstl:depgraph-maven-plugin:3.0.1:aggregate \ |
archetype
resources-filtered
在 Maven 项目中,resources-filtered 是一个配置选项,用于指示 Maven 是否应该对资源文件(如 *.properties 或 *.xml 文件)中的变量进行过滤和替换
资源过滤的作用
资源过滤的主要目的是允许开发者在构建过程中动态地替换资源文件中的占位符(例如 ${project.version})为实际的值。这在以下场景中非常有用:
- 版本管理:可以在资源文件中使用
${project.version}占位符,Maven 会在构建时自动将其替换为项目的实际版本号。 - 环境特定配置:可以为不同的部署环境(如开发、测试、生产)创建不同的配置文件,并在构建时选择合适的文件进行替换。
- 避免硬编码:通过使用占位符而不是硬编码的值,可以使项目更加灵活和可维护。
如何启用资源过滤
在 Maven 的 pom.xml 文件中,可以通过以下方式启用资源过滤:
1 | <build> |
在这个例子中,<filtering> 元素被设置为 true,表示 Maven 应该对 src/main/resources 目录下的所有资源文件进行过滤。
注意事项
- 资源过滤可能会导致构建过程中的性能开销,特别是在处理大量资源文件时。
- 如果资源文件中的某些内容不应该被过滤(例如,包含敏感信息的密码字段),可以使用 Maven 的
delimiters配置来指定自定义的分隔符,以避免不必要的替换。
样例
可以替换的属性,包含maven properties和git属性
1 | project.version=${project.version} |
















