Maven安装详细手册

1、Maven安装手册中科软科技股份有限公司2013年2月关于本文档主题Maven安装手册说明Maven安装手册适用对象中英网销项目人员修订历史版本章节类型日期作者说明1.1C2013-2-3未科说明：类型创建（C）、修改（C）、删除（D）、增加（A）；Maven安装手册1在Windows安装Maven41：检查JDK安装42：下载Maven53：本地安装54：升级Maven65：安装目录分析76：setting文件配置77：在Eclipse中安装m2eclipse11总结：14在Windows安装Maven1：检查JDK安装在安装Maven之前，首先要确认已安装JDK。Maven可以运行在JDK

2、1.4及以上的版本上。本书的所有样例都基于JDK5及以上版本。打开Windows的命令行，运行如下的命令来检查你的java安装：echo %JAVA_HOME%java -version结果如图所示：上述命令首先检查环境变量JAVA_HOME 是否指向了正确的JDK目录，接着尝试运行java命令。如果windows无法执行java命令，或者无法找到JAVA_HOME环境变量，你需要检查java是否安装了，或者环境变量是否设置正确。2：下载Maven访问Maven的下载页面：，其中包含针对不同平台的各种Maven下载文件。这里推荐使用Maven3.0，因此下载。Maven3基本完全兼容Maven

3、2，较之于Maven2它的性能更好，还有不少功能的改进。3：本地安装将安装文件解压到指定的目录中，例如：D:Program Filesmaven。Maven环境变量配置：打开系统属性面板（桌面上右键单击“我的电脑”à“属性”），点击高级系统设置，再点击环境变量，在系统变量中新建一个变量，变量名为M2_HOME，变量值为Maven的安装目录。点击确定，接着在系统变量中找到一个名为Path的变量，在变量的末尾加上：%M2_HOME%bin;，注意多个值之间需要有分号隔开，然后点击确定。至此，环境变量设置完成，详细情况如图所示：运行如下命令检查Maven的安装情况：echo %M2_HOM

4、E%mvn-v运行结果如图：echo %M2_HOME% 用来检查环境变量M2_HOME指定的Maven安装目录是否指正确的；mvn -v 执行maven命令，检查Maven的安装版本，确认maven是否可以正常使用。4：升级MavenMaven还比较年轻，更新比较频繁，因此用户往往会需要更新Maven安装以获取更酷的新特性，以避免一些旧的bug。在windows上更新Maven非常简便，只需要下载新的Maven安装文件，解压至本地目录，然后更新M2_HOME 环境变量便可。5：安装目录分析下图是maven的安装目录，我们来看一下该目录的结构和内容，并简单解释一下其作用。Bin: 该目录包含了

5、mvn运行的脚本，这些脚本用来配置java命令，准备好classpath和相关的java系统属性，然后执行java命令。Boot：该目录只包含了一个文件，以maven3.0为例，该文件为。该jar包是一个类加载器框架，相对于默认的java类加载器，它提供了更丰富的语法以方便配置，Maven使用该框架加载自己的类库。不必关系该文件。Conf：该目录包含了一个非常重要的文件。Setting.xml。直接修改该文件，就能在机器上全局地定制Maven的行为。Lib：该目录包含了所有的Maven运行时需要的Java类库。6：setting文件配置Setting.xml文件会有两个：1. 全局配置文件：m

6、aven安装目录的config下面,$M2_HOME/conf/settings.xml2. 系统当前用户配置文件：运行maven安装目录/bin下的mvn.bat后，在当前系统操作用户下生产的.m2文件夹下面。例如：WIN7系统C:Users%username%.m2XP系统C:Documents and Settings %username%.m2下。其中 %username% 为操作系统登录用户名将maven安装目录config文件夹下面的settings.xml文件拷贝至该目录。.m2 默认情况下，该文件夹下放置了Maven本地仓库.m2/repository。所有的Maven构件（a

7、rtifact）都被存储到仓库中，以方便重用。在这个文件夹下会有一个setting.xml文件，文件中重要节点说明：1. localRepository:配置本地的Repository路径，可以是绝对路径，通常写的是$user.home/.m2/repository例如：<localRepository>D:MavenRepository</localRepository>2. interactiveMode:是否希望maven与用户输入进行交互，true的话，maven就有可能与用户交互，默认是true3. pluginGroups4. Servers：Reposit

8、ories的详细定义在pom.xml的distributionManagement中。<!-Archiva server Config发布版-><server><id>archiva-internal</id><username>cmsapp</username><password>NiDaYe12</password></server><!-Archiva server Config快照版-><server><id>archiva-snapshots

9、</id><username>cmsapp</username><password>NiDaYe12</password></server>这里定义的id：与distributionManagement中的repository中的元素id对应，用于表示一个server用于服务器验证用户名和密码。5. 下图是镜像库的配置：镜像库：maven的mirror是镜像，而不是“分库”，表示的是当前一个mirror无法连接的时候，会去找后一个，类似于备份和容灾。用于从远程仓库中下载资源。具体的查询的时候，mirror也不是按setti

10、ng.xml写的那样的顺序来查询的。6. profilesactivation, repositories, pluginRepositories and properties elementsactivation指定激活这个profile。其他激活的方法：（1）setting.xml 可以通过activeProfile元素指定profile的id，来明确的激活这个profile。（2）在命令行上加上-p profile的id，也可以激活这个profile，其中可以通过“，”分开几个profile的id来指定多个。Repostitories包含

11、的repository指定依赖，它之前的activation如果符合激活条件的话就开启这个依赖pluginRepositories和properties如果activation符合激活条件，则他们将被激活。Profiles是Maven的一个很关键的术语：profile是用来定义一些在build lifecycle中使用的environmental variations（环境变量），profile可以设置成在不同的环境下激活不同的profile（例如：在不同的OS激活不同的profile，不同的JVM激活不同的profile，不同的database激活不同的profile等等）。你可以把prof

12、iles定义在4个地方如下：1:%M2_HOME%/conf/settings.xml，这是针对该部电脑的所有user的profiles，是global profiles，它会影响所有的 maven project build2：%user%/.m2/settings.xml，这是针对该账户下的profiles，是user级的profiles，它会影响当前user的所有的maven project build3:定义在pom.xml文件里面，这是仅针对该project的profiles，是project级的profiles4:profiles.xml，它和pom.xml在同一个目录下，也是pr

13、oject级的profiles，使用profiles.xml的目的是希望把profiles的设置从pom.xml里抽离出来设置。 小节总结：定义在这4个地方的profiles中，涉及范围越窄的profiles覆盖范围越宽的profiles。即：定义在pom.xml里profiles会覆盖profiles.xml的，profiles.xml的会覆盖%user%/.m2/settings.xml(账户下的settings.xml)的，%user%/.m2/settings.xml的会覆盖%M2_HOME%/conf/settings.xml（maven的安装文件下的settings.xml）的注意

14、：设置在pom.xml里的profiles是最最推荐的，因为pom.xml会被deploy到repository里。而settings.xml和profiles.xml里定义的profiles不会被deploy到repository,则有诸多限制，因此下面几个profiles能够在settings.xml和profiles.xml里定义：repositories、 pluginRepositories、properties。具体的实例请看中英网销settings.xml文件配置。中英网销settings.xml文件配置：7：在Eclipse中安装m2eclipse由于Eclipse中没有集成对

15、maven的支持，但是有m2eclipse项目中建立了强大的maven插件。现在开始，在Eclipse中安装maven。启动Eclipse之后，在菜单栏中选择Help，然后选择Install New Software，接着你会看到一个Install 对话框，看到该对话框之后，点击Add按钮。会得到一个新的Add Repository 对话框，在Name字段中输入m2e，Location字段中输入，然后点击OK。Eclipse 会下载m2Eclipse安装站点上的资源信息。等待资源载入完成之后，我们再将其全部展开，就能看到下图的界面：如图显示了m2eclipse的核心模块Maven Integr

16、ation for Eclipse(Required)，选择后点击Next>，Eclipse会自动计算模块间依赖，然后给出一个将被安装的模块列表，确认无误后，点击Next >，这时我们会看到许可证信息，m2eclipse使用的开源许可证是Eclipse Public License v1.0 ,选择I accept the terms of the license agreements，然后点击Finish，接着就耐性等待Eclipse下载安装这些模块，如图：如果一切没有问题，我们再检查一下Eclipse现在是否已经支持创建Maven项目，依次点击菜单栏中的File->New->Other，在弹出的对话框中，找到Maven一项，再将其展开，你应该能够看到如图所示的对话框：如果一切正常，说明m2eclipse已经正确安装了。最后，关于m2eclipse的安装，需要提醒的一点是，你可能会在使用m2eclipse时遇到类似这样的错误：这是因为Eclipse默认是运行在JRE上的，而m2eclipse的一些功能要求使用JDK，解决方法是配置Eclipse安装目录的eclipse.ini文件，添加vm配置指向JDK，如图：在m2eclipse 环境中，点击菜单栏中的W