settings.xml有什么用
從settings.xml的文件名就可以看出,它是用來設(shè)置maven參數(shù)的配置文件。并且,settings.xml是maven的全局配置文件。而pom.xml文件是所在項目的局部配置。
Settings.xml中包含類似本地倉儲位置、修改遠(yuǎn)程倉儲服務(wù)器、認(rèn)證信息等配置。
settings.xml文件位置
全局配置: ${M2_HOME}/conf/settings.xml
用戶配置: user.home/.m2/settings.xmlnote:用戶配置優(yōu)先于全局配置。user.home/.m2/settings.xmlnote:用戶配置優(yōu)先于全局配置。{user.home} 和和所有其他系統(tǒng)屬性只能在3.0+版本上使用。請注意windows和Linux使用變量的區(qū)別。
配置優(yōu)先級
需要注意的是:局部配置優(yōu)先于全局配置。
配置優(yōu)先級從高到低:pom.xml> user settings > global settings
如果這些文件同時存在,在應(yīng)用配置時,會合并它們的內(nèi)容,如果有重復(fù)的配置,優(yōu)先級高的配置會覆蓋優(yōu)先級低的。
ps.修改了配置文件最好把cmd和eclipse重開一下
settings.xml元素詳解
頂級元素概覽
下面列舉了settings.xml中的頂級元素
LocalRepository
作用:該值表示構(gòu)建系統(tǒng)本地倉庫的路徑。
其默認(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文件來管理插件版本。
如果需要讓maven使用文件~/.m2/plugin-registry.xml來管理插件版本,則設(shè)為true。默認(rèn)為false。false
Offline
作用:表示maven是否需要在離線模式下運行。
如果構(gòu)建系統(tǒng)需要在離線模式下運行,則為true,默認(rèn)為false。
當(dāng)由于網(wǎng)絡(luò)設(shè)置原因或者安全因素,構(gòu)建服務(wù)器不能連接遠(yuǎn)程倉庫的時候,該配置就十分有用。false
PluginGroups
作用:當(dāng)插件的組織id(groupId)沒有顯式提供時,供搜尋插件組織Id(groupId)的列表。
該元素包含一個pluginGroup元素列表,每個子元素包含了一個組織Id(groupId)。
當(dāng)我們使用某個插件,并且沒有在命令行為其提供組織Id(groupId)的時候,Maven就會使用該列表。默認(rèn)情況下該列表包含了org.apache.maven.plugins和org.codehaus.mojo。
… org.codehaus.mojo…
Servers
作用:一般,倉庫的下載和部署是在pom.xml文件中的repositories和distributionManagement元素中定義的。然而,一般類似用戶名、密碼(有些倉庫訪問是需要安全認(rèn)證的)等信息不應(yīng)該在pom.xml文件中配置,這些信息可以配置在settings.xml中。
… server001 my_login my_password ${usr.home}/.ssh/id_dsa some_passphrase 664 775 …
Mirrors
作用:為倉庫列表配置的下載鏡像列表。
… planetmirror.com PlanetMirror Australia http://downloads.planetmirror.com/pub/maven2 central …
Proxies
作用:用來配置不同的代理。
… myproxy true http proxy.somewhere.com 8080 proxyuser somepassword *.google.com|ibiblio.org …
Profiles
作用:根據(jù)環(huán)境參數(shù)來調(diào)整構(gòu)建配置的列表。
settings.xml中的profile元素是pom.xml中profile元素的裁剪版本。
它包含了id、activation、repositories、pluginRepositories和 properties元素。這里的profile元素只包含這五個子元素是因為這里只關(guān)心構(gòu)建系統(tǒng)這個整體(這正是settings.xml文件的角色定位),而非單獨的項目對象模型設(shè)置。如果一個settings.xml中的profile被激活,它的值會覆蓋任何其它定義在pom.xml中帶有相同id的profile。
… test …
Activation
作用:自動觸發(fā)profile的條件邏輯。
如pom.xml中的profile一樣,profile的作用在于它能夠在某些特定的環(huán)境中自動使用某些特定的值;這些環(huán)境通過activation元素指定。
activation元素并不是激活profile的唯一方式。settings.xml文件中的activeProfile元素可以包含profile的id。profile也可以通過在命令行,使用-P標(biāo)記和逗號分隔的列表來顯式的激活(如,-P test)。
false1.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命令可以查看中央倉儲的profile是否在工程中生效。
properties
作用:對應(yīng)profile的擴展屬性列表。
maven屬性和ant中的屬性一樣,可以用來存放一些值。這些值可以在pom.xml中的任何地方使用標(biāo)記${X}來使用,這里X是指屬性的名稱。屬性有五種不同的形式,并且都能在settings.xml文件中訪問。
${user.home}/our-project
注:如果該profile被激活,則可以在pom.xml中使用${user.install}。
Repositories
作用:遠(yuǎn)程倉庫列表,它是maven用來填充構(gòu)建系統(tǒng)本地倉庫所使用的一組遠(yuǎn)程倉庫。
codehausSnapshots Codehaus Snapshots false always warn http://snapshots.maven.codehaus.org/maven2 default
pluginRepositories
作用:發(fā)現(xiàn)插件的遠(yuǎn)程倉庫列表。
和repository類似,只是repository是管理jar包依賴的倉庫,pluginRepositories則是管理插件的倉庫。
maven插件是一種特殊類型的構(gòu)件。由于這個原因,插件倉庫獨立于其它倉庫。pluginRepositories元素的結(jié)構(gòu)和repositories元素的結(jié)構(gòu)類似。每個pluginRepository元素指定一個Maven可以用來尋找新插件的遠(yuǎn)程地址。
ActiveProfiles
作用:手動激活profiles的列表,按照profile被應(yīng)用的順序定義activeProfile。
該元素包含了一組activeProfile元素,每個activeProfile都含有一個profile id。任何在activeProfile中定義的profile id,不論環(huán)境設(shè)置如何,其對應(yīng)的 profile都會被激活。如果沒有匹配的profile,則什么都不會發(fā)生。
例如,env-test是一個activeProfile,則在pom.xml(或者profile.xml)中對應(yīng)id的profile會被激活。如果運行過程中找不到這樣一個profile,Maven則會像往常一樣運行。
… env-test…source ://ningyu1.github.io/20170510/07-maven-settings.html