qileilove

maven的安裝配置

1.M2_HOME

前面講到設置M2_HOME環境變量指向maven的安裝目錄，本書之后所有使用M2_HOME的地方都指代了該安裝目錄。下面看一下該目錄的結構和內容：

bin

boot

conf

lib

LICENSE.txt

NOTICE.txt

README.txt

bin目錄:

該目錄包含了mvn運行的腳本，這些腳本用來配置java命令，準備好classpath和相關的java系統屬性，然后執行java命令。其中mvn是基于UNIX平臺的shell腳本，mvn.bat是基于windows平臺的bat腳本。在命令行輸入任何一條mvn命令時，實際上就是在調用這些腳本。該目錄還包含了mvnDebug和mvnDebug.bat兩個文件，同樣，前者是UNIX平臺的腳本，后者是windows平臺的腳本。那么mvn和mvnDebug有什么區別和關系呢？打開文件我們就可以看到，兩者基本是一樣的，只是mvnDebug多了一條MAVEN_DEBUG_OPTS配置，其作用就是在運行Maven時開啟debug，以便調試Maven本身。此外，該目錄還包含m2.conf文件，這是classworlds的配置文件，后面會介紹classworlds。

boot目錄:

該目錄只包含一個文件，以maven3為例，該文件為plexus-classworlds-xxx.jar。plexus-classworlds是一個類加載器框架，相對于默認的java類加載器，它提供了更豐富的語法以方便配置，maven使用該框架加載自己的類庫。

conf目錄：

該目錄包含了一個非常重要的文件settings.xml。直接修改該文件，就能在機器上全局地定制maven的行為。一般情況下，我們更偏向于復制該文件至~/.m2/目錄下(~表示用戶目錄)，然后修改該文件，在用戶范圍定制maven的行為。后面將會多次提到settings.xml，并分析其中的各個元素。 

lib目錄：

該目錄包含了所有maven運行時需要的java類庫，maven本身是分模塊開發的，因此用戶能看到諸如maven-core-3.0.jar,maven-model-3.0.jar之類的文件。此外，這里還包含一些maven用到的第三方依賴，如common-cli-1.2.jar,google-collection-1.0.jar等。對于maven2來說，該目錄只包含一個如maven-2.2.1-uber.jar的文件，原本各為獨立jar文件的maven模塊和第三方類庫都被拆解后重新合并到了這個jar文件中。可以說，lib目錄就是真正的maven。

---

2.~/.m2

在用戶目錄下可以發現.m2文件夾。默認情況下，該文件夾下放置了maven本地倉庫.m2/repository。所有的maven構件都被存儲到該倉庫中，以方便重用。默認情況下，~/.m2目錄下除了repository倉庫之外就沒有其他目錄和文件了，不過大多數maven用戶需要復制M2_HOME/conf/settings.xml文件到~/.m2/settings.xml,以便定制。

maven3實戰之設置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)。添加代理配置如下：

Xml代碼  

1. <settings>  
2.   ...  
3.   <proxies>  
4.     <proxy>  
5.       <id>my-proxy</id>  
6.       <active>true</active>  
7.       <protocol>http</protocol>  
8.       <host>218.14.227.197</host>  
9.       <port>3128</port>  
10.       <!--  
11.         <username>***</username>  
12.         <password>***</password>  
13.         <nonProxyHosts>  
14.           repository.mycom.com|*.google.com  
15.         </nonProxyHosts>  
16.       -->  
17.     </proxy>  
18.   </proxies>  
19.   ...  
20. </settings>  

這段配置十分簡單，proxies下可以有多個proxy元素，如果聲明了多個proxy元素，則默認情況下第一個被激活的proxy會生效。這里聲明了一個id為my-proxy的代理，active的值為true表示激活該代理，protocol表示使用的代理協議，這里是http。當然，最重要的是指定正確的主機名(host元素)和端口(port元素)。上述xml配置中注釋掉了username,password,nonProxyHosts幾個元素。當代理服務需要認證時，就需要配置username和password。nonProxyHost元素用來指定哪些主機不需要代理，可以使用"|"符號來分隔多個主機名。此外，該配置也支持通配符，如:*.google.com表示所有以google.com結尾的域名訪問都不要通過代理。

 2.5 安裝 maven eclipse 插件

1.工具下載： 
Eclipse4.2 jee版本（這里使用最新的Eclipse版本，3.7以上版本按照以下步驟都可以） 
下載地址：http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/juno/SR2/eclipse-jee-juno-SR2-win32.zip&mirror_id=1142 
Maven3.0.5版本下載地址： 
http://maven.apache.org/download.cgi 

2.maven配置 
maven下載后，需要配置環境變量，將maven解壓后的bin目錄配置到環境變量中，如下所示（我這里用的是3.0.4版本。并安裝在D盤根目錄下）： 

 

配置完成，可打開命令行，輸入mvn -v，如下圖所示（出現版本信息，即表示配置成功）： 

 

設置maven倉庫位置： 



