12. 使用Maven

文档描述Maven在Tigase项目中的使用

12.1. 在Windows中设置Maven

在Tigase，我们使用Apache Maven下载最新版本，编译导出代码，并在构建期间检查代码中的错误。本指南将介绍从 Windows操作环境安装和运行Maven。我们将在本指南中考虑Windows版本 7、8 和 8.1。因为Maven不附带安装程序，所以有一个手动安装过程，这对新用户来说可能有点令人生畏，但设置和使用相当简单。

12.1.1. 要求

Maven需要Java开发工具包(JDK) 6或更高版本。由于Tigase需要最新的JDK才能运行，这将满足我们的目的。如果您还没有安装它，请从此网站下载安装程序。安装JDK并重新启动计算机后，请确保已将 JAVA_HOME 变量输入到环境变量中，以便从命令行调用Java。
从这里下载Maven包并将其解压到您选择的目录中。对于本指南，我们将使用 C:\Maven\ 。

12.1.2. 设置环境变量

通过单击 System and Security > System > Advanced System Settings 从控制面板中调出环境变量面板。现在单击面板底部的按钮，将显示环境变量面板。

重要提示：更改这些设置可能会破坏操作系统中的其他功能。如果您不知道自己在做什么，请勿遵循本指南！

Env Panel

我们需要首先向系统变量添加两个变量路径，以说明Maven的安装位置。由于有些程序会查找M2_HOME，而其他程序会查找 MAVEN_HOME，因此只需添加两者并覆盖所有基础就更容易了。

点击新建…

Env New

对于名称，使用M2_HOME，对于变量，输入maven的路径，在本例中为

C:\Maven

使用MAVEN_HOME名称创建另一个新变量并添加相同的目录。 这些变量值只是指向您解压maven的位置，因此它们不必必须位于C目录中。

转到系统变量对话框并选择路径，然后单击编辑。 Path变量用分号隔开，找到Variable value字符串的结尾，在最后一项后添加以下内容：

;%M2_HOME%\bin;%MAVEN_HOME%\bin;

我们使用前面的变量名称周围的 %% 通配符添加了两个变量。

12.1.3. 测试Maven

现在我们必须测试命令行以确保一切都正确安装。通过在搜索中键入 cmd 或导航开始菜单来调出命令行。

在提示符下，您不需要更改目录，因为设置Path允许您引用它。输入以下命令：mvn -v

应该出现这样的信息

Apache Maven 3.3.3 (7994120775791599e205a5524ec3e0dfe41d4a06; 2015-04-22T04:57:3
7-07:00)
Maven home: C:\Maven
Java version: 1.8.0_45, vendor: Oracle Corporation
Java home: C:\Program Files\Java\jdk1.8.0_45\jre
Default locale: en_US, platform encoding: Cp1252
OS name: "windows 7", version: "6.1", arch: "amd64", family: "dos"

如果您看到此消息，则成功！您已完成安装并准备好使用Maven！如果没有，请返回您的设置并确保已安装JDK，并且正确设置了JAVA_HOME、M2_HOME和MAVEN_HOME变量。

12.2. 一个非常简短的Maven指南

如果你根本不使用 Maven 或者每年使用一次，你可能会发现文档是一个有用的maven命令提醒：

12.2.1. 快照编译和快照包生成

mvn compile - 快照包的编译
mvn package - 创建快照jar文件
mvn install - 安装在本地存储库快照jar文件中
mvn deploy - 部署到远程仓库快照jar文件

12.2.2. 发布编译，生成

mvn release:prepare 为新版本发布准备项目
mvn release:perform 执行新版本的发布生成

12.2.3. 仅使用源生成tar.gz、tar.bz2文件

mvn -DdescriptorId=src assembly:assembly

当您的命令行位于带有pom.xml文件的目录中时，这些命令中的任何一个都将起作用。该文件将指示Maven将做什么。

12.2.4. 配置

Maven使用带有 -P 开关的配置文件来告诉编译和构建什么。 Tigase使用两种不同的配置文件：

-Pdist - 创建分发档案
-Pdoc - 创建文档