Maven - 构建生命周期
什么是构建生命周期?
构建生命周期是一个明确定义的阶段序列,它定义了目标的执行顺序。 这里的阶段代表生命周期中的一个阶段。 例如,典型的 Maven 构建生命周期 由以下阶段序列组成。
阶段 | Handles | 说明 |
---|---|---|
prepare-resources | resource copying | 在此阶段可以自定义资源复制。 |
validate | Validating the information | 验证项目是否正确以及所有必要的信息是否可用。 |
compile | compilation | 源代码编译在此阶段完成。 |
Test | Testing | 测试适合测试框架的编译源代码。 |
package | packaging | 此阶段创建 POM.xml 中的打包中提到的 JAR/WAR 包。 |
install | installation | 此阶段将软件包安装在本地/远程 maven 存储库中。 |
Deploy | Deploying | 将最终包复制到远程存储库。 |
总是有 pre 和 post 阶段来注册 goals,它们必须在特定阶段之前或之后运行。
当 Maven 开始构建项目时,它会逐步执行定义的阶段序列并执行在每个阶段注册的目标。
Maven 具有以下三个标准生命周期 −
- clean
- default(or build)
- site
goal 表示有助于构建和管理项目的特定任务。 它可能绑定到零个或多个构建阶段。 未绑定到任何构建阶段的目标可以通过直接调用在构建生命周期之外执行。
执行顺序取决于调用目标和构建阶段的顺序。 例如,考虑下面的命令。 clean 和 package 参数是构建阶段,而 dependency:copy-dependencies 是一个目标。
mvn clean dependency:copy-dependencies package
这里首先会执行clean阶段,然后是dependency:copy-dependencies目标,最后会执行package阶段。
Clean 生命周期
当我们执行 mvn post-clean 命令时,Maven 会调用由以下阶段组成的 clean 生命周期。
- pre-clean
- clean
- post-clean
Maven clean 目标 (clean:clean) 绑定到 clean 生命周期中的 clean 阶段。 它的 clean:cleangoal 通过删除构建目录来删除构建的输出。 因此,当 mvn clean 命令执行时,Maven 会删除构建目录。
我们可以通过提及清洁生命周期的上述任何阶段的目标来自定义此行为。
在以下示例中,我们将 maven-antrun-plugin:run 目标附加到 pre-clean、clean 和 post-clean 阶段。 这将允许我们回显显示清洁生命周期阶段的文本消息。
我们在 C:\MVN\project 文件夹中创建了一个 pom.xml。
<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/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.companyname.projectgroup</groupId> <artifactId>project</artifactId> <version>1.0</version> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-antrun-plugin</artifactId> <version>1.1</version> <executions> <execution> <id>id.pre-clean</id> <phase>pre-clean</phase> <goals> <goal>run</goal> </goals> <configuration> <tasks> <echo>pre-clean phase</echo> </tasks> </configuration> </execution> <execution> <id>id.clean</id> <phase>clean</phase> <goals> <goal>run</goal> </goals> <configuration> <tasks> <echo>clean phase</echo> </tasks> </configuration> </execution> <execution> <id>id.post-clean</id> <phase>post-clean</phase> <goals> <goal>run</goal> </goals> <configuration> <tasks> <echo>post-clean phase</echo> </tasks> </configuration> </execution> </executions> </plugin> </plugins> </build> </project>
现在打开命令控制台,转到包含 pom.xml 的文件夹并执行以下 mvn 命令。
C:\MVN\project>mvn post-clean
Maven 将开始处理和显示清洁生命周期的所有阶段。
C:\MVN>mvn post-clean [INFO] Scanning for projects... [INFO] [INFO] ----------------< com.companyname.projectgroup:project >---------------- [INFO] Building project 1.0 [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-antrun-plugin:1.1:run (id.pre-clean) @ project --- [INFO] Executing tasks [echo] pre-clean phase [INFO] Executed tasks [INFO] [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ project --- [INFO] [INFO] --- maven-antrun-plugin:1.1:run (id.clean) @ project --- [INFO] Executing tasks [echo] clean phase [INFO] Executed tasks [INFO] [INFO] --- maven-antrun-plugin:1.1:run (id.post-clean) @ project --- [INFO] Executing tasks [echo] post-clean phase [INFO] Executed tasks [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 0.740 s [INFO] Finished at: 2021-12-10T20:03:53+05:30 [INFO] ------------------------------------------------------------------------ C:\MVN>
您可以尝试调整 mvn clean 命令,该命令将显示 pre-clean 和 clean。 post-clean 阶段不会执行任何操作。
默认(或构建)生命周期
这是 Maven 的主要生命周期,用于构建应用程序。 它有以下21个阶段。
序号 | 生命周期阶段 & 描述 |
---|---|
1 | validate 验证项目是否正确以及所有必要的信息是否可用于完成构建过程。 |
2 | initialize 初始化构建状态,例如设置属性。 |
3 | generate-sources 生成要包含在编译阶段的任何源代码。 |
4 | process-sources 处理源代码,例如过滤任何值。 |
5 | generate-resources 生成要包含在包中的资源。 |
6 | process-resources 将资源复制并处理到目标目录中,为打包阶段做好准备。 |
7 | compile 编译项目的源代码。 |
8 | process-classes 对编译生成的文件进行后处理,例如对 Java 类进行字节码增强/优化。 |
9 | generate-test-sources 生成要包含在编译阶段的任何测试源代码。 |
10 | process-test-sources 处理测试源代码,例如过滤任何值。 |
11 | test-compile 将测试源代码编译到测试目标目录中。 |
12 | process-test-classes 处理从测试代码文件编译生成的文件。 |
13 | test 使用合适的单元测试框架(Junit 就是其中之一)运行测试。 |
14 | prepare-package 在实际包装之前执行准备包装所需的任何操作。 |
15 | package 获取已编译的代码并将其打包成可分发的格式,例如 JAR、WAR 或 EAR 文件。 |
16 | pre-integration-test 在执行集成测试之前执行所需的操作。 例如,设置所需的环境。 |
17 | integration-test 如有必要,处理包并将其部署到可以运行集成测试的环境中。 |
18 | post-integration-test 执行集成测试后执行所需的操作。 例如,清理环境。 |
19 | verify 运行任何检查以验证包裹是否有效并符合质量标准。 |
20 | install 将包安装到本地仓库中,可以作为本地其他项目的依赖。 |
21 | deploy 将最终包复制到远程存储库,以便与其他开发人员和项目共享。 |
Maven Lifecycles相关的重要概念很少,值得一提 −
当通过 Maven 命令调用某个阶段时,例如 mvn compile,只有该阶段之前的阶段(包括该阶段)才会执行。
根据打包的类型(JAR / WAR / EAR),不同的 Maven 目标将绑定到 Maven 生命周期的不同阶段。
在以下示例中,我们将 maven-antrun-plugin:run 目标附加到构建生命周期的几个阶段。 这将允许我们回显显示生命周期阶段的文本消息。
我们更新了 C:\MVN\project 文件夹中的 pom.xml。
<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/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.companyname.projectgroup</groupId> <artifactId>project</artifactId> <version>1.0</version> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-antrun-plugin</artifactId> <version>1.1</version> <executions> <execution> <id>id.validate</id> <phase>validate</phase> <goals> <goal>run</goal> </goals> <configuration> <tasks> <echo>validate phase</echo> </tasks> </configuration> </execution> <execution> <id>id.compile</id> <phase>compile</phase> <goals> <goal>run</goal> </goals> <configuration> <tasks> <echo>compile phase</echo> </tasks> </configuration> </execution> <execution> <id>id.test</id> <phase>test</phase> <goals> <goal>run</goal> </goals> <configuration> <tasks> <echo>test phase</echo> </tasks> </configuration> </execution> <execution> <id>id.package</id> <phase>package</phase> <goals> <goal>run</goal> </goals> <configuration> <tasks> <echo>package phase</echo> </tasks> </configuration> </execution> <execution> <id>id.deploy</id> <phase>deploy</phase> <goals> <goal>run</goal> </goals> <configuration> <tasks> <echo>deploy phase</echo> </tasks> </configuration> </execution> </executions> </plugin> </plugins> </build> </project>
现在打开命令控制台,转到包含 pom.xml 的文件夹并执行以下 mvn 命令。
C:\MVN\project>mvn compile
Maven 将开始处理和显示构建生命周期的各个阶段,直到编译阶段。
C:\MVN>mvn compile [INFO] Scanning for projects... [INFO] [INFO] ----------------< com.companyname.projectgroup:project >---------------- [INFO] Building project 1.0 [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-antrun-plugin:1.1:run (id.validate) @ project --- [INFO] Executing tasks [echo] validate phase [INFO] Executed tasks [INFO] [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ project --- [WARNING] Using platform encoding (Cp1252 actually) to copy filtered resources, i.e. build is platform dependent! [INFO] skip non existing resourceDirectory C:\MVN\src\main\resources [INFO] [INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ project --- [INFO] No sources to compile [INFO] [INFO] --- maven-antrun-plugin:1.1:run (id.compile) @ project --- [INFO] Executing tasks [echo] compile phase [INFO] Executed tasks [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 3.033 s [INFO] Finished at: 2021-12-10T20:05:46+05:30 [INFO] ------------------------------------------------------------------------ C:\MVN>
网站生命周期
Maven Site 插件一般用于创建新鲜文档以创建报告、部署站点等。它有以下几个阶段 −
- pre-site
- site
- post-site
- site-deploy
在以下示例中,我们将 maven-antrun-plugin:run 目标附加到站点生命周期的所有阶段。 这将允许我们回显显示生命周期阶段的文本消息。
我们更新了 C:\MVN\project 文件夹中的 pom.xml。
<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/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.companyname.projectgroup</groupId> <artifactId>project</artifactId> <version>1.0</version> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-site-plugin</artifactId> <version>3.7</version> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-project-info-reports-plugin</artifactId> <version>2.9</version> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-antrun-plugin</artifactId> <version>1.1</version> <executions> <execution> <id>id.pre-site</id> <phase>pre-site</phase> <goals> <goal>run</goal> </goals> <configuration> <tasks> <echo>pre-site phase</echo> </tasks> </configuration> </execution> <execution> <id>id.site</id> <phase>site</phase> <goals> <goal>run</goal> </goals> <configuration> <tasks> <echo>site phase</echo> </tasks> </configuration> </execution> <execution> <id>id.post-site</id> <phase>post-site</phase> <goals> <goal>run</goal> </goals> <configuration> <tasks> <echo>post-site phase</echo> </tasks> </configuration> </execution> <execution> <id>id.site-deploy</id> <phase>site-deploy</phase> <goals> <goal>run</goal> </goals> <configuration> <tasks> <echo>site-deploy phase</echo> </tasks> </configuration> </execution> </executions> </plugin> </plugins> </build> </project>
现在打开命令控制台,转到包含 pom.xml 的文件夹并执行以下 mvn 命令。
C:\MVN\project>mvn site
Maven 将开始处理和显示站点生命周期的各个阶段,直到站点阶段。
C:\MVN>mvn site [INFO] Scanning for projects... [INFO] [INFO] ----------------< com.companyname.projectgroup:project >---------------- [INFO] Building project 1.0 [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-antrun-plugin:3.0.0:run (id.pre-site) @ project --- [INFO] Executing tasks [WARNING] [echo] pre-site phase [INFO] Executed tasks [INFO] [INFO] --- maven-site-plugin:3.7:site (default-site) @ project --- [WARNING] Input file encoding has not been set, using platform encoding Cp1252, i.e. build is platform dependent! [WARNING] No project URL defined - decoration links will not be relativized! [INFO] Rendering site with org.apache.maven.skins:maven-default-skin:jar:1.2 skin. [INFO] [INFO] --- maven-antrun-plugin:3.0.0:run (id.site) @ project --- [INFO] Executing tasks [WARNING] [echo] site phase [INFO] Executed tasks [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 4.323 s [INFO] Finished at: 2021-12-10T20:22:31+05:30 [INFO] ------------------------------------------------------------------------ C:\MVN>