這是setting.xml的詳細(xì)解析

<?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"> ?

?<!--本地倉(cāng)庫(kù)。該值表示構(gòu)建系統(tǒng)本地倉(cāng)庫(kù)的路徑。其默認(rèn)值為~/.m2/repository。 --> ?

?<localRepository>usr/local/maven</localRepository> ?

?<!--Maven是否需要和用戶交互以獲得輸入。如果Maven需要和用戶交互以獲得輸入，則設(shè)置成true，反之則應(yīng)為false。默認(rèn)為true。--> ?

?<interactiveMode>true</interactiveMode> ?

?<!--Maven是否需要使用plugin-registry.xml文件來管理插件版本。如果需要讓Maven使用文件~/.m2/plugin-registry.xml來管理插件版本，則設(shè)為true。默認(rèn)為false。--> ?

?<usePluginRegistry>false</usePluginRegistry> ?

?<!--表示Maven是否需要在離線模式下運(yùn)行。如果構(gòu)建系統(tǒng)需要在離線模式下運(yùn)行，則為true，默認(rèn)為false。當(dāng)由于網(wǎng)絡(luò)設(shè)置原因或者安全因素，構(gòu)建服務(wù)器不能連接遠(yuǎn)程倉(cāng)庫(kù)的時(shí)候，該配置就十分有用。 --> ?

?<offline>false</offline> ?

?<!--當(dāng)插件的組織Id（groupId）沒有顯式提供時(shí)，供搜尋插件組織Id（groupId）的列表。該元素包含一個(gè)pluginGroup元素列表，每個(gè)子元素包含了一個(gè)組織Id（groupId）。當(dāng)我們使用某個(gè)插件，并且沒有在命令行為其提供組織Id（groupId）的時(shí)候，Maven就會(huì)使用該列表。默認(rèn)情況下該列表包含了org.apache.maven.plugins。 --> ?

?<pluginGroups> ?

? <!--plugin的組織Id（groupId） --> ?

? <pluginGroup>org.codehaus.mojo</pluginGroup> ?

?</pluginGroups> ?

?<!--用來配置不同的代理，多代理profiles 可以應(yīng)對(duì)筆記本或移動(dòng)設(shè)備的工作環(huán)境：通過簡(jiǎn)單的設(shè)置profile id就可以很容易的更換整個(gè)代理配置。 --> ?

?<proxies> ?

? <!--代理元素包含配置代理時(shí)需要的信息--> ?

? <proxy> ?

? ?<!--代理的唯一定義符，用來區(qū)分不同的代理元素。--> ?

? ?<id>myproxy</id> ?

? ?<!--該代理是否是激活的那個(gè)。true則激活代理。當(dāng)我們聲明了一組代理，而某個(gè)時(shí)候只需要激活一個(gè)代理的時(shí)候，該元素就可以派上用處。 --> ?

? ?<active>true</active> ?

? ?<!--代理的協(xié)議。 協(xié)議://主機(jī)名:端口，分隔成離散的元素以方便配置。--> ?

? ?<protocol>http</protocol> ?

? ?<!--代理的主機(jī)名。協(xié)議://主機(jī)名:端口，分隔成離散的元素以方便配置。 ?--> ?

? ?<host>proxy.somewhere.com</host> ?

? ?<!--代理的端口。協(xié)議://主機(jī)名:端口，分隔成離散的元素以方便配置。 --> ?

? ?<port>8080</port> ?

? ?<!--代理的用戶名，用戶名和密碼表示代理服務(wù)器認(rèn)證的登錄名和密碼。 --> ?

? ?<username>proxyuser</username> ?

? ?<!--代理的密碼，用戶名和密碼表示代理服務(wù)器認(rèn)證的登錄名和密碼。 --> ?

? ?<password>somepassword</password> ?

? ?<!--不該被代理的主機(jī)名列表。該列表的分隔符由代理服務(wù)器指定；例子中使用了豎線分隔符，使用逗號(hào)分隔也很常見。--> ?

? ?<nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts> ?

? </proxy> ?

?</proxies> ?

?<!--配置服務(wù)端的一些設(shè)置。一些設(shè)置如安全證書不應(yīng)該和pom.xml一起分發(fā)。這種類型的信息應(yīng)該存在于構(gòu)建服務(wù)器上的settings.xml文件中。--> ?

?<servers> ?

? <!--服務(wù)器元素包含配置服務(wù)器時(shí)需要的信息 --> ?

? <server> ?

? ?<!--這是server的id（注意不是用戶登陸的id），該id與distributionManagement中repository元素的id相匹配。--> ?

