Maven - 构建生命周期、阶段、目标
版权所有,未经授权,禁止转载
章节
项目的构建通常包含数个相互独立的大块任务,可以独立执行,如生成文档,构建jar包等。单个任务的执行过程被称为一个构建生命周期,构建生命周期由一系列的构建阶段组成,每个阶段包含一系列的构建目标。
我们可以执行构建阶段或构建目标。阶段按顺序执行,执行一个阶段则会先执行该阶段之前的所有阶段。当执行构建阶段时,将会按顺序执行其中包含的所有构建目标。构建目标可以被分配到一个或多个构建阶段。我们还可以直接执行构建目标。
构建生命周期
如前所述,Maven构建遵循特定的生命周期来构建和部署项目。
Maven有3个内置的构建生命周期:
- default - 编译源代码并处理打包项目相关的所有事情
- clean - 清理构建输出,包括生成的编译类、JAR文件等
- site - 为项目生成文档
每一个构建生命周期都是独立执行的,可以让Maven同时执行多个构建生命周期,它们之间彼此独立,就像独立执行Maven命令一样。
构建阶段
每个构建生命周期包含一系列的构建阶段,每个构建阶段又包含了一系列的构建目标。
当执行一个构建阶段时,该阶段之前的所有阶段也将被执行。例如,执行install构建阶段,首先会执行该阶段之前的所有阶段,然后执行install阶段。
默认生命周期的作用是构建代码,是最重要的构建生命周期,它不能直接执行,要通过执行它的构建阶段或目标来执行。默认生命周期包含非常多的阶段及目标,其中常用的构建阶段是:
- validate 验证项目是正确的,所有必要信息都可用,所有依赖项都已下载。
- compile 编译项目源代码。
- test 使用适当的单元测试框架对编译后的源代码运行测试。
- package 将编译后的代码打包成可发布格式,例如JAR。
- install 将包安装到本地存储库中,以便在本地的其他项目中作为依赖项使用。
- deploy 将最终包复制到远程存储库,以便与其他开发人员和项目共享。
通过将阶段名称传递给mvn命令,可以执行一个构建阶段。
示例:
mvn install
这个例子执行项目的install阶段,首先会执行它之前的所有构建阶段,然后再执行install阶段。
如果标准的阶段和目标不能满足项目需要,还可以创建自定义构建插件来实现额外构建功能。
构建目标
每个构建阶段都包含一系列构建目标,当运行一个阶段时,所有绑定到这个阶段的目标都将按顺序执行。
构建目标本身属于一个插件,插件是构建目标的集合,也称为MOJO (Maven Old Java Object)。可以把插件理解为一个类,构建目标是类中的方法,构建阶段是是对这些方法的顺序调用。
构建目标可以绑定到多个构建阶段,也可以不绑定,就像类的方法可以被调用,也可以不被调用。
可以使用以下命令列出绑定到特定阶段的所有目标及其所属插件:
mvn help:describe -Dcmd=PHASENAME
例如,要列出所有绑定到编译阶段的目标:
mvn help:describe -Dcmd=compile
输出:
compile' is a phase corresponding to this plugin:
org.apache.maven.plugins:maven-compiler-plugin:3.1:compile
意思是编译器插件的编译目标被绑定到编译阶段。
构建目标可以被直接执行:
mvn [plugin-name]:[goal-name]
示例:
mvn dependency:copy-dependencies
项目构建常用命令
要构建Maven项目,我们需要通过执行其中一个阶段来运行某个生命周期:
mvn deploy
这将执行整个默认生命周期。有时,我们只需执行到安装阶段为止:
mvn install
但通常我们会用以下命令:
mvn clean install
在新构建之前,首先通过运行clean生命周期来清理项目。
我们也可以只运行某个特定目标:
mvn compiler:compile
注意,如果我们试图在没有指定阶段或目标的情况下构建Maven项目,将会导致以下错误:
[ERROR] No goals have been specified for this build. You must specify a valid lifecycle phase or a goal