Maven快速入门

一、概述

Apache Maven is a software project management and comprehension tool. Based on the concept of a project object model (POM), Maven can manage a project's build, reporting and documentation from a central piece of information.

Maven是一个软件项目管理的综合工具。它基于项目对象模型（POM）的概念，把所有的项目配置信息都定义在pom.xml文件中。通过配置文件，Maven可以管理项目的整个生命周期，包括构建、编译、测试、发布、报告等。

官网地址

二、下载和配置

1、下载

从Maven的官网下载与环境匹配的最新版本压缩包。下载之后无需安装，直接解压到指定目录。

下载地址

2、配置

解压缩之后，需要进行环境变量的设置。

3、验证

设置完环境变量之后，在命令行输入命令：mvn -version 验证是否安装成功。

4、添加本地仓库

进入Maven目录，打开conf目录下的settings.xml配置文件，添加本地仓库。这样，所有用户都可以共用这个仓库来构建项目。

三、约定

Maven遵循“约定优于配置”的原则进行配置。主要有如下约定：

• 源代码路径：src/main/java
• 资源文件路径：src/main/resource
• 测试代码路径：src/test
• 编译后文件路径：/target/classes
• 可发布的文件路径：/target

官网推荐的标准目录结构

四、创建项目

IntelliJ IDEA已经整合了Maven到IDE中，可以直接用来创建Maven项目。

如何在IntelliJ IDEA中使用Maven

五、pom.xml

Maven的核心是pom.xml，Maven通过这个配置文件完成各种各样的任务。在实际项目中，不必完全理解全部配置项目，可以只关注主要的配置信息。关于各配置项目的详细定义，可以参照官网的说明。

POM详细定义

1、配置文件

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

  <!-- The Basics -->
  <groupId>...</groupId>
  <artifactId>...</artifactId>
  <version>...</version>
  <packaging>...</packaging>
  <dependencies>...</dependencies>
  <parent>...</parent>
  <dependencyManagement>...</dependencyManagement>
  <modules>...</modules>
  <properties>...</properties>

  <!-- Build Settings -->
  <build>...</build>
  <reporting>...</reporting>

  <!-- More Project Information -->
  <name>...</name>
  <description>...</description>
  <url>...</url>
  <inceptionYear>...</inceptionYear>
  <licenses>...</licenses>
  <organization>...</organization>
  <developers>...</developers>
  <contributors>...</contributors>

  <!-- Environment Settings -->
  <issueManagement>...</issueManagement>
  <ciManagement>...</ciManagement>
  <mailingLists>...</mailingLists>
  <scm>...</scm>
  <prerequisites>...</prerequisites>
  <repositories>...</repositories>
  <pluginRepositories>...</pluginRepositories>
  <distributionManagement>...</distributionManagement>
  <profiles>...</profiles>
</project>

2、基本配置

• <groupId>表示组织标识
• <artifactId>表示项目名称
• <version>表示版本号
• <packaging>表示打包的格式
• <dependencies>表示依赖关系
• <parent>表示继承关系
• <dependencyManagement>用于管理依赖信息
• <modules>表示聚合关系
• <properties>表示值占位符，使用${X}访问，X代表属性

3、构建设置

• <build>处理声明项目目录结构、管理插件等
• <reporting>镜像构建元素

4、项目信息

• <name>表示项目名称
• <description>表示项目描述
• <url>表示项目URL
• <inceptionYear>表示项目开始年份
• <licenses>表示项目licenses
• <organization>表示项目组织
• <developers>表示项目开发人员
• <contributors>表示项目贡献者

5、环境设置

• <issueManagement>定义所用的缺陷跟踪系统
• <ciManagement>定义持续集成构建系统
• <mailingLists>定义邮件列表
• <scm>定义软件配置系统
• <prerequisites>定义前提条件
• <repositories>定义仓库
• <pluginRepositories>定义插件仓库
• <distributionManagement>定义分布式管理系统
• <profiles>定义相关设置

六、生命周期

• validate：验证工程是否正确，所有需要的资源是否可用
• compile：编译项目的源代码
• test：使用合适的单元测试框架测试已编译的源代码
• package：把已编译的代码打包成可发布的格式
• verify：运行所有检查，验证包是否有效
• install：把包安装在本地的仓库中
• deploy：在集成或者发布环境下执行，将包拷贝到远程仓库
• clean：清除之前构建的artifacts
• site：为项目生成文档站点

七、常用命令

• mvn archetype:create，创建Maven项目
• mvn compile，编译源代码，在目标目录下生成结果文件
• mvn test-compile，编译测试代码
• mvn test，运行单元测试
• mvn site，生成项目信息站点
• mvn clean，清楚目标目录下生成的结果文件
• mvn package，项目打包
• mvn install，将打包好的包安装到本地仓库
• cargo:deploy，部署到私有服务器

这些命令可以一起使用，但要注意命令的执行顺序：

clean compile package install