? ?<id>server001</id> ?

? ?<!--鑒權(quán)用戶名。鑒權(quán)用戶名和鑒權(quán)密碼表示服務(wù)器認(rèn)證所需要的登錄名和密碼。 --> ?

? ?<username>my_login</username> ?

? ?<!--鑒權(quán)密碼 。鑒權(quán)用戶名和鑒權(quán)密碼表示服務(wù)器認(rèn)證所需要的登錄名和密碼。 --> ?

? ?<password>my_password</password> ?

? ?<!--鑒權(quán)時(shí)使用的私鑰位置。和前兩個(gè)元素類似，私鑰位置和私鑰密碼指定了一個(gè)私鑰的路徑（默認(rèn)是/home/hudson/.ssh/id_dsa）以及如果需要的話，一個(gè)密語。將來passphrase和password元素可能會(huì)被提取到外部，但目前它們必須在settings.xml文件以純文本的形式聲明。 --> ?

? ?<privateKey>${usr.home}/.ssh/id_dsa</privateKey> ?

? ?<!--鑒權(quán)時(shí)使用的私鑰密碼。--> ?

? ?<passphrase>some_passphrase</passphrase> ?

? ?<!--文件被創(chuàng)建時(shí)的權(quán)限。如果在部署的時(shí)候會(huì)創(chuàng)建一個(gè)倉(cāng)庫(kù)文件或者目錄，這時(shí)候就可以使用權(quán)限（permission）。這兩個(gè)元素合法的值是一個(gè)三位數(shù)字，其對(duì)應(yīng)了unix文件系統(tǒng)的權(quán)限，如664，或者775。 --> ?

? ?<filePermissions>664</filePermissions> ?

? ?<!--目錄被創(chuàng)建時(shí)的權(quán)限。 --> ?

? ?<directoryPermissions>775</directoryPermissions> ?

? ?<!--傳輸層額外的配置項(xiàng) --> ?

? ?<configuration></configuration> ?

? </server> ?

?</servers> ?

?<!--為倉(cāng)庫(kù)列表配置的下載鏡像列表。 --> ?

?<mirrors> ?

? <!--給定倉(cāng)庫(kù)的下載鏡像。 --> ?

? <mirror> ?

? ?<!--該鏡像的唯一標(biāo)識(shí)符。id用來區(qū)分不同的mirror元素。 --> ?

? ?<id>planetmirror.com</id> ?

? ?<!--鏡像名稱 --> ?

? ?<name>PlanetMirror Australia</name> ?

? ?<!--該鏡像的URL。構(gòu)建系統(tǒng)會(huì)優(yōu)先考慮使用該URL，而非使用默認(rèn)的服務(wù)器URL。 --> ?

? ?<url>http://downloads.planetmirror.com/pub/maven2</url> ?

? ?<!--被鏡像的服務(wù)器的id。例如，如果我們要設(shè)置了一個(gè)Maven中央倉(cāng)庫(kù)（http://repo1.maven.org/maven2）的鏡像，就需要將該元素設(shè)置成central。這必須和中央倉(cāng)庫(kù)的id central完全一致。--> ?

? ?<mirrorOf>central</mirrorOf> ?

? </mirror> ?

?</mirrors> ?

?<!--根據(jù)環(huán)境參數(shù)來調(diào)整構(gòu)建配置的列表。settings.xml中的profile元素是pom.xml中profile元素的裁剪版本。它包含了id，activation, repositories, pluginRepositories和 properties元素。這里的profile元素只包含這五個(gè)子元素是因?yàn)檫@里只關(guān)心構(gòu)建系統(tǒng)這個(gè)整體（這正是settings.xml文件的角色定位），而非單獨(dú)的項(xiàng)目對(duì)象模型設(shè)置。如果一個(gè)settings中的profile被激活，它的值會(huì)覆蓋任何其它定義在POM中或者profile.xml中的帶有相同id的profile。 --> ?

?<profiles> ?

? <!--根據(jù)環(huán)境參數(shù)來調(diào)整的構(gòu)件的配置--> ?

? <profile> ?

? ?<!--該配置的唯一標(biāo)識(shí)符。 --> ?

? ?<id>test</id> ?

? ?<!--自動(dòng)觸發(fā)profile的條件邏輯。Activation是profile的開啟鑰匙。如POM中的profile一樣，profile的力量來自于它能夠在某些特定的環(huán)境中自動(dòng)使用某些特定的值；這些環(huán)境通過activation元素指定。activation元素并不是激活profile的唯一方式。settings.xml文件中的activeProfile元素可以包含profile的id。profile也可以通過在命令行，使用-P標(biāo)記和逗號(hào)分隔的列表來顯式的激活（如，-P test）。--> ?

? ?<activation> ?

? ? <!--profile默認(rèn)是否激活的標(biāo)識(shí)--> ?

? ? <activeByDefault>false</activeByDefault> ?

? ? <!--當(dāng)匹配的jdk被檢測(cè)到，profile被激活。例如，1.4激活JDK1.4，1.4.0_2，而!1.4激活所有版本不是以1.4開頭的JDK。--> ?

? ? <jdk>1.5</jdk> ?

? ? <!--當(dāng)匹配的操作系統(tǒng)屬性被檢測(cè)到，profile被激活。os元素可以定義一些操作系統(tǒng)相關(guān)的屬性。--> ?

? ? <os> ?

? ? ?<!--激活profile的操作系統(tǒng)的名字 --> ?

? ? ?<name>Windows XP</name> ?

? ? ?<!--激活profile的操作系統(tǒng)所屬家族(如 'windows') ?--> ?

? ? ?<family>Windows</family> ?

? ? ?<!--激活profile的操作系統(tǒng)體系結(jié)構(gòu) ?--> ?

? ? ?<arch>x86</arch> ?

? ? ?<!--激活profile的操作系統(tǒng)版本--> ?

? ? ?<version>5.1.2600</version> ?

? ? </os> ?

? ? <!--如果Maven檢測(cè)到某一個(gè)屬性（其值可以在POM中通過${名稱}引用），其擁有對(duì)應(yīng)的名稱和值，Profile就會(huì)被激活。如果值字段是空的，那么存在屬性名稱字段就會(huì)激活profile，否則按區(qū)分大小寫方式匹配屬性值字段--> ?

? ? <property> ?

? ? ?<!--激活profile的屬性的名稱--> ?

? ? ?<name>mavenVersion</name> ?

? ? ?<!--激活profile的屬性的值 --> ?

? ? ?<value>2.0.3</value> ?

? ? </property> ?

? ? <!--提供一個(gè)文件名，通過檢測(cè)該文件的存在或不存在來激活profile。missing檢查文件是否存在，如果不存在則激活profile。另一方面，exists則會(huì)檢查文件是否存在，如果存在則激活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> ?

? ?<!--對(duì)應(yīng)profile的擴(kuò)展屬性列表。Maven屬性和Ant中的屬性一樣，可以用來存放一些值。這些值可以在POM中的任何地方使用標(biāo)記${X}來使用，這里X是指屬性的名稱。屬性有五種不同的形式，并且都能在settings.xml文件中訪問。 ?

? ?1. env.X: 在一個(gè)變量前加上"env."的前綴，會(huì)返回一個(gè)shell環(huán)境變量。例如,"env.PATH"指代了$path環(huán)境變量（在Windows上是%PATH%）。 ?

? ?2. project.x：指代了POM中對(duì)應(yīng)的元素值。 ?

? ?3. settings.x: 指代了settings.xml中對(duì)應(yīng)元素的值。 ?

? ?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/>元素中，或者外部文件中設(shè)置，以${someVar}的形式使用。 --> ?

? ?<properties> ?

? ? <user.install>/ebs1/build-machine/usr/local/hudson/hudson-home/jobs/maven-guide-</user.install> ?

? ?</properties> ?

? ?<!--遠(yuǎn)程倉(cāng)庫(kù)列表，它是Maven用來填充構(gòu)建系統(tǒng)本地倉(cāng)庫(kù)所使用的一組遠(yuǎn)程項(xiàng)目。 --> ?

? ?<repositories> ?

? ? <!--包含需要連接到遠(yuǎn)程倉(cāng)庫(kù)的信息 --> ?

? ? <repository> ?

? ? ?<!--遠(yuǎn)程倉(cāng)庫(kù)唯一標(biāo)識(shí)--> ?

? ? ?<id>codehausSnapshots</id> ?

? ? ?<!--遠(yuǎn)程倉(cāng)庫(kù)名稱 --> ?

? ? ?<name>Codehaus Snapshots</name> ?

? ? ?<!--如何處理遠(yuǎn)程倉(cāng)庫(kù)里發(fā)布版本的下載--> ?

? ? ?<releases> ?

? ? ? <!--true或者false表示該倉(cāng)庫(kù)是否為下載某種類型構(gòu)件（發(fā)布版，快照版）開啟。 ?--> ?

? ? ? <enabled>false</enabled> ?

? ? ? <!--該元素指定更新發(fā)生的頻率。Maven會(huì)比較本地POM和遠(yuǎn)程POM的時(shí)間戳。這里的選項(xiàng)是：always（一直），daily（默認(rèn)，每日），interval：X（這里X是以分鐘為單位的時(shí)間間隔），或者never（從不）。 --> ?

? ? ? <updatePolicy>always</updatePolicy> ?

? ? ? <!--當(dāng)Maven驗(yàn)證構(gòu)件校驗(yàn)文件失敗時(shí)該怎么做-ignore（忽略），fail（失?。蛘遷arn（警告）。--> ?

? ? ? <checksumPolicy>warn</checksumPolicy> ?

? ? ?</releases> ?

? ? ?<!--如何處理遠(yuǎn)程倉(cāng)庫(kù)里快照版本的下載。有了releases和snapshots這兩組配置，POM就可以在每個(gè)單獨(dú)的倉(cāng)庫(kù)中，為每種類型的構(gòu)件采取不同的策略。例如，可能有人會(huì)決定只為開發(fā)目的開啟對(duì)快照版本下載的支持。參見repositories/repository/releases元素--> ?

? ? ?<snapshots> ?

? ? ? <enabled/><updatePolicy/><checksumPolicy/> ?

? ? ?</snapshots> ?

? ? ?<!--遠(yuǎn)程倉(cāng)庫(kù)URL，按protocol://hostname/path形式 --> ?

? ? ?<url>http://snapshots.maven.codehaus.org/maven2</url> ?

? ? ?<!--用于定位和排序構(gòu)件的倉(cāng)庫(kù)布局類型-可以是default（默認(rèn)）或者legacy（遺留）。Maven 2為其倉(cāng)庫(kù)提供了一個(gè)默認(rèn)的布局；然而，Maven 1.x有一種不同的布局。我們可以使用該元素指定布局是default（默認(rèn)）還是legacy（遺留）。 --> ?

? ? ?<layout>default</layout> ?

? ? </repository> ?

? ?</repositories> ?

? ?<!--發(fā)現(xiàn)插件的遠(yuǎn)程倉(cāng)庫(kù)列表。倉(cāng)庫(kù)是兩種主要構(gòu)件的家。第一種構(gòu)件被用作其它構(gòu)件的依賴。這是中央倉(cāng)庫(kù)中存儲(chǔ)的大部分構(gòu)件類型。另外一種構(gòu)件類型是插件。Maven插件是一種特殊類型的構(gòu)件。由于這個(gè)原因，插件倉(cāng)庫(kù)獨(dú)立于其它倉(cāng)庫(kù)。pluginRepositories元素的結(jié)構(gòu)和repositories元素的結(jié)構(gòu)類似。每個(gè)pluginRepository元素指定一個(gè)Maven可以用來尋找新插件的遠(yuǎn)程地址。--> ?

? ?<pluginRepositories> ?

? ? <!--包含需要連接到遠(yuǎn)程插件倉(cāng)庫(kù)的信息.參見profiles/profile/repositories/repository元素的說明--> ?

? ? ? ? ? <pluginRepository> ? ? ? ? ? ??

? ? ?<releases> ? ? ? ?

? ? ? <enabled/><updatePolicy/><checksumPolicy/> ?

? ? ?</releases> ?

? ? ?<snapshots> ?

? ? ? <enabled/><updatePolicy/><checksumPolicy/> ?

? ? ?</snapshots> ?

? ? ?<id/><name/><url/><layout/> ?

? ? ? ? ? </pluginRepository> ?

? ? ? ? </pluginRepositories> ?

? ? ? ? <!--手動(dòng)激活profiles的列表，按照profile被應(yīng)用的順序定義activeProfile。 該元素包含了一組activeProfile元素，每個(gè)activeProfile都含有一個(gè)profile id。任何在activeProfile中定義的profile id，不論環(huán)境設(shè)置如何，其對(duì)應(yīng)的 ?

? ? ? ? profile都會(huì)被激活。如果沒有匹配的profile，則什么都不會(huì)發(fā)生。例如，env-test是一個(gè)activeProfile，則在pom.xml（或者profile.xml）中對(duì)應(yīng)id的profile會(huì)被激活。如果運(yùn)行過程中找不到這樣一個(gè)profile，Maven則會(huì)像往常一樣運(yùn)行。 --> ?

? ?<activeProfiles> ?

? ? <!-- --> ?

? ? <activeProfile>env-test</activeProfile> ?

? ?</activeProfiles> ?

? </profile> ?

?</profiles> ?

</settings> ?