MAVEN使用最佳实践.docVIP

maven使用最佳实践 闫国玉 2009-10-26 本文档介绍一些在使用Maven过程中不是必须的，但十分有用的实践。 目录 1.1 设置MAVEN_OPTS环境变量 2 1.2 配置用户范围settings.xml 2 1.3 不要使用IDE内嵌的Maven 3 1.4 搭建内部仓库管理器 4 1.5 尽可能的遵循Maven的约定 5 1.6 优先编译被依赖的模块 5 1.7 利用Maven插件创建项目 5 设置MAVEN_OPTS环境变量 当Maven项目很大，或者你运行诸如 mvn site 这样的命令的时候，maven运行需要很大的内存，在默认配置下，就可能遇到java的堆溢出。解决的方法是调整java的堆大小的值。 找到文件%M2_HOME%\bin\mvn.bat ，这就是启动Maven的脚本文件，在该文件中你能看到有一行注释为： @REM set MAVEN_OPTS=-Xdebug -Xnoagent -Dpiler=NONE... 它的意思是你可以设置一些Maven参数，我们就在注释下面加入一行： set MAVEN_OPTS= -Xms128m -Xmx512m 之后，当你运行Maven命令如 mvn -version 的时候，你会看到如下的输出： E:\testmvn -version E:\testset MAVEN_OPTS= -Xms128m -Xmx512m Maven version: 2.0.9 Java version: 1.6.0_07 OS name: windows 2003 version: 5.2 arch: x86 Family: windows 我们看到，配置的Maven选项生效了，OutOfMemoryError也能得以相应的解决。 Linux环境中 也可以通过设置环境变量解决该问题， 如，编辑文件 /etc/profile 如下 MAVEN_OPTS=-Xmx512m export JAVA_HOME MAVEN_HOME MAVEN_OPTS JAVA_BIN PATH CLASSPATH 如果你使用Hudson 用 Hudson + Maven做持续集成，并不幸也遇到了类似的错误，那么上述两种方式都将不再起作用了，因为Hudson使用自己的maven-agent来启动Maven，不会去调用Maven的脚本，自然相应的配置也就无效了。 好在Hudson也给为我们提供了配置点，在Hudson的项目配置页面中，有一块Build区域，这里我们已经设置了Root Pom和Goals。注意该区域的右下角有一个Advanced...按钮，点击会看到MAVEN_OPTS输入框，这里输入-Xmx512m就 OK了。 m2eclipse中 类似以上的方法都会失效，所幸m2eclipse提供了配置点。步骤如下： 项目上右击 - Run As - Run Configurations - Maven Build 上右击 - New 这时会看到一个maven运行配置对话框，这里面其它的配置我不多解释了，为了解决内存溢出的问题，我们可以选择第二个TAB: JRE，然后在VM arguments中输入配置如：-Xms128m -Xmx512m。 配置用户范围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文件。 不要使用IDE内嵌的Maven 不论是Eclipse还是NetBeas，当我们集成Maven的时候，都会安装上一个内嵌的Maven，这个内嵌的Maven通常会比较新，但不一定很稳定，当然往往也会和我们在命令行使用的Maven不是同一个版本。这里又会出现两个潜在的问题，首先，较新版本的Maven存在很多不稳定因素，容易造成一些难以理解的问题。其次，由于除了IDE，我们也经常还会使用命