Maven安装是一个简单和直接的过程。本章将介绍如何使用Windows 7操作系统安装和设置Maven。您可以对其他操作系统执行相同的过程。
注意Maven是一个基于Java的应用程序,需要Java开发工具包(JDK)才能正常工作。 Maven版本3.2需要JDK 1.6或更高版本,3.0 / 3.1版本可以使用JDK 1.5或更高版本运行。在继续安装Maven之前,请确保已安装Java。如果没有,请从http://www.oracle.com/technetwork/java/javase/downloads/index.html安装JDK(不仅仅是Java运行时环境[JRE])。在本书中,我们将使用JDK 1.7。
您将从Apache Maven网站(http://maven.apache.org/download.html)下载最新版本的Maven开始安装过程。在撰写本文时,最新版本是3.2.3。下载Maven 3.2.3 binary .zip文件,如图2-1所示。
图2-1。 Maven下载页面
下载完成后,将发行版解压缩到计算机上的本地目录。它将创建一个名为apache-maven-3.2.3-bin的文件夹。本书假设您已将apache-maven-3.2.3-bin文件夹的内容放在c:\ tools \ maven目录下,如图2-2所示。
图2-2。 Maven安装位置
安装过程的下一步是添加指向Maven安装目录的M2_HOME环境变量,在我们的例子中为c:\ tools \ maven。启动“开始”菜单,然后右键单击“计算机”选项。接下来选择系统属性,然后选择高级系统设置。这将启动如图2-3所示的窗口。
图2-3。系统属性“窗口
单击环境变量按钮,然后单击系统变量下的新建。输入如图2-4所示的值,然后单击“确定”。
图2-4。 Maven Home系统变量
此过程的最后一步是修改路径环境变量,以便可以从命令行运行Maven命令。选择路径变量,然后单击编辑。在路径值的开始处添加%M2_HOME%/ bin,如图2-5所示。单击“确定”。这完成了Maven安装。如果您有任何打开的命令行窗口,请关闭它们并重新打开一个新的命令行窗口。添加或修改环境变量时,新值不会自动传播到打开的命令行窗口。
图2-5。将Maven Home添加到路径变量
MAVEN_OPTS环境变量
当使用Maven时,尤其是在一个复杂的项目中,你可能会遇到OutOfMemory错误。这可能发生,例如,当您运行大量的JUnit测试或当您生成大量报告时。要解决此错误,请增加Maven使用的Java虚拟机(JVM)的堆大小。这是通过创建一个名为MAVEN_OPTS的新环境变量在全局完成的。首先,我们建议使用值-Xmx512m。
测试安装
现在Maven已经安装,现在是测试和验证安装的时候了。打开命令提示符并运行以下命令:
mvn -v
此命令应输出类似于以下内容的信息:
C:\ Windows \ System32> mvn -vApache Maven 3.2.3(33f8c3e1027c3ddde99d3cdebad2656a31e8fdf4; 2014-08-11T14:58:10-06:00)Maven主页:c:\ tools \ mavenJava版本:1.7.0_25,供应商:Oracle CorporationJava home:C:\ Java \ jdk1.7.0_25 \ jreDefault locale:en_US,platform encoding:Cp1252OS name:“windows 7”,version:“6.1”,arch:“x86”
-v命令行选项指示Maven安装的路径以及它使用的Java版本。您也可以通过运行扩展命令mvn --version获得相同的结果。
获得帮助
您可以使用-h或--help选项获取Maven的命令行选项列表。运行以下命令将产生类似于图2-6所示的输出。
mvn -h
图2-6。运行Maven帮助命令的结果
其他设置
到目前为止,我们提供的安装步骤足以让您开始使用Maven。但是,对于大多数企业用途,您需要提供其他配置信息。此用户特定配置在位于c:\ Users \ << user_name >> \。m2文件夹中的settings.xml文件中提供。
注意.m2文件夹对于Maven的平滑操作很重要。在许多方面,这个文件夹包含一个settings.xml文件和一个存储库文件夹。存储库文件夹包含Maven需要的插件JAR文件和元数据。它还包含Maven从Internet下载的与项目相关的JAR文件。我们将在第3章仔细观察这个文件夹。
默认情况下,.m2文件夹位于主目录中。在Windows中,此目录通常为c:\ Users \ << your_user_name >>。 Maven自动创建.m2文件夹。如果您在计算机上没有看到此文件夹,请继续创建一个。
开箱即用的.m2文件夹不包含settings.xml文件。在本地计算机上的.m2文件夹中,创建一个settings.xml文件,并复制框架settings.xml文件的内容,如清单2-1所示。我们将在以后的章节中介绍这些元素中的一些。表2-1提供了元素的简要描述。
清单2-1。 Skeleton Settings.xml内容
表2-1。 settings.xml的元素的详细信息
元素名称 说明
localRepository
Maven在c:\ Users \ << your_user_name >> \。m2 \ repository文件夹中本地存储插件和依赖关系的副本。此元素可用于更改本地存储库的路径。例如,<localRepository> c:\ mavenrepo </ localRepository>会将存储库位置更改为mavenrepo文件夹。
interactiveMode
顾名思义,当此值设置为true时,默认值为Maven与用户进行交互以进行输入。
offline离线
当设置为true时,此配置指示Maven在离线模式下操作。默认值为false。
servers 服务器
Maven可以与各种服务器交互,例如Apache Subversion(SVN)服务器,构建服务器和远程存储库服务器。此元素允许您指定连接到这些服务器所需的安全凭证,例如用户名和密码。
mirrors 镜子
顾名思义,镜像允许您为存储库指定备用位置。
proxies 代理
代理包含连接到Internet所需的HTTP代理信息。
profiles 个人资料
配置文件允许您对某些配置元素(例如存储库和pluginRepositories)进行分组。
activeProfile
activeProfile允许您指定一个默认配置文件以使Maven可以使用。
设置代理
正如我们将在第3章中详细讨论的,Maven需要一个Internet连接来下载插件和依赖项。一些公司使用HTTP代理来限制对Internet的访问。在这些情况下,运行Maven将导致无法下载工件错误。要解决此问题,请编辑settings.xml文件并添加特定于您公司的代理信息。示例配置如清单2-2所示。
代码2-2。具有代理内容的Settings.xml
IDE支持
在本书中,我们将使用命令行创建和构建示例应用程序。 如果您有兴趣使用IDE,好消息是所有现代IDE都带有完整的Maven集成,无需任何进一步的配置。
概要
本章介绍如何在本地计算机上安装Maven。 您了解到Maven会下载其操作所需的插件和工件。 这些工件存储在.m2 \ repository文件夹中。 .m2文件夹还包含settings.xml文件,可用于配置Maven的行为。
在下一章中,我们将更深入地研究Maven的依赖管理。