文件存放位置

全局配置:?${M2_HOME}/conf/settings.xml

用戶配置:?${user.home}/.m2/settings.xml

note：用戶配置優(yōu)先于全局配置。${user.home}?和和所有其他系統(tǒng)屬性只能在3.0+版本上使用。請(qǐng)注意windows和Linux使用變量的區(qū)別。

settings.xml詳解

聲明規(guī)范

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

localRepository

<!-- 本地倉(cāng)庫(kù)的路徑。默認(rèn)值為${user.home}/.m2/repository。 --><localRepository>usr/local/maven</localRepository>

interactiveMode

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

usePluginRegistry

<!--Maven是否需要使用plugin-registry.xml文件來(lái)管理插件版本。如果需要讓Maven使用文件${user.home}/.m2/plugin-registry.xml來(lái)管理插件版本，則設(shè)為true。默認(rèn)為false。--><usePluginRegistry>false</usePluginRegistry>

offline

<!--表示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>

pluginGroups

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

proxies

<!--用來(lái)配置不同的代理，多代理profiles 可以應(yīng)對(duì)筆記本或移動(dòng)設(shè)備的工作環(huán)境：通過(guò)簡(jiǎn)單的設(shè)置profile id就可以很容易的更換整個(gè)代理配置。 --><proxies><!--代理元素包含配置代理時(shí)需要的信息--><proxy><!--代理的唯一定義符，用來(lái)區(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)分隔也很常見(jiàn)。--><nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts></proxy></proxies>

servers

<!--配置服務(wù)端的一些設(shè)置。一些設(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)證所需要的登錄名和密碼。密碼加密功能已被添加到2.1.0 +。詳情請(qǐng)?jiān)L問(wèn)密碼加密頁(yè)面--><password>my_password</password><!--鑒權(quán)時(shí)使用的私鑰位置。和前兩個(gè)元素類似，私鑰位置和私鑰密碼指定了一個(gè)私鑰的路徑(默認(rèn)是${user.home}/.ssh/id_dsa)以及如果需要的話，一個(gè)密語(yǔ)。將來(lái)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></server></servers>

mirrors

<!--為倉(cāng)庫(kù)列表配置的下載鏡像列表。高級(jí)設(shè)置請(qǐng)參閱鏡像設(shè)置頁(yè)面 --><mirrors><!--給定倉(cāng)庫(kù)的下載鏡像。 --><mirror><!--該鏡像的唯一標(biāo)識(shí)符。id用來(lái)區(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://repo.maven.apache.org/maven2/)的鏡像，就需要將該元素設(shè)置成central。這必須和中央倉(cāng)庫(kù)的id central完全一致。--><mirrorOf>central</mirrorOf></mirror></mirrors>

profiles

<!--根據(jù)環(huán)境參數(shù)來(lái)調(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ù)來(lái)調(diào)整的構(gòu)件的配置--><profile><!--該配置的唯一標(biāo)識(shí)符。 --><id>test</id>

Activation

<!--自動(dòng)觸發(fā)profile的條件邏輯。Activation是profile的開(kāi)啟鑰匙。如POM中的profile一樣，profile的力量來(lái)自于它能夠在某些特定的環(huán)境中自動(dòng)使用某些特定的值；這些環(huán)境通過(guò)activation元素指定。activation元素并不是激活profile的唯一方式。settings.xml文件中的activeProfile元素可以包含profile的id。profile也可以通過(guò)在命令行，使用-P標(biāo)記和逗號(hào)分隔的列表來(lái)顯式的激活(如，-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開(kāi)頭的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中通過(guò)${name}引用)，其擁有對(duì)應(yīng)的name = 值，Profile就會(huì)被激活。如果值字段是空的，那么存在屬性名稱字段就會(huì)激活profile，否則按區(qū)分大小寫(xiě)方式匹配屬性值字段--><property><!--激活profile的屬性的名稱--><name>mavenVersion</name><!--激活profile的屬性的值 --><value>2.0.3</value></property><!--提供一個(gè)文件名，通過(guò)檢測(cè)該文件的存在或不存在來(lái)激活profile。missing檢查文件是否存在，如果不存在則激活profile。另一方面，exists則會(huì)檢查文件是否存在，如果存在則激活profile。--><file><!--如果指定的文件存在，則激活profile。 --><exists>${basedir}/file2.properties</exists><!--如果指定的文件不存在，則激活profile。--><missing>${basedir}/file1.properties</missing></file></activation>

Properties

<!--對(duì)應(yīng)profile的擴(kuò)展屬性列表。Maven屬性和Ant中的屬性一樣，可以用來(lái)存放一些值。這些值可以在POM中的任何地方使用標(biāo)記${X}來(lái)使用，這里X是指屬性的名稱。屬性有五種不同的形式，并且都能在settings.xml文件中訪問(wèn)。1. env.X: 在一個(gè)變量前加上"env."的前綴，會(huì)返回一個(gè)shell環(huán)境變量。例如,"env.PATH"指代了$path環(huán)境變量(在Windows上是%PATH%)。2. project.x：指代了POM中對(duì)應(yīng)的元素值。例如: <project><version>1.0</version></project>通過(guò)${project.version}獲得version的值。3. settings.x: 指代了settings.xml中對(duì)應(yīng)元素的值。例如：<settings><offline>false</offline></settings>通過(guò) ${settings.offline}獲得offline的值。4. Java System Properties: 所有可通過(guò)java.lang.System.getProperties()訪問(wèn)的屬性都能在POM中使用該形式訪問(wèn)，例如 ${java.home}。5. x: 在<properties/>元素中，或者外部文件中設(shè)置，以${someVar}的形式使用。 --><properties><user.install>${user.home}/our-project</user.install></properties> note：如果該profile被激活，則可以再POM中使用${user.install}。

Repositories

<!--遠(yuǎn)程倉(cāng)庫(kù)列表，它是Maven用來(lái)填充構(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ā)布版，快照版)開(kāi)啟。 --><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(失敗)，或者warn(警告)。--><checksumPolicy>warn</checksumPolicy></releases><!--如何處理遠(yuǎn)程倉(cāng)庫(kù)里快照版本的下載。有了releases和snapshots這兩組配置，POM就可以在每個(gè)單獨(dú)的倉(cāng)庫(kù)中，為每種類型的構(gòu)件采取不同的策略。例如，可能有人會(huì)決定只為開(kāi)發(fā)目的開(kāi)啟對(duì)快照版本下載的支持。參見(jiàn)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可以用來(lái)尋找新插件的遠(yuǎn)程地址。--><pluginRepositories><!--包含需要連接到遠(yuǎn)程插件倉(cāng)庫(kù)的信息.參見(jiàn)profiles/profile/repositories/repository元素的說(shuō)明--><pluginRepository> <releases> <enabled/><updatePolicy/><checksumPolicy/></releases><snapshots><enabled/><updatePolicy/><checksumPolicy/></snapshots><id/><name/><url/><layout/></pluginRepository></pluginRepositories></profile></profiles>

activeProfiles

<!--手動(dòng)激活profiles的列表，按照profile被應(yīng)用的順序定義activeProfile。 該元素包含了一組activeProfile元素，每個(gè)activeProfile都含有一個(gè)profile id。任何在activeProfile中定義的profile id，不論環(huán)境設(shè)置如何，其對(duì)應(yīng)的profile都會(huì)被激活。如果沒(méi)有匹配的profile，則什么都不會(huì)發(fā)生。例如，env-test是一個(gè)activeProfile，則在pom.xml(或者profile.xml)中對(duì)應(yīng)id的profile會(huì)被激活。如果運(yùn)行過(guò)程中找不到這樣一個(gè)profile，Maven則會(huì)像往常一樣運(yùn)行。 --><activeProfiles><!-- --><activeProfile>env-test</activeProfile></activeProfiles> </settings>

總結(jié)

以上是生活随笔為你收集整理的Maven系列--setting.xml 配置详解的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。