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