默認的maven倉庫位置為：C:\Users\Administrator\.m2（其中Administrator為當前賬號）。 

3.eclipse安裝maven插件（由于eclipse安裝插件有版本問題，所以這里建議eclipse3.7以上版本）。 
maven插件下載地址（由于附件超過10M，所以放到百度網盤上了）： 
http://pan.baidu.com/share/link?shareid=370537&uk=3222190371 
只需要解壓后，把links、myplugins文件夾放到eclipse安裝目錄下，如下圖所示： 



并且修改links下的maven.link文件。指向myplugins目錄即可。我的配置為： 
path=D:/work/eclipse/eclipse4.2/myplugins/maven 

重啟eclipse（如果eclipse程序之前已啟動）。 

選擇Window-》Preferences-》選擇Maven，如下圖所示： 

 

選擇“Installations”，點擊“Add”添加maven目錄，如下圖所示： 

 

繼續選擇“User Settings”，配置maven的setting文件，如下圖所示： 

 

這里選擇maven安裝目錄下的conf/settings文件，如下圖所示： 

 

至此，maven插件已經安裝完成。 

4.查看maven的console： 
點擊“Window-》Show View-》Console”，如下圖所示： 

 
此時，eclipse的底部區域已經增加了Console的tab。需要切換到Maven的Console，如下圖所示： 



maven 配置
2.7。1 設置 maven_opts 變量

前面介紹Maven安裝目錄時我們了解到，運行mvn命令實際上是執行了Java命令，既然是運行Java，那么運行Java命令可用的參數當然也應該在運行mvn命令時可用。這個時候，MAVEN_OPTS環境變量就能派上用場。

通常需要設置MAVEN_OPTS的值為-Xms128m -Xmx512m，因為Java默認的最大可用內存往往不能夠滿足Maven運行的需要，比如在項目較大時，使用Maven生成項目站點需要占用大量的內存，如果沒有該配置，則很容易得到java.lang.OutOfMemeoryError。因此，一開始就配置該變量是推薦的做法。

關于如何設置環境變量，請參考前面設置M2_HOME環境變量的做法，盡量不要直接修改mvn.bat或者mvn這兩個Maven執行腳本文件。因為如果修改了腳本文件，升級Maven時就不得不再次修改，一來麻煩，二來容易忘記。同理，應該盡可能地不去修改任何Maven安裝目錄下的文件。

配置setting.xml

maven2 比起maven1 來說，需要配置的文件少多了，主要集中在pom.xml和settings.xml中。
    先來說說settings.xml，settings.xml對于maven來說相當于全局性的配置，用于所有的項目。在maven2中存在兩個 settings.xml，一個位于maven2的安裝目錄conf下面，作為全局性配置。對于團隊設置，保持一致的定義是關鍵，所以 maven2/conf下面的settings.xml就作為團隊共同的配置文件。保證所有的團隊成員都擁有相同的配置。當然對于每個成員，都需要特殊的 自定義設置，如用戶信息，所以另外一個settings.xml就作為本地配置。默認的位置為：${user.dir} /.m2/settings.xml目錄中（${user.dir} 指windows 中的用戶目錄）。
    settings.xml基本結構如下：
   

xml 代碼

 

1. <settings xmlns="http://maven.apache.org/POM/4.0.0"  
2.           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
3.           xsi:schemaLocation="http://maven.apache.org/POM/4.0.0  
4.                                http://maven.apache.org/xsd/settings-1.0.0.xsd">  
5.   <localRepository/>  
6.   <interactiveMode/>  
7.   <usePluginRegistry/>  
8.   <offline/>  
9.   <pluginGroups/>  
10.   <servers/>  
11.   <mirrors/>  
12.   <proxies/>  
13.   <profiles/>  
14.   <activeProfiles/>  
15. </settings>  

簡單介紹一下幾個主要的配置因素：
localRepository：表示本地庫的保存位置，也就是maven2主要的jar保存位置，默認在${user.dir}/.m2/repository，如果需要另外設置，就換成其他的路徑。
offline：如果不想每次編譯，都去查找遠程中心庫，那就設置為true。當然前提是你已經下載了必須的依賴包。
Servers
   在POM中的 distributionManagement元素定義了開發庫。然而，特定的username和pwd不能使用于pom.xml，所以通過此配置來保存server信息
 

xml 代碼

 

1. <servers>  
2.    <server>  
3.      <id>server001</id>  
4.      <username>my_login</username>  
5.      <password>my_password</password>  
6.      <privateKey>${usr.home}/.ssh/id_dsa</privateKey>  
7.      <passphrase>some_passphrase</passphrase>  
8.      <filePermissions>664</filePermissions>  
9.      <directoryPermissions>775</directoryPermissions>  
10.      <configuration></configuration>  
11.    </server>  
12.  </servers>   

• id:server 的id,用于匹配distributionManagement庫id，比較重要。
• username, password:用于登陸此服務器的用戶名和密碼
• privateKey, passphrase：設置private key，以及passphrase
• filePermissions, directoryPermissions：當庫文件或者目錄創建后，需要使用權限進行訪問。參照unix文件許可，如664和775

Mirrors 
表示鏡像庫，指定庫的鏡像，用于增加其他庫
 

xml 代碼

 

1. <mirrors>  
2.    <mirror>  
3.      <id>planetmirror.com</id>  
4.      <name>PlanetMirror Australia</name>  
5.      <url>http://downloads.planetmirror.com/pub/maven2</url>  
6.      <mirrorOf>central</mirrorOf>  
7.    </mirror>  
8.  </mirrors>  

• id,name:唯一的標志，用于區別鏡像
• url:鏡像的url
• mirrorOf：此鏡像指向的服務id

Proxies 
此設置，主要用于無法直接訪問中心的庫用戶配置。
 

xml 代碼

 

1. <proxies>  
2.    <proxy>  
3.      <id>myproxy</id>  
4.      <active>true</active>  
5.      <protocol>http</protocol>  
6.      <host>proxy.somewhere.com</host>  
7.      <port>8080</port>  
8.      <username>proxyuser</username>  
9.      <password>somepassword</password>  
10.      <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts>  
11.    </proxy>  
12.  </proxies>  

• id:代理的標志
• active：是否激活代理
• protocol, host, port:protocol://host:port 代理
• username, password：用戶名和密碼
• nonProxyHosts: 不需要代理的host

Profiles 
  類似于pom.xml中的profile元素，主要包括activation,repositories,pluginRepositories 和properties元素
  剛開始接觸的時候，可能會比較迷惑，其實這是maven2中比較強大的功能。從字面上來說，就是個性配置。
  單獨定義profile后，并不會生效，需要通過滿足條件來激活。
 repositories 和pluginRepositories 
 定義其他開發庫和插件開發庫。對于團隊來說，肯定有自己的開發庫。可以通過此配置來定義。
 如下的配置，定義了本地開發庫，用于release 發布。
   

xml 代碼

 

1. <repositories>  
2.         <repository>  
3.           <id>repo-local</id>  
4.        <name>Internal 開發庫</name>  
5.        <url>http://192.168.0.2:8082/repo-local</url>  
6.           <releases>  
7.             <enabled>true</enabled>  
8.             <updatePolicy>never</updatePolicy>  
9.             <checksumPolicy>warn</checksumPolicy>  
10.           </releases>  
11.           <snapshots>  
12.             <enabled>false</enabled>  
13.           </snapshots>  
14.           <layout>default</layout>  
15.         </repository>  
16.       </repositories>  
17.       <pluginRepositories>  
18.     <pluginRepository>  
19.     <id>repo-local</id>  
20.     <name>Internal 開發庫</name>  
21.     <url>http://192.168.0.2:8082/repo-local</url>  
22.     <releases>  
23.             <enabled>true</enabled>  
24.             <updatePolicy>never</updatePolicy>  
25.             <checksumPolicy>warn</checksumPolicy>  
26.     </releases>  
27.     <snapshots>  
28.     <enabled>false</enabled>  
29.     </snapshots>  
30.     <layout>default</layout>  
31.     </pluginRepository>  
32.     </pluginRepositories>  

releases, snapshots:每個產品的版本的Release或者snapshot(注：release和snapshot的區別，release一般是比較穩定的版本，而snapshot基本上不穩定，只是作為快照）

properties
  maven 的properties作為placeholder值，如ant的properties。
包括以下的5種類型值：

1. env.X，返回當前的環境變量
2. project.x:返回pom中定義的元素值，如project.version
3. settings.x：返回settings.xml中定義的元素
4. java 系統屬性：所有經過java.lang.System.getProperties()返回的值
5. x：用戶自己設定的值

Activation 
  用于激活此profile
 

xml 代碼

 

1. <activation>  
2.         <activeByDefault>false</activeByDefault>  
3.         <jdk>1.5</jdk>  
4.         <os>  
5.           <name>Windows XP</name>  
6.           <family>Windows</family>  
7.           <arch>x86</arch>  
8.           <version>5.1.2600</version>  
9.         </os>  
10.         <property>  
11.           <name>mavenVersion</name>  
12.           <value>2.0.3</value>  
13.         </property>  
14.         <file>  
15.           <exists>${basedir}/file2.properties</exists>  
16.           <missing>${basedir}/file1.properties</missing>  
17.         </file>  
18.       </activation>  

• jdk:如果匹配指定的jdk版本，將會激活
• os:操作系統
• property：如果maven能檢測到相應的屬性
• file: 用于判斷文件是否存在或者不存在

除了使用activation來激活profile，同樣可以通過activeProfiles來激活
Active Profiles
表示激活的profile,通過profile id來指定。
 

xml 代碼

 

1. <activeProfiles>  
2.     <activeProfile>env-test</activeProfile> 指定的profile id  
3.   </activeProfiles> 

posted on 2014-03-04 15:50 順其自然EVO 閱讀(9268) 評論(0)  編輯  收藏 所屬分類: maven