settings.xml有什么用？

如果在Eclipse中使用過(guò)Maven插件，想必會(huì)有這個(gè)經(jīng)驗(yàn)：配置settings.xml文件的路徑。

settings.xml文件是干什么的，為什么要配置它呢？從settings.xml的文件名就可以看出，它是用來(lái)設(shè)置maven參數(shù)的配置文件。并且，settings.xml是maven的全局配置文件。而pom.xml文件是所在項(xiàng)目的局部配置。Settings.xml中包含類似本地倉(cāng)儲(chǔ)位置、修改遠(yuǎn)程倉(cāng)儲(chǔ)服務(wù)器（如阿里云的遠(yuǎn)程倉(cāng)庫(kù)）、認(rèn)證信息等配置（比如對(duì)于某個(gè)遠(yuǎn)程的倉(cāng)庫(kù)需要用戶名和密碼的話也需要在這個(gè)setting.xml中進(jìn)行配置）。

【資料圖】

在setting.xml中配置阿里云的遠(yuǎn)程倉(cāng)庫(kù)：

                           alimaven            *            aliyun maven            http://maven.aliyun.com/nexus/content/repositories/central/                                    repo1            central            Human Readable Name for this Mirror.            http://repo1.maven.org/maven2/                                    repo2            central            Human Readable Name for this Mirror.            http://repo2.maven.org/maven2/            

settings.xml文件位置

settings.xml文件一般存在于兩個(gè)位置：全局配置: ${M2_HOME}/conf/settings.xml用戶配置: 用戶配置優(yōu)先于全局配置。user.home/.m2/settings.xmlnote：用戶配置優(yōu)先于全局配置。{user.home} 和和所有其他系統(tǒng)屬性只能在3.0+版本上使用。請(qǐng)注意windows和Linux使用變量的區(qū)別。

配置優(yōu)先級(jí)

eclipse對(duì)于Maven工程中需要注意的是：局部配置優(yōu)先于全局配置。配置優(yōu)先級(jí)從高到低：pom.xml> user settings > global settings如果這些文件同時(shí)存在，在應(yīng)用配置時(shí)，會(huì)合并它們的內(nèi)容，如果有重復(fù)的配置，優(yōu)先級(jí)高的配置會(huì)覆蓋優(yōu)先級(jí)低的。

settings.xml元素詳解

頂級(jí)元素概覽

下面列舉了settings.xml中的頂級(jí)元素

LocalRepository

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

${user.home}/.m2/repository

InteractiveMode

作用：表示maven是否需要和用戶交互以獲得輸入。如果maven需要和用戶交互以獲得輸入，則設(shè)置成true，反之則應(yīng)為false。默認(rèn)為true。

true

UsePluginRegistry

作用：maven是否需要使用plugin-registry.xml文件來(lái)管理插件版本。如果需要讓maven使用文件~/.m2/plugin-registry.xml來(lái)管理插件版本，則設(shè)為true。默認(rèn)為false。

false

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í)候，該配置就十分有用。

false

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。

  ...          org.codehaus.mojo    ...

Servers

作用：一般，倉(cāng)庫(kù)的下載和部署是在pom.xml文件中的repositories和distributionManagement元素中定義的。然而，一般類似用戶名、密碼（有些倉(cāng)庫(kù)訪問(wèn)是需要安全認(rèn)證的）等信息不應(yīng)該在pom.xml文件中配置，這些信息可以配置在settings.xml中。

  ...                        server001            my_login            my_password            ${usr.home}/.ssh/id_dsa            some_passphrase            664            775        ...

Mirrors

作用：為倉(cāng)庫(kù)列表配置的下載鏡像列表。

  ...                      planetmirror.com            PlanetMirror Australia            http://downloads.planetmirror.com/pub/maven2            central        ...

Proxies

作用：用來(lái)配置不同的代理。

  ...                      myproxy            true            http            proxy.somewhere.com            8080            proxyuser            somepassword            *.google.com|ibiblio.org        ...

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.xml中的profile被激活，它的值會(huì)覆蓋任何其它定義在pom.xml中帶有相同id的profile。

  ...                  test                                                        ...

Activation

作用：自動(dòng)觸發(fā)profile的條件邏輯。如pom.xml中的profile一樣，profile的作用在于它能夠在某些特定的環(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）。

    false    1.5            Windows XP        Windows        x86        5.1.2600              mavenVersion        2.0.3              ${basedir}/file2.properties        ${basedir}/file1.properties  

注：在maven工程的pom.xml所在目錄下執(zhí)行mvn help:active-profiles命令可以查看中央倉(cāng)儲(chǔ)的profile是否在工程中生效。

properties

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

  ${user.home}/our-project

注：如果在setting.xml中的profile被激活，則可以在pom.xml中使用${user.install}。

Repositories

作用：遠(yuǎn)程倉(cāng)庫(kù)列表，它是maven用來(lái)填充構(gòu)建系統(tǒng)本地倉(cāng)庫(kù)所使用的一組遠(yuǎn)程倉(cāng)庫(kù)。

            codehausSnapshots        Codehaus Snapshots                    false            always            warn                                          http://snapshots.maven.codehaus.org/maven2        default  

pluginRepositories

作用：發(fā)現(xiàn)插件的遠(yuǎn)程倉(cāng)庫(kù)列表。和repository類似，只是repository是管理jar包依賴的倉(cāng)庫(kù)，pluginRepositories則是管理插件的倉(cāng)庫(kù)。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)程地址。

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)行。

  ...          env-test    ...

關(guān)鍵詞： GitHub Maven