settings.xml對於maven來說相當於全局性的配置,用於所有的項目,當Maven運行過程中的各種配置,例如pom.xml,不想綁定到一個固定的project或者要分配給用戶時,我們使用settings.xml中的settings元素來確定這些配置。這包含了本地倉庫位置,遠程倉庫服務器以及認證信息等。
settings.xml存在於兩個地方:
1.安裝的地方:$M2_HOME/conf/settings.xml
2.用戶的目錄:${user.home}/.m2/settings.xml
前者又被叫做全局配置,后者被稱為用戶配置。如果兩者都存在,它們的內容將被合並,並且用戶范圍的配置優先。
平時配置時優先選擇用戶目錄的settings.xml
下面是settings下的頂層元素的一個概覽:
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> <localRepository/> <interactiveMode/> <usePluginRegistry/> <offline/> <pluginGroups/> <servers/> <mirrors/> <proxies/> <profiles/> <activeProfiles/> </settings>
settings的內容可以在下面這些地方篡改:
1.${user.home}和所有其他的系統屬性
2.${env.HOME}等環境變量
注意:settins.xml中profiles下定義的屬性不能被篡改。
簡單值
一半以上的頂級settings元素師簡單的值,代表了一直處於活躍的構建系統的元素的取值范圍。
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> <localRepository>${user.home}/.m2/repository</localRepository> <interactiveMode>true</interactiveMode> <usePluginRegistry>false</usePluginRegistry> <offline>false</offline> ... </settings>
localRepository:這個值是構建系統的本地倉庫的路徑。默認的值是${user.home}/.m2/repository.如果一個系統想讓所有登陸的用戶都用同一個本地倉庫的話,這個值是極其有用的。
interactiveMode:如果Maven要試圖與用戶交互來得到輸入就設置為true,否則就設置為false,默認為true。
usePluginRegistry:如果Maven使用${user.home}/.m2/plugin-registry.xml來管理plugin的版本,就設置為true,默認為false。
offline:如果構建系統要在離線模式下工作,設置為true,默認為false。如果構建服務器因為網絡故障或者安全問題不能與遠程倉庫相連,那么這個設置是非常有用的。
PluginGroups(插件組)
這個元素包含了一系列pluginGroup元素,每個又包含了一個groupId。當一個plugin被使用,而它的groupId沒有被提供的時候,這個列表將被搜索。這個列表自動的包含了org.apache.maven.plugins和org.codehaus.mojo。
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> ... <pluginGroups> <pluginGroup>org.mortbay.jetty</pluginGroup> </pluginGroups> ... </settings>
例如,有了上面的配置,Maven命令行可以使用簡單的命令執行org.morbay.jetty:jetty-maven-plugin:run,如下
mvn jetty run
Servers(服務器)
1. 定義jar包下載的Maven倉庫
2. 定義部署服務器
用來下載和部署的倉庫是用POM中的repositories和distributionManagement元素來定義的。但是某些配置例如username和password就不應該隨着pom.xml來分配了。這種類型的信息應該保存在構建服務器中的settings.xml中。
<servers> <server> <id>tomcat</id> <username>bruce</username> <password>password</password> </server> <server> <id>shiyue</id> <username>admin</username> <password>password</password> </server> </servers>
tomcat: 部署服務器
shiyue: Mave私服
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> ... <servers> <server> <id>server001</id> <username>my_login</username> <password>my_password</password> <privateKey>${user.home}/.ssh/id_dsa</privateKey> <passphrase>some_passphrase</passphrase> <filePermissions>664</filePermissions> <directoryPermissions>775</directoryPermissions> <configuration></configuration> </server> </servers> ... </settings>
id:這是Server的ID(不是登錄進來的user),與Maven想要連接上的repository/mirror中的id元素相匹配。
username,password:這兩個元素成對出現,表示連接這個server需要驗證username和password。
privateKey,passphrase:與前兩個元素一樣,這兩個成對出現,分別指向了一個私鑰(默認的是${user.home}/.ssh/id_dsa)和一個passphrase。passphrase和password元素可能在將來被客觀化,但是現在必須以文本形式在settings.xml中設置。
filePermissions,directoryPermissions:當一個倉庫文件或者目錄在部署階段被創建的時候,就必須用到權限許可。他們合法的值是三個數字,就像*nix中的文件權限,例如:664,775.
注意:如果你使用了一個私鑰來登錄server,那么password元素必須被省略,否則私鑰將被忽視。
密碼加密
一個新特征:服務器password和passphrase加密已經被升到2.1.0+
Mirrors(鏡像)
指定倉庫的地址,則默認從指定的鏡像下載jar包及插件
<mirrors> <mirror> <id>mirrorId</id> <mirrorOf>*</mirrorOf> <name>Human Readable Name for this Mirror.</name> <url>http://host:port/nexus-2.1.2/content/groups/public</url> </mirror> </mirrors>
id,name:唯一的鏡像標識和用戶友好的鏡像名稱。id被用來區分mirror元素,並且當連接時候被用來獲得相應的證書。
url:鏡像基本的URL,構建系統敬將使用這個URL來連接倉庫,而不是原來的倉庫URL。
mirrorOf:鏡像所包含的倉庫的Id。例如,指向Maven central倉庫的鏡像(http://repo1.maven.org/maven2/),設置這個元素為central。更多的高級映射例如repo1,repo2 或者*,!inhouse都是可以的。沒必要一定和mirror的id相匹配。
Proxies(代理)
有時候你所在的公司基於安全因素考慮,要求你使用通過安全認證的代理訪問因特網。這時就需要為Maven配置HTTP代理。
<proxies> <proxy> <id>optional</id> <active>true</active> <protocol>http</protocol> <username>proxyuser</username> <password>proxypass</password> <host>proxy.host.net</host> <port>80</port> <nonProxyHosts>local.net|some.host.com</nonProxyHosts> </proxy> </proxies>
id:proxy的唯一標識,用來區別proxy元素。
active:當proxy被激活的時候為true。當申明的代理很多的時候,這個很有用,但是同一時間僅有一個被激活。
protocol,host,port:代理地址protocol://host:port的分散形式。
username,password:兩個元素成對出現,提供連接proxy服務器時的認證。
nonProxyHosts:這里列出了不需要使用代理的hosts。列表的分隔符是proxy服務器想要的類型。上面例子使用了pipe分隔符,逗號分隔符也比較通用。
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> ... <proxies> <proxy> <id>myproxy</id> <active>true</active> <protocol>http</protocol> <host>proxy.somewhere.com</host> <port>8080</port> <username>proxyuser</username> <password>somepassword</password> <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts> </proxy> </proxies> ... </settings>
配置文件
settings.xml中的profile是pom.xml中的profile的簡潔形式。它包含了激活(activation),倉庫(repositories),插件倉庫(pluginRepositories)和屬性(properties)元素。profile元素僅包含這四個元素是因為他們涉及到整個的構建系統,而不是個別的POM配置。
如果settings中的profile被激活,那么它的值將重載POM或者profiles.xml中的任何相等ID的profiles。
激活(activation)
activations是profile的關鍵,就像POM中的profiles,profile的能力在於它在特定情況下可以修改一些值。而這些情況是通過activation來指定的。
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> ... <profiles> <profile> <id>test</id> <activation> <activeByDefault>false</activeByDefault> <jdk>1.5</jdk> <os> <name>Windows XP</name> <family>Windows</family> <arch>x86</arch> <version>5.1.2600</version> </os> <property> <name>mavenVersion</name> <value>2.0.3</value> </property> <file> <exists>${basedir}/file2.properties</exists> <missing>${basedir}/file1.properties</missing> </file> </activation> ... </profile> </profiles> ... </settings>
如果所有指定的條件都達到了,那么,activation就被觸發,而且不需要一次性全部達到。
jdk:在jdk元素中,activation有一個內建的,java版本檢測。如果檢測到jdk版本與期待的一樣,那么就激活。在上面的例子中,1.5.0_06是滿足的。
os:os元素可以定義一些上面所示的操作系統特定的屬性。
property:如果Maven檢測到相應的名值對的屬性,那么,這個profile將被激活。
file:如果給定的文件存在,或者不存在那么將激活這個profile。
activation並不是唯一激活profile的途徑。settings.xml中的activeProfile包含了profile的id。他們也可以通過命令行來顯式的激活,例如-P test。
如果你想查看在一個構建過程中有哪些profile會被激活。就使用maven-help-plugin
mvn help:active-profiles
屬性(properites)
Maven的屬性是值占位符,就像Ant中的屬性。如果X是一個屬性的話,那么它的值在POM中可以使用${X}來進行任意地方的訪問。他們來自於五種不同的風格,所有都可以從settings.xml文件中訪問到。
1.env.X:使用“env.”前綴將會返回當前的環境變量。例如${env.PATH}就是使用了$path環境變量。
2.project.X:一個點“.”分割的路徑,在POM中就是相關的元素的值。例如:<project><version>1.0</version></project>就可以通過${project.version}來訪問。
3.settings.X:一個點“.”分割的路徑,在settings.xml中就是相對應的元素的值,例如:<settings><offline>false</offline></settings>就可以通過${settings.offline}來訪問。
4.Java系統屬性:所有通過java.lang.System.getProperties()來訪問的屬性都可以像POM中的屬性一樣訪問,例如:${java.home}
5.X:被<properties/>或者外部文件定義的屬性,值可以這樣訪問${someVar}
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> ... <profiles> <profile> ... <properties> <user.install>${user.home}/our-project</user.install> </properties> ... </profile> </profiles> ... </settings>
如果這個profile被激活,那么屬性${user.install}就可以被訪問了。
倉庫(repositories)
倉庫是Maven用來構築構建系統的本地倉庫的遠程項目集合。它來自於被Maven叫做插件和依賴的本地倉庫。不同的遠程倉庫包含不同的項目,當profile被激活,他們就會需找匹配的release或者snapshot構件。
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> ... <profiles> <profile> ... <repositories> <repository> <id>codehausSnapshots</id> <name>Codehaus Snapshots</name> <releases> <enabled>false</enabled> <updatePolicy>always</updatePolicy> <checksumPolicy>warn</checksumPolicy> </releases> <snapshots> <enabled>true</enabled> <updatePolicy>never</updatePolicy> <checksumPolicy>fail</checksumPolicy> </snapshots> <url>http://snapshots.maven.codehaus.org/maven2</url> <layout>default</layout> </repository> </repositories> <pluginRepositories> ... </pluginRepositories> ... </profile> </profiles> ... </settings>
releases,snapshots:這是各種構件的策略,release或者snapshot。因了這兩個集合,POM可以在單個的倉庫中不依賴於另外一個的策略而改變當前策略。例如:一個人可能只下載snapshot用來開發。
enable:true或者false,來標記倉庫是否為各自的類型激活(release 或者 snapshot)。
updatePolicy:這個元素指明了更新的頻率。Maven會比較本地POM與遠程的時間戳。可選的項目為:always,daily,interval:X,nerver。
checksumPolicy:當Maven向倉庫部署文件的時候,它也部署了相應的校驗和文件。可選的為:ignore,fail,warn,或者不正確的校驗和。
layout:在上面描述倉庫的時候,我們提到他們有統一的布局。這完全正確。使用這個來表明它是default還是legacy。
插件倉庫(plugin repositories)
倉庫包含了兩種重要類型的構件。第一種是用來做其他構件依賴的構件,這是在中央倉庫中的大多數插件。另外一種類型的構件就是插件。Maven的插件本身就是一種特殊的構件。因此,插件倉庫被從其他倉庫中分離出來。無論怎么說,pluginRepositories元素模塊的結構與repositories模塊很相似。pluginRepository元素指向一個可以找到新插件的遠程地址。
激活配置(Active Profiles)
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> ... <activeProfiles> <activeProfile>env-test</activeProfile> </activeProfiles> </settings>
settings.xml最后一個謎題是activeProfiles元素。它包含一系列的activeProfile元素,每個都有一個profile id的值,任何profile id被定義到activeProfile的profile將被激活,不管其他的環境設置怎么樣。如果沒有匹配的profile被找到,那么就什么事情也不做。例如:如果env-test是一個activeProfile,一個在pom.xml或者profile.xml中的具有相應id的profile將被激活。如果沒有這樣的profile被找到,就什么事也不做,一切照常。
詳細注解
<?xml version="1.0" encoding="UTF-8"?> <settings xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> <!--本地倉庫。該值表示構建系統本地倉庫的路徑。其默認值為~/.m2/repository。 --> <localRepository>usr/local/maven</localRepository> <!--Maven是否需要和用戶交互以獲得輸入。如果Maven需要和用戶交互以獲得輸入,則設置成true,反之則應為false。默認為true。--> <interactiveMode>true</interactiveMode> <!--Maven是否需要使用plugin-registry.xml文件來管理插件版本。如果需要讓Maven使用文件~/.m2/plugin-registry.xml來管理插件版本,則設為true。默認為false。--> <usePluginRegistry>false</usePluginRegistry> <!--表示Maven是否需要在離線模式下運行。如果構建系統需要在離線模式下運行,則為true,默認為false。當由於網絡設置原因或者安全因素,構建服務器不能連接遠程倉庫的時候,該配置就十分有用。 --> <offline>false</offline> <!--當插件的組織Id(groupId)沒有顯式提供時,供搜尋插件組織Id(groupId)的列表。該元素包含一個pluginGroup元素列表,每個子元素包含了一個組織Id(groupId)。當我們使用某個插件,並且沒有在命令行為其提供組織Id(groupId)的時候,Maven就會使用該列表。默認情況下該列表包含了org.apache.maven.plugins。 --> <pluginGroups> <!--plugin的組織Id(groupId) --> <pluginGroup>org.codehaus.mojo</pluginGroup> </pluginGroups> <!--用來配置不同的代理,多代理profiles 可以應對筆記本或移動設備的工作環境:通過簡單的設置profile id就可以很容易的更換整個代理配置。 --> <proxies> <!--代理元素包含配置代理時需要的信息--> <proxy> <!--代理的唯一定義符,用來區分不同的代理元素。--> <id>myproxy</id> <!--該代理是否是激活的那個。true則激活代理。當我們聲明了一組代理,而某個時候只需要激活一個代理的時候,該元素就可以派上用處。 --> <active>true</active> <!--代理的協議。 協議://主機名:端口,分隔成離散的元素以方便配置。--> <protocol>http</protocol> <!--代理的主機名。協議://主機名:端口,分隔成離散的元素以方便配置。 --> <host>proxy.somewhere.com</host> <!--代理的端口。協議://主機名:端口,分隔成離散的元素以方便配置。 --> <port>8080</port> <!--代理的用戶名,用戶名和密碼表示代理服務器認證的登錄名和密碼。 --> <username>proxyuser</username> <!--代理的密碼,用戶名和密碼表示代理服務器認證的登錄名和密碼。 --> <password>somepassword</password> <!--不該被代理的主機名列表。該列表的分隔符由代理服務器指定;例子中使用了豎線分隔符,使用逗號分隔也很常見。--> <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts> </proxy> </proxies> <!--配置服務端的一些設置。一些設置如安全證書不應該和pom.xml一起分發。這種類型的信息應該存在於構建服務器上的settings.xml文件中。--> <servers> <!--服務器元素包含配置服務器時需要的信息 --> <server> <!--這是server的id(注意不是用戶登陸的id),該id與distributionManagement中repository元素的id相匹配。--> <id>server001</id> <!--鑒權用戶名。鑒權用戶名和鑒權密碼表示服務器認證所需要的登錄名和密碼。 --> <username>my_login</username> <!--鑒權密碼 。鑒權用戶名和鑒權密碼表示服務器認證所需要的登錄名和密碼。 --> <password>my_password</password> <!--鑒權時使用的私鑰位置。和前兩個元素類似,私鑰位置和私鑰密碼指定了一個私鑰的路徑(默認是/home/hudson/.ssh/id_dsa)以及如果需要的話,一個密語。將來passphrase和password元素可能會被提取到外部,但目前它們必須在settings.xml文件以純文本的形式聲明。 --> <privateKey>${usr.home}/.ssh/id_dsa</privateKey> <!--鑒權時使用的私鑰密碼。--> <passphrase>some_passphrase</passphrase> <!--文件被創建時的權限。如果在部署的時候會創建一個倉庫文件或者目錄,這時候就可以使用權限(permission)。這兩個元素合法的值是一個三位數字,其對應了unix文件系統的權限,如664,或者775。 --> <filePermissions>664</filePermissions> <!--目錄被創建時的權限。 --> <directoryPermissions>775</directoryPermissions> <!--傳輸層額外的配置項 --> <configuration></configuration> </server> </servers> <!--為倉庫列表配置的下載鏡像列表。 --> <mirrors> <!--給定倉庫的下載鏡像。 --> <mirror> <!--該鏡像的唯一標識符。id用來區分不同的mirror元素。 --> <id>planetmirror.com</id> <!--鏡像名稱 --> <name>PlanetMirror Australia</name> <!--該鏡像的URL。構建系統會優先考慮使用該URL,而非使用默認的服務器URL。 --> <url>http://downloads.planetmirror.com/pub/maven2</url> <!--被鏡像的服務器的id。例如,如果我們要設置了一個Maven中央倉庫(http://repo1.maven.org/maven2)的鏡像,就需要將該元素設置成central。這必須和中央倉庫的id central完全一致。--> <mirrorOf>central</mirrorOf> </mirror> </mirrors> <!--根據環境參數來調整構建配置的列表。settings.xml中的profile元素是pom.xml中profile元素的裁剪版本。它包含了id,activation, repositories, pluginRepositories和 properties元素。這里的profile元素只包含這五個子元素是因為這里只關心構建系統這個整體(這正是settings.xml文件的角色定位),而非單獨的項目對象模型設置。如果一個settings中的profile被激活,它的值會覆蓋任何其它定義在POM中或者profile.xml中的帶有相同id的profile。 --> <profiles> <!--根據環境參數來調整的構件的配置--> <profile> <!--該配置的唯一標識符。 --> <id>test</id> <!--自動觸發profile的條件邏輯。Activation是profile的開啟鑰匙。如POM中的profile一樣,profile的力量來自於它能夠在某些特定的環境中自動使用某些特定的值;這些環境通過activation元素指定。activation元素並不是激活profile的唯一方式。settings.xml文件中的activeProfile元素可以包含profile的id。profile也可以通過在命令行,使用-P標記和逗號分隔的列表來顯式的激活(如,-P test)。--> <activation> <!--profile默認是否激活的標識--> <activeByDefault>false</activeByDefault> <!--當匹配的jdk被檢測到,profile被激活。例如,1.4激活JDK1.4,1.4.0_2,而!1.4激活所有版本不是以1.4開頭的JDK。--> <jdk>1.5</jdk> <!--當匹配的操作系統屬性被檢測到,profile被激活。os元素可以定義一些操作系統相關的屬性。--> <os> <!--激活profile的操作系統的名字 --> <name>Windows XP</name> <!--激活profile的操作系統所屬家族(如 'windows') --> <family>Windows</family> <!--激活profile的操作系統體系結構 --> <arch>x86</arch> <!--激活profile的操作系統版本--> <version>5.1.2600</version> </os> <!--如果Maven檢測到某一個屬性(其值可以在POM中通過${名稱}引用),其擁有對應的名稱和值,Profile就會被激活。如果值字段是空的,那么存在屬性名稱字段就會激活profile,否則按區分大小寫方式匹配屬性值字段--> <property> <!--激活profile的屬性的名稱--> <name>mavenVersion</name> <!--激活profile的屬性的值 --> <value>2.0.3</value> </property> <!--提供一個文件名,通過檢測該文件的存在或不存在來激活profile。missing檢查文件是否存在,如果不存在則激活profile。另一方面,exists則會檢查文件是否存在,如果存在則激活profile。--> <file> <!--如果指定的文件存在,則激活profile。 --> <exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</exists> <!--如果指定的文件不存在,則激活profile。--> <missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</missing> </file> </activation> <!--對應profile的擴展屬性列表。Maven屬性和Ant中的屬性一樣,可以用來存放一些值。這些值可以在POM中的任何地方使用標記${X}來使用,這里X是指屬性的名稱。屬性有五種不同的形式,並且都能在settings.xml文件中訪問。 1. env.X: 在一個變量前加上"env."的前綴,會返回一個shell環境變量。例如,"env.PATH"指代了$path環境變量(在Windows上是%PATH%)。 2. project.x:指代了POM中對應的元素值。 3. settings.x: 指代了settings.xml中對應元素的值。 4. Java System Properties: 所有可通過java.lang.System.getProperties()訪問的屬性都能在POM中使用該形式訪問, 如/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0/jre。 5. x: 在<properties/>元素中,或者外部文件中設置,以${someVar}的形式使用。 --> <properties> <user.install>/ebs1/build-machine/usr/local/hudson/hudson-home/jobs/maven-guide-</user.install> </properties> <!--遠程倉庫列表,它是Maven用來填充構建系統本地倉庫所使用的一組遠程項目。 --> <repositories> <!--包含需要連接到遠程倉庫的信息 --> <repository> <!--遠程倉庫唯一標識--> <id>codehausSnapshots</id> <!--遠程倉庫名稱 --> <name>Codehaus Snapshots</name> <!--如何處理遠程倉庫里發布版本的下載--> <releases> <!--true或者false表示該倉庫是否為下載某種類型構件(發布版,快照版)開啟。 --> <enabled>false</enabled> <!--該元素指定更新發生的頻率。Maven會比較本地POM和遠程POM的時間戳。這里的選項是:always(一直),daily(默認,每日),interval:X(這里X是以分鍾為單位的時間間隔),或者never(從不)。 --> <updatePolicy>always</updatePolicy> <!--當Maven驗證構件校驗文件失敗時該怎么做-ignore(忽略),fail(失敗),或者warn(警告)。--> <checksumPolicy>warn</checksumPolicy> </releases> <!--如何處理遠程倉庫里快照版本的下載。有了releases和snapshots這兩組配置,POM就可以在每個單獨的倉庫中,為每種類型的構件采取不同的策略。例如,可能有人會決定只為開發目的開啟對快照版本下載的支持。參見repositories/repository/releases元素--> <snapshots> <enabled/><updatePolicy/><checksumPolicy/> </snapshots> <!--遠程倉庫URL,按protocol://hostname/path形式 --> <url>http://snapshots.maven.codehaus.org/maven2</url> <!--用於定位和排序構件的倉庫布局類型-可以是default(默認)或者legacy(遺留)。Maven 2為其倉庫提供了一個默認的布局;然而,Maven 1.x有一種不同的布局。我們可以使用該元素指定布局是default(默認)還是legacy(遺留)。 --> <layout>default</layout> </repository> </repositories> <!--發現插件的遠程倉庫列表。倉庫是兩種主要構件的家。第一種構件被用作其它構件的依賴。這是中央倉庫中存儲的大部分構件類型。另外一種構件類型是插件。Maven插件是一種特殊類型的構件。由於這個原因,插件倉庫獨立於其它倉庫。pluginRepositories元素的結構和repositories元素的結構類似。每個pluginRepository元素指定一個Maven可以用來尋找新插件的遠程地址。--> <pluginRepositories> <!--包含需要連接到遠程插件倉庫的信息.參見profiles/profile/repositories/repository元素的說明--> <pluginRepository> <releases> <enabled/><updatePolicy/><checksumPolicy/> </releases> <snapshots> <enabled/><updatePolicy/><checksumPolicy/> </snapshots> <id/><name/><url/><layout/> </pluginRepository> </pluginRepositories> <!--手動激活profiles的列表,按照profile被應用的順序定義activeProfile。 該元素包含了一組activeProfile元素,每個activeProfile都含有一個profile id。任何在activeProfile中定義的profile id,不論環境設置如何,其對應的 profile都會被激活。如果沒有匹配的profile,則什么都不會發生。例如,env-test是一個activeProfile,則在pom.xml(或者profile.xml)中對應id的profile會被激活。如果運行過程中找不到這樣一個profile,Maven則會像往常一樣運行。 --> <activeProfiles> <!-- --> <activeProfile>env-test</activeProfile> </activeProfiles> </profile> </profiles> </settings>