maven之pom中的build标签

1、build标签分类

1.1、全局配置（project build）

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

<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">  ... <build>…</build> ...
</project> 

1.2、环境配置（profile build）

        针对不同的profile配置。

<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">  ... <profiles>  <profile>  <!– "Profile Build" contains a subset of "Project Build"s elements –>  <build>…</build>  </profile>  </profiles>  ...
</project>  

2、build 配置说明

2.1、基本元素

<build><!-- 指定默认的 Maven 构建目标。当运行 mvn 命令时，将执行指定的目标(用不到) --><defaultGoal>install</defaultGoal><!-- 指定 Maven 构建输出的目录路径,下列是默认值-->	<directory>target</directory>  <finalName>${artifactId}-${version}</finalName><!-- 指定源代码文件的目录路径 --><sourceDirectory>src/main/java</sourceDirectory><!-- 指定脚本文件的源代码目录路径(用不到) --><scriptSourceDirectory>src/main/scripts</scriptSourceDirectory><!-- 指定test的源代码目录路径 --><testSourceDirectory>src/test/java</testSourceDirectory><!-- 指定编译后的类文件输出的目录路径 --><outputDirectory>target/classes</outputDirectory><!-- 指定编译后的test类文件输出的目录路径 --><testOutputDirectory>target/test-classes</testOutputDirectory><!-- 配置项目的资源目录, 例如配置文件、静态资源等 --><resources><resource><directory>src/main/resources</directory><!-- 可以有占位符，并替换占位符，即下面的${application.environment} --><filtering>true</filtering><includes><include>bootstrap.properties</include><include>bootstrap-${application.environment}.properties</include></includes></resource><resource><directory>src/main/resources</directory><!-- 没有占位符 --><filtering>false</filtering><includes><include>banner.txt</include><include>logback-spring.xml</include></includes></resource></resources><!-- 配置项目的test资源目录, 例如配置文件、静态资源等 --><testResources><testResource><directory>src/test/resources</directory></testResource></testResources><filters>  <filter>filters/filter1.properties</filter>  </filters>  <!-- 插件版本管理 --><pluginManagement><plugins><!-- Springboot项目打包插件,生成JAR包 --><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><version>${spring-boot.version}</version></plugin><!-- Maven编译插件 --><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>${maven-compiler-plugin.version}</version></plugin></plugins></pluginManagement>...
</build>

• defaultGoal ：执行build任务时，如果没有指定目标，将使用的默认值。如上配置：在命令行中执行mvn，则相当于执行mvn install
• directory :  构建结果输出目录，默认在${basedir}/target目录。
• finalName ：build目标文件的名称，默认情况为${artifactId}-${version}
• sourceDirectory ：主体源程序存放目录，默认在${basedir}/src/main/java
• scriptSourceDirectory ：脚本源程序存放目录，默认在: ${basedir}/src/main/scripts
• testSourceDirectory ：测试源程序存放目录，默认在${basedir}/src/test/java
• outputDirectory ：主体源程序编译结果输出目录，默认在${basedir}/target/classes
• testOutputDirectory ：测试源程序编译结果输出目录，默认在${basedir}/target/test-classes
• resources ：主体资源文件存放目录，默认在: ${basedir}/src/main/resources
• testResources ：测试资源文件存放目录，默认在: ${basedir}/src/test/resources
• filters ：给出对资源文件进行过滤的属性文件的路径，默认位于${basedir}/src/main/filters/目录下。属性文件中定义若干键值对。在构建过程中，对于资源文件中出现的变量（键），将使用属性文件中该键对应的值替换。

2.2、Resources配置

<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>

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

• resources ：一个resources元素的列表。每一个都描述与项目关联的文件是什么和在哪里。
  • targetPath ：指定build后的resource存放的文件夹，默认是：${basedir}。通常被打包在jar中的resources的目标路径是META-INF
  • filtering ： 构建过程中是否对资源进行过滤，默认false。
  • directory ：定义resource文件所在的文件夹，默认为${basedir}/src/main/resources
  • includes ：指定哪些文件将被匹配，以*作为通配符。
  • excludes ：指定哪些文件将被忽略。
• testResources ：定义和resource类似，只不过在test时使用。

2.3、plugins配置 

<build>  ...  <plugins>  <!-- 插件的坐标。此处引用的 maven-compiler-plugin 插件不是第三方的，是一个 Maven 自带的插件。 --><plugin>  <groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.1</version> <extensions>false</extensions>  <inherited>true</inherited>  <!-- configuration 标签：配置 maven-compiler-plugin 插件 --><configuration><!-- 具体配置信息会因为插件不同、需求不同而有所差异 --><classifier>test</classifier>                <source>1.8</source><target>1.8</target><encoding>UTF-8</encoding><dependencies>...</dependencies>  <executions>  <execution>  <id>pre-process-classes</id>  <!-- phase : 关联的生命周期阶段 --><phase>compile</phase><!-- goals/goal：关联指定生命周期的目标 -->					<goals>  <goal>jar</goal>  </goals>  <configuration>  <classifier>pre-process</classifier>  </configuration>  </execution>  </executions>  </plugin>  </plugins>  
</build>  

 用于指定使用的插件：

• GAV（即: groupId、artifactId、version）：指定插件的标准坐标。
• extensions ：是否加载该插件的扩展，默认false。
• inherited ：该插件的configuration中的配置是否可以被（继承该POM的其他Maven项目）继承，默认true
• configuration ：该插件所需要的特殊配置，在父子项目之间可以覆盖或合并。
• dependencies ：该插件所特有的依赖类库。
• executions ：该插件的某个goal（一个插件中可能包含多个goal）的执行方式。一个execution有如下设置：
  • id ：唯一标识；
  • goals ：执行目标的名称；
  • phase ：execution标签要执行的Maven构建生命周期阶段.
  • inherited ：该execution是否可被子项目继承；
  • configuration ：该execution的其他配置参数；
  • profile：指定该execution标签在哪个profile中生效。

2.4.1、maven生命周期

详见：maven用久后必须了解的phase、goal参数及生命周期概念_maven goal参数-CSDN博客

• 生命周期有三种，分别是clean,default,site
• 每种生命周期都由多个阶段组成：
  • clean：默认是清除target目录中的所有文件，避免将历史版本打到新的包中造成一些不在预期中的问题。
  • process-resources：将资源文件src/main/resources下的文件复制到target/classes目录中。
  • compile：将src/main/java下的代码编译成 class 文件，也放到target/classes目录中。
  • process-test-resources：将资源文件src/test/resources下的文件复制到target/test-classes目录中。
  • test-compile：将src/test/java下的代码编译成 class 文件，也放到target/test-classes目录中。
  • test：运行单元测试并在target/surefire-reports中生成测试报告。
  • package：将资源文件、class文件、pom文件打包成一个jar包。
  • install：将生成的jar包推送到本地仓库中。
  • deploy：将生成的jar包推送到远程仓库中。
• 执行构建时，会按照阶段顺序从上到下的执行，但只有绑定了插件目标的阶段才会执行；

2.4、pluginManagement配置 

        通过 pluginManagement 标签管理起来的插件就像 dependencyManagement 一样，子工程使用时可以省略版本号，起到在父工程中统一管理版本的效果。

<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>  

       

pluginManagement标签存放着几个极少用到的插件：

• maven-antrun-plugin
• maven-assembly-plugin
• maven-dependency-plugin
• maven-release-plugin

 被springboot-dependenciens管理的插件:

<plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId>
</plugin>

  上面是父工程的pom配置，在子pom中，我们只需要做配置即可，不需要版本号： 

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