pom.xml中build标签

最新推荐文章于 2024-04-10 09:30:12 发布

转载最新推荐文章于 2024-04-10 09:30:12 发布 · 695 阅读

本文详细解析Maven项目的构建配置，包括全局配置与配置文件的差异，基本元素的解释，如defaultGoal、directory等，Resources与testResources的配置方式，plugins及pluginManagement的使用方法。

1.分类

（1）全局配置（project build）

针对整个项目的所有情况都有效

（2）配置（profile build）

针对不同的profile配置

[html] view plain copy

<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/maven-v4_0_0.xsd">
…
<!– "Project Build" contains more elements than just the BaseBuild set –>
<build>…</build>
<profiles>
<profile>
<!– "Profile Build" contains a subset of "Project Build"s elements –>
<build>…</build>
</profile>
</profiles>
</project>

2.配置说明

（1）基本元素

[html] view plain copy

<build>
<defaultGoal>install</defaultGoal>
<directory>${basedir}/target</directory>
<finalName>${artifactId}-${version}</finalName>
<filters>
<filter>filters/filter1.properties</filter>
</filters>
...
</build>

1）defaultGoal

执行build任务时，如果没有指定目标，将使用的默认值。

如上配置：在命令行中执行mvn，则相当于执行mvn install

2）directory
build目标文件的存放目录，默认在${basedir}/target目录

3）finalName

build目标文件的名称，默认情况为${artifactId}-${version}

4）filter

定义*.properties文件，包含一个properties列表，该列表会应用到支持filter的resources中。

也就是说，定义在filter的文件中的name=value键值对，会在build时代替${name}值应用到resources中。

maven的默认filter文件夹为${basedir}/src/main/filters

（2）Resources配置

用于包含或者排除某些资源文件

[html] view plain copy

<build>
...
<resources>
<resource>
<targetPath>META-INF/plexus</targetPath>
<filtering>false</filtering>
<directory>${basedir}/src/main/plexus</directory>
<includes>
<include>configuration.xml</include>
</includes>
<excludes>
<exclude>**/*.properties</exclude>
</excludes>
</resource>
</resources>
<testResources>
...
</testResources>
...
</build>

1）resources

一个resources元素的列表。每一个都描述与项目关联的文件是什么和在哪里

2）targetPath

指定build后的resource存放的文件夹，默认是basedir。

通常被打包在jar中的resources的目标路径是META-INF

3）filtering

true/false，表示为这个resource，filter是否激活
4）directory

定义resource文件所在的文件夹，默认为${basedir}/src/main/resources

5）includes

指定哪些文件将被匹配，以*作为通配符

6）excludes

指定哪些文件将被忽略

7）testResources

定义和resource类似，只不过在test时使用

（3）plugins配置

用于指定使用的插件

[html] view plain copy

<build>
...
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>2.0</version>
<extensions>false</extensions>
<inherited>true</inherited>
<configuration>
<classifier>test</classifier>
</configuration>
<dependencies>...</dependencies>
<executions>...</executions>
</plugin>
</plugins>
</build>

1）GAV

指定插件的标准坐标

2）extensions

是否加载plugin的extensions，默认为false

3）inherited

true/false，这个plugin是否应用到该pom的孩子pom，默认为true

4）configuration

配置该plugin期望得到的properties

5）dependencies

作为plugin的依赖

6）executions

plugin可以有多个目标，每一个目标都可以有一个分开的配置，可以将一个plugin绑定到不同的阶段

假如绑定antrun：run目标到verify阶段

[html] view plain copy

<build>
<plugins>
<plugin>
<artifactId>maven-antrun-plugin</artifactId>
<version>1.1</version>
<executions>
<execution>
<id>echodir</id>
<goals>
<goal>run</goal>
</goals>
<phase>verify</phase>
<inherited>false</inherited>
<configuration>
<tasks>
<echo>Build Dir: ${project.build.directory}</echo>
</tasks>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>

id：标识，用于和其他execution区分。当这个阶段执行时，它将以这个形式展示[plugin:goal execution: id]。在这里为： [antrun:run execution: echodir]
goals：目标列表

phase：目标执行的阶段

inherit：子类pom是否继承

configuration：在指定目标下的配置

（4）pluginManagement配置

pluginManagement的配置和plugins的配置是一样的，只是用于继承，使得可以在孩子pom中使用。

父pom：

[html] view plain copy

<build>
...
<pluginManagement>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>2.2</version>
<executions>
<execution>
<id>pre-process-classes</id>
<phase>compile</phase>
<goals>
<goal>jar</goal>
</goals>
<configuration>
<classifier>pre-process</classifier>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</pluginManagement>
...
</build>

则在子pom中，我们只需要配置：

[html] view plain copy

<build>
...
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
</plugin>
</plugins>
...
</build>

这样就大大简化了pom的配置

标签: maven