`
nanjingjiangbiao_T
  • 浏览: 2683257 次
  • 来自: 深圳
文章分类
社区版块
存档分类
最新评论

Maven的安装和配置

 
阅读更多
本章首先将介绍如何在主流的操作系统下安装Maven,并详细解释Maven的安装文件;其次还会介绍如何在主流的IDE中集成Maven,以及Maven安装的最佳实践。
2.1 在Windows上安装Maven
2.2 在基于Unix的系统上安装Maven
2.3 安装目录分析
2.4 设置HTTP代理
2.5 安装m2eclipse
2.6 安装NetBeans Maven插件
2.7 Maven安装最佳实践
2.8 小结

在安装Maven之前,首先要确认你已经正确安装了JDKMaven可以运行在JDK 1.4及以上的版本上。打开Windows的命令行,运行如下的命令来检查你的Java安装:echo %JAVA_HOME%。java -version。Windows安装Maven的步骤如下:

1、系统变量
中新建一个变量,变量名为
M2_HOME,变量值为Maven的安装目录。
2、
系统变量中找到一个名为Path的变量,在变量值的末尾加上%M2_HOME%\bin;
到此关于Maven的环境变量设置完成,即安装完成。在CMD下运行如下命令检查Maven的安装情况:echo %M2_HOME%。
mvn -v。
注:
Maven还比较年轻,更新比较频繁,因此用户往往会需要更新Maven安装以获得更多更酷的新特性,以及避免一些旧的bug

Linux安装Maven的步骤如下:需要检查JAVA_HOME环境变量以及Java命令: echo $JAVA_HOME。
java –version。
解压到本地目录:

juven@juven-ubuntu:bin$ tar -xvzf apache-maven-3.0-bin.tar.gz

现在已经创建好了一个Maven安装目录apache-maven-3.0,虽然直接使用该目录配置环境变量之后就能使用Maven了,但这里我更推荐做法是,在安装目录旁平行地创建一个符号链接,以方便日后的升级:

juven@juven-ubuntu:bin$ ln -s apache-maven-3.0 apache-maven
juven@juven-ubuntu:bin$ ls -l
total 4
lrwxrwxrwx 1 juven juven 18 2009-09-20 15:43 apache-maven -> apache-maven-3.0

drwxr-xr-x 6 juven juven 4096 2009-09-20 15:39 apache-maven-3.0

接下来,我们需要设置M2_HOME环境变量指向符号链接apache-maven-,并且把Maven安装目录下的bin/文件夹添加到系统环境变量PATH中去:

juven@juven-ubuntu:bin$ export M2_HOME=/home/juven/bin/apache-maven
juven@juven-ubuntu:bin$ export PATH=$PATH:$M2_HOME/bin

一般来说,需要将这两行命令加入到系统的登录shell脚本中去,以我现在的Ubuntu 8.10为例,编辑~/.bashrc文件,添加这两行命令。这样,每次启动一个终端,这些配置就能自动执行。

至此,安装完成,我们可以运行以下命令检查Maven安装:

juven@juven-ubuntu:bin$ echo $M2_HOME

juven@juven-ubuntu:bin$ mvn –version

注:在基于Unix的系统上,可以利用符号链接这一工具来简化Maven的升级,不必像在Windows上那样,每次升级都必须更新环境变量。解压Maven安装包到本地之后,平行地创建一个符号链接,然后在配置环境变量时引用该符号链接,这样做是为了方便升级。

安装目录分析

bin
boot
conf
lib
LICENSE.txt
NOTICE.txt
README.txt

  • Bin 该目录包含了mvn运行的脚本,这些脚本用来配置Java命令,准备好classpath和相关的Java系统属性,然后执行Java命令。其中mvn是基于UNIX平台的shell脚本,mvn.bat是基于Windows平台的bat脚本。在命令行输入任何一条mvn命令时,实际上就是在调用这些脚本。该目录还包含了mvnDebugmvnDebug.bat两个文件,同样,前者是UNIX平台的shell脚本,后者是windowsbat脚本。那么mvnmvnDebug有什么区别和关系呢?打开文件我们就可以看到,两者基本是一样的,只是mvnDebug多了一条MAVEN_DEBUG_OPTS配置,作用就是在运行Maven时开启debug,以便调试Maven本身。此外,该目录还包含m2.conf文件,这是classworlds的配置文件,稍微会介绍classworlds
  • Boot 该目录只包含一个文件,以maven 3.0为例,该文件为plexus-classworlds-2.2.3.jarplexus-classworlds是一个类加载器框架,相对于默认的java类加载器,它提供了更丰富的语法以方便配置,Maven使用该框架加载自己的类库。
  • Conf 该目录包含了一个非常重要的文件settings.xml。直接修改该文件,就能在机器上全局地定制Maven的行为。一般情况下,我们更偏向于复制该文件至~/.m2/目录下(这里~表示用户目录),然后修改该文件,在用户范围定制Maven的行为。本书的后面将会多次提到该settings.xml,并逐步分析其中的各个元素。
  • Lib 该目录包含了所有Maven运行时需要的Java类库,Maven本身是分模块开发的,因此用户能看到诸如mavn-core-3.0.jarmaven-model-3.0.jar之类的文件,此外这里还包含一些Maven用到的第三方依赖如common-cli-1.2.jargoogle-collection-1.0.jar等等。(对于Maven 2来说,该目录只包含一个如maven-2.2.1-uber.jar的文件原本各为独立JAR文件的Maven模块和第三方类库都被拆解后重新合并到了这个JAR文件中)。可以说,这个lib目录就是真正的Maven。关于该文件,还有一点值得一提的是,用户可以在这个目录中找到Maven内置的超级POM,这一点在8.5小节详细解释。其他: LICENSE.txt记录了Maven使用的软件许可证Apache License Version 2.0 NOTICE.txt记录了Maven包含的第三方软件;而README.txt则包含了Maven的简要介绍,包括安装需求及如何安装的简要指令等等。
.m2文件夹说明:

我们先运行一条简单的命令:mvn help:system。该命令会打印出所有的Java系统属性和环境变量,这些信息对我们日常的编程工作很有帮助。运行这条命令的目的是为了让Maven执行一个真正的任务。我们可以从命令行输出看到Maven会下载maven-help-plugin,包括pom文件和jar文件。这些文件都被下载到了Maven本地仓库中。

现在打开用户目录,我们可以发现.m2文件夹。默认情况下,该文件夹下放置了Maven本地仓库.m2/repository。所有的Maven构件(artifact)都被存储到该仓库中,以方便重用。我们可以到~/.m2/repository/org/apache/maven/plugins/maven-help-plugins/目录下找到刚才下载的maven-help-pluginpom文件和jar文件。Maven根据一套规则来确定任何一个构件在仓库中的位置。由于Maven仓库是通过简单文件系统透明地展示给Maven用户的,有些时候可以绕过Maven直接查看或修改仓库文件,在遇到疑难问题时,这往往十分有用。

注:默认情况下,~/.m2目录下除了repository仓库之外就没有其他目录和文件了,不过大多数Maven用户需要复制M2_HOME/conf/settings.xml文件到~/.m2/settings.xml。这是一条最佳实践。

设置HTTP代理

有时候你所在的公司由于安全因素考虑,要求你使用通过安全认证的代理访问因特网。这种情况下,就需要为Maven配置HTTP代理,才能让它正常访问外部仓库,以下载所需要的资源。首先确认自己无法直接访问公共的Maven中央仓库,直接运行命令ping repo1.maven.org可以检查网络。如果真的需要代理,先检查一下代理服务器是否畅通,比如现在有一个IP地址为218.14.227.197,端口为3128的代理服务,我们可以运行telnet 218.14.227.197 3128来检测该地址的该端口是否畅通。如果得到出错信息,需要先获取正确的代理服务信息;如果telnet连接正确,则输入ctrl+],然后q,回车,退出即可。

检查完毕之后,编辑~/.m2/settings.xml文件(如果没有该文件,则复制$M2_HOME/conf/settings.xml)。添加代理配置如下:

<settings>


<proxies>

<proxy>

<id>my-proxy</id>

<active>true</active>

<protocol>http</protocol>

<host>218.14.227.197</host>

<port>3128</port>

<!--

<username>***</username>

<password>***</password>

<nonProxyHosts>repository.mycom.com|*.google.com</nonProxyHosts>

-->

</proxy>

</proxies>


</settings>

这段配置十分简单,proxies下可以有多个proxy元素,如果你声明了多个proxy元素,则默认情况下第一个被激活的proxy会生效。这里声明了一个idmy-proxy的代理,active的值为true表示激活该代理,protocol表示使用的代理协议,这里是http。当然,最重要的是指定正确的主机名(host元素)和端口(port元素)。上述XML配置中我注释掉了usernamepasswordnonProxyHost几个元素,当你的代理服务需要认证时,就需要配置usernamepasswordnonProxyHost元素用来指定哪些主机名不需要代理,可以使用 | 符号来分隔多个主机名。此外,该配置也支持通配符,如*.google.com表示所有以google.com结尾的域名访问都不要通过代理。

安装m2eclipse插件

Eclipse是一款非常优秀的IDE。除了基本的语法标亮、代码补齐、XML编辑等基本功能外,最新版的Eclipse还能很好地支持重构,并且集成了JUnitCVSMylyn等各种流行工具。可惜Eclipse默认没有集成对Maven的支持。幸运的是,由Maven之父Jason Van Zyl创立的Sonatype公司建立了m2eclipse项目,这是Eclipse下的一款十分强大的Maven插件。现在我以Eclipse 3.6为例逐步讲解m2eclipse的安装。启动Eclipse之后,在菜单栏中选择Help,然后选择Install New Software…,接着你会看到一个Install对话框,点击Work with:字段边上的Add按钮,你会得到一个新的Add Repository对话框,在Name字段中输入m2eLocation字段中输入http://m2eclipse.sonatype.org/sites/m2e,然后点击OKEclipse会下载m2eclipse安装站点上的资源信息。等待资源载入完成之后,我们再将其全部展开,显示了m2eclipse的核心模块Maven Integration for Eclipse (Required),选择后点击Next >Eclipse会自动计算模块间依赖,然后给出一个将被安装的模块列表,确认无误后,继续点击Next >,这时我们会看到许可证信息,m2eclipse使用的开源许可证是Eclipse Public License v1.0,选择I accept the terms of the license agreements,然后点击Finish,接着就耐心等待Eclipse下载安装这些模块。

除了核心组件之外,m2eclipse还提供了一组额外组件,主要是为了方便与其它工具如Subversion进行集成,这些组件的安装地址为http://m2eclipse.sonatype.org/sites/m2e-extras。使用上面类似的安装方法。下面简单解释一下这些组件的用途:

1. 重要的

  • Maven SCM handler for Subclipse (Optional):Subversion是非常流行的版本管理工具,该模块能够帮助我们直接从Subversion服务器签出Maven项目,不过前提是需要首先安装Subclipsehttp://subclipse.tigris.org/)。
  • Maven SCM Integration (Optional):Eclipse环境中MavenSCM集成核心的模块,它利用各种SCM工具如SVN实现Maven项目的签出和具体化等操作。

2. 不重要的

  • Maven issue tracking configurator for Mylyn 3.x (Optional):该模块能够帮助我们使用POM中的缺陷跟踪系统信息连接Mylyn至服务器。
  • Maven SCM handler for Team/CVS (Optional):该模块帮助我们从CVS服务器签出Maven项目,如果你还在使用CVS,就需要安装它。
  • Maven Integration for WTP (Optional):使用该模块可以让Eclipse自动读取POM信息并配置WTP项目。、
  • M2eclipse Extensions Development Support (Optional):用来支持扩展m2eclipse,一般用户不会用到。
  • Project configurators for commonly used maven plugins (temporary):一个临时的组件,用来支持一些Maven插件与Eclipse的集成,建议安装。

读者可以根据自己的需要安装相应组件。 待安装完毕后,重启Eclipse,现在让我们验证一下m2eclipse是否正确安装了。首先,点击菜单栏中的Help,然后选择About Eclipse,在弹出的对话框中,点击Installation Details按钮,会得到一个对话框,在Installed Software标签栏中,检查刚才我们选择的模块是否在这个列表中。

Maven安装最佳实践


1、设置MAVEN_OPTS环境变量:运行mvn命令实际上是执行了Java命令,既然是运行Java,那么运行Java命令可用的参数当然也应该在运行mvn命令时可用。这个时候,MAVEN_OPTS环境变量就能派上用场。我们通常需要设置MAVEN_OPTS的值为:-Xms128m -Xmx512m,因为Java默认的最大可用内存往往不能够满足Maven运行的需要,比如在项目较大时,使用Maven生成项目站点需要占用大量的内存,如果没有该配置,我们很容易得到java.lang.OutOfMemeoryError。因此,一开始就配置该变量是推荐的做法。尽量不要直接修改mvn.bat或者mvn这两个Maven执行脚本文件。因为如果修改了脚本文件,升级Maven时你就不得不再次修改,一来麻烦,二来容易忘记。同理,我们应该尽可能地不去修改任何Maven安装目录下的文件。


2、配置用户范围settings.xml:Maven用户可以选择配置$M2_HOME/conf/settings.xml或者~/.m2/settings.xml。前者是全局范围的,整台机器上的所有用户都会直接受到该配置的影响,而后者是用户范围的,只有当前用户才会受到该配置的影响。我们推荐使用用户范围的settings.xml,主要原因是为了避免无意识地影响到系统中的其他用户。当然,如果你有切实的需求,需要统一系统中所有用户的settings.xml配置,当然应该使用全局范围的settings.xml。除了影响范围这一因素,配置用户范围settings.xml文件还便于Maven升级。直接修改conf目录下的settings.xml会导致Maven升级不便,每次升级到新版本的Maven,都需要复制settings.xml文件,如果使用~/.m2目录下的settings.xml,就不会影响到Maven安装文件,升级时就不需要触动settings.xml文件。


3、无论是Eclipse还是NetBeans,当我们集成Maven时,都会安装上一个内嵌的Maven,这个内嵌的Maven通常会比较新,但不一定很稳定,而且往往也会和我们在命令行使用的Maven不是同一个版本。这里有会出现两个潜在的问题:首先,较新版本的Maven存在很多不稳定因素,容易造成一些难以理解的问题;其次,除了IDE,我们也经常还会使用命令行的Maven,如果版本不一致,容易造成构建行为的不一致,这是我们所不希望看到的。因此,我们应该在IDE中配置Maven插件时使用与命令行一致的Maven。在m2eclipse环境中,点击菜单栏中的Windows,然后选择Preferences,在弹出的对话框中,展开左边的Maven项,选择Installation子项,在右边的面板中,我们能够看到有一个默认的Embedded Maven安装被选中了,点击Add…然后选择我们的Maven安装目录M2_HOME,添加完毕之后选择这一个外部的Maven即可。注:NetBeans Maven插件默认会侦测PATH环境变量,因此会直接使用与命令行一致的Maven环境。

分享到:
评论

相关推荐

    Maven安装和配置(超详细)

    Maven安装和配置(超详细)

    Maven安装和配置.doc

    #### 三、验证Maven配置 - 打开命令提示符或终端,输入 `mvn -version` 来检查Maven是否正确安装。 - 输入 `mvn help:system` 来查看Maven的系统信息,确认JDK版本和本地仓库的配置是否正确。 以上步骤详细介绍了...

    快速解决Maven安装和配置详细教程,解决你可能出现的问题Error JAVA-HOME not found in your

    【快速解决】Maven安装和配置详细教程,解决你可能出现的问题Error JAVA_HOME not found in your environment.Please set the JAVA_H.zip

    Maven安装与配置:Windows和Linux环境下的步骤

    Maven安装与配置:Windows和Linux环境下的步骤; Maven安装与配置:Windows和Linux环境下的步骤; Maven安装与配置:Windows和Linux环境下的步骤; Maven安装与配置:Windows和Linux环境下的步骤; Maven安装与配置...

    Maven安装与配置

    ### Maven安装与配置详解 #### 一、Maven简介 Maven是一款由Apache软件基金会支持的项目管理和理解工具。它可以帮助开发者自动构建Java项目,并管理项目的依赖关系。Maven使用XML格式来描述项目的构建规则,这使得...

    maven学校配置maven配置maven配置

    maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置maven配置...

    Maven安装配置外加Myeclipse上完美运行图解

    Maven 安装配置指南 本资源为 Maven 安装配置的详细指南,旨在帮助用户快速搭建 Maven 开发环境,并在 MyEclipse 中进行完美运行。以下是 Maven 安装配置的详细步骤: Step 1:下载 Maven 首先,需要下载 Maven ...

    Maven安装与配置的详细步骤

    【Maven安装与配置的详细步骤】 Maven是一款基于Java的开源项目管理工具,由Apache软件基金会开发。...了解并熟练掌握Maven的安装、配置和使用,对于Java开发者而言,是提高工作效率和协作能力的重要工具。

    maven 安装及配置讲解.docx

    以上是关于 Maven 安装和配置的基本内容。通过上述步骤,可以顺利完成 Maven 的安装,并对 `settings.xml` 文件的关键配置有所了解。这些操作是 Java 开发过程中不可或缺的一部分,对于提高开发效率、简化项目管理...

    超详细版图文Maven安装及配置

    ### Maven 安装及配置详解 ...通过以上步骤,您可以成功地在本地机器上安装和配置 Maven,并开始利用它来管理 Java 项目。Maven 的强大之处在于它可以极大地提高开发效率,简化项目的构建和管理流程。

    Maven安装配置说明

    将上述配置保存后,确保替换原有的Maven配置文件,以保证新配置生效。 #### Eclipse中Maven的配置 **2.1 打开Eclipse的首选项设置** - 在Eclipse中,选择`Window &gt; Preferences`打开首选项设置窗口。 **2.2 找到...

    Maven的安装、配置及使用入门

    在本章节中,我们将学习如何安装、配置和使用Maven。Maven是一个基于项目对象模型(Project Object Model,POM)的软件项目管理和构建自动化工具。它可以帮助开发者管理项目的构建、报告和文档。 1.1 在 Windows 上...

    maven安装与配置

    ### Maven安装与配置详解 #### 一、前置条件 在开始Maven的安装与配置之前,需要确保系统中已经正确安装了Java JDK,并且版本至少为1.7或更高。这是因为Maven自身依赖于JDK环境,特别是Maven 3.3及以后的版本均...

    maven安装和环境变量配置

    4. **校验Maven配置** - 在 Eclipse 中创建一个新的 Maven 项目或者导入已有的 Maven 项目,查看是否能够正常编译和运行。 #### 四、常见问题及解决方法 1. **Maven未被识别** 如果在命令行输入 `mvn -version`...

    maven 安装配置手册

    展示了如何创建和管理包含多个子项目的Maven项目,以及如何利用Maven的继承特性来共享配置和依赖。 **3.4 Web应用** 介绍了如何使用Maven来构建Web应用,包括Servlet的编写、J2EE依赖的添加、Web应用的打包和部署等...

    maven下载安装与配置.docx

    ### Maven 下载安装与配置详解 #### Maven简介 ...通过以上步骤,你应该已经成功在 Windows 上安装和配置了 Maven,并能够使用它管理和构建 Java 项目。这不仅提高了开发效率,还确保了项目的可维护性和扩展性。

    Maven安装与配置.zip

    maven安装与配置Maven 安装与配置 Maven 是一个强大的项目管理工具,主要用于 Java 项目,它能够帮助开发者管理项目 的构建、报告和文档。以下是 Maven 安装与配置的详细步骤,包括软件安装、环境配 置、运行方法及...

    Maven 安装与配置(csdn)————程序.pdf

    了解并掌握Maven的安装和基本配置是Java开发者的基本技能之一。随着对Maven的深入使用,你会发现它在构建、管理和部署项目方面带来的巨大便利,能够显著提高开发效率,减少维护成本。因此,花时间学习和熟悉Maven是...

Global site tag (gtag.js) - Google Analytics