标签:osi 就是 get des codehaus 版本 写法 plugins ref
Maven有3套相互独立的生命周期,用户可以调用某个生命周期的阶段,而不会对其他生命周期产生影响。
每个生命周期包含一些有先后顺序的阶段,后面的阶段依赖于前面的阶段,意味着用户调用后面的生命周期阶段时,同一生命周期中前面的阶段也将被执行。
mvn clean
调用clean生命周期的clean
阶段;
mvn test
调用default生命周期的test
阶段
Maven核心仅定义了抽象的生命周期,而具体的任务是交由具体的插件完成的。
每个目标通常对应了一个功能,插件目标常见的写法如:
dependency:tree
compiler:compile
surefire:test
冒号前面是插件前缀,冒号后面是插件目标。
Maven通过将生命周期的具体阶段与插件的目标绑定,完成具体的构建任务。
Maven核心为一些主要的生命阶段内置绑定了一些插件的目标,这就是为什么我们可以执行很多mvn
命令而无需指定具体的插件。
default
生命周期以packaging
元素为jar
类型为例:生命周期 | 阶段 | 插件目标 |
---|---|---|
clean | clean | maven-clean-plugin:clean |
site | site | maven-site-plugin:site |
site | site-deploy | maven-site-plugin:deploy |
default | process-resources | maven-resources-plugin:resources |
default | compile | maven-compiler-plugin:compile |
default | process-test-resources | maven-resources-plugin:test-resources |
default | test-compile | maven-compiler-plugin:test-compile |
default | test | maven-surefire-plugin:test |
default | package | maven-jar-plugin:jar |
default | install | maven-install-plugin:install |
default | deploy | maven-deploy-plugin:deploy |
因此我们在执行上述声明周期阶段时,缺省地就会执行相应插件的对应目标。
在build.plugins.plugin
元素中,通过executions.execution
元素进行一个自定义绑定:
示例:
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
<version>x.y.z</version>
<executions>
<execution>
<id>attach-sources</id>
<phase>verify</phase>
<goals>
<goal>jar-no-fork</goal>
</goals>
</execution>
</executions>
<plugin>
</plugins>
</build>
其中:
execution
元素配置执行一个任务,id
元素表示创建一个构建任务,给任务指定一个名称phase
元素将该任务绑定到具体的生命周期阶段,如上例中的default
生命周期的verify
阶段。下文将介绍该元素何时是可选的。goals
元素配置在该阶段要执行的插件目标,如上例中的jar-no-fork
很多插件在实现时,默认进行了绑定,通过maven-help-plugin
插件可以查看:
mvn help:describe -Dplugin=org.apache.maven.plugins:maven-source-plugin:x.y.z -Ddetail
其中jar-no-fork
目标相关的部分描述如下:
source:jar-no-fork
Description: This goal bundles all the sources into a jar archive. This
goal functions the same as the jar goal but does not fork the build and is
suitable for attaching to the build lifecycle.
Implementation: org.apache.maven.plugin.source.SourceJarNoForkMojo
Language: java
Bound to phase: package
该命令会显示指定插件的所有目标和具体的绑定。每个目标中的Bound to phase
就是该插件目标的默认绑定。
有了默认绑定,在自定义插件的绑定时,如果不指定phase
元素,就会在默认绑定的阶段执行对应的目标。
一些插件的目标参数支持命令行配置:
mvn clean install -Dmaven.test.skip=true
maven-surefire-plugin提供了maven.test.skip
参数,-D
是Java自带的,用来通过命令行设置Java系统属性,Maven重用了该参数,可以用来配置插件的参数。
POM中配置插件通过在插件配置中增加configuration
元素实现,该配置是对插件进行的全局配置,与命令行参数只对具体构建任务有效不同。
示例:
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
<version>x.y.z</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
<plugin>
</plugins>
</build>
也可以给具体的插件目标进行配置,具体是在execution
元素中添加configuration
元素,此时只对具体的插件目标生效。
使用目标前缀描述插件,如下,compiler
是maven-compiler-plugin
的目标前缀:
mvn help:describe -Dplugin=compiler
如果想查看具体目标的描述:
mvn help:describe -Dplugin=compiler -Dgoal=compile
如果想查看更详细的描述,可以加上-Ddetail
参数。
通过help插件可以描述插件的详细信息,详细信息中包含了插件的参数。
surefire:test
Description: Run tests using Surefire.
Implementation: org.apache.maven.plugin.surefire.SurefirePlugin
Language: java
Bound to phase: test
Available parameters:
...
skip (Default: false)
User property: maven.test.skip
Set this to 'true' to bypass unit tests entirely. Its use is NOT
RECOMMENDED, especially if you enable it using the 'maven.test.skip'
property, because maven.test.skip disables both running the tests and
compiling the tests. Consider using the skipTests parameter instead.
...
如该例中的skip
参数,用来跳过测试。然而实际在命令行中使用时,需要关注的是User property
属性,其中指定了用户实际使用时的键。
不是每个参数都有User property
属性,此时这些插件参数只能通过POM进行配置。
http://maven.apache.org/plugins/index.html
http://mojo.codehause.org/plugins.html
有的插件目标与具体的生命周期阶段绑定,通过命令行mvn
命令激活具体的生命周期阶段,即可执行绑定的插件目标。
有些插件目标并不适合绑定于具体的生命周期,Maven还支持直接从命令行调用插件命令:
mvn help:describe -Dplugin=compiler
mvn dependency:tree
它们分别对应了:
mvn org.apache.maven.plugins:maven-help-plugin:2.1:describe -Dplugin=compiler
mvn org.apache.maven.plugins:maven-dependency-plugin:2.1:tree
这里就引出了插件前缀这个概念,
help
是maven-help-plugin
的前缀,dependency
是maven-dependency-plugin
的前缀。
插件前缀与groupId:artifactId
是一一对应的,这种对应关系存储在仓库元数据中
http://repo1.maven.org/maven2/org/apache/maven/plugins
http://repository.codehaus.org/org/codehaus/mojo
下的maven-metadata.xml中, 列出了各个已定义的插件与前缀对应关系,这样,我们在命令行中就可以使用插件前缀来指代具体的插件了。
对于Maven官方插件(groupId
为org.apache.maven.plugins
),在POM中进行配置时可以省略groupId
这一行的配置。
Maven在超级POM中为所有核心插件设定了版本,超级POM是所有Maven项目的父POM,所有项目都继承这个超级父POM的配置。
因此,即使用户不加任何配置,核心插件的版本也已经确定了。
如果用户使用某个插件时没有指定版本,而这个插件又不属于核心插件范畴,Maven会去检查所有仓库中可用的版本并作出选择。
Maven 3在没有声明插件的版本时,使用稳定的发行版而不是快照版,相对于Maven 2更加稳定。
推荐在使用Maven插件时显式指定插件版本,避免不同构建时间存在使用不同的插件而带来构建不一致的问题。
标签:osi 就是 get des codehaus 版本 写法 plugins ref
原文地址:https://www.cnblogs.com/zyon/p/11294238.html