一、简介
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下的顶层元素的一个概览:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
<
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
>
|
二、简单值
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。
1
2
3
4
5
6
7
8
9
10
|
<
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
>
|
四、Servers(服务器)
1. 定义jar包下载的Maven仓库
2. 定义部署服务器
1
2
3
4
5
6
7
8
9
10
11
12
|
<
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私服
五、Mirrors(镜像)
指定仓库的地址,则默认从指定的镜像下载jar包及插件
1
2
3
4
5
6
7
8
9
|
<
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
>
|
六、Proxies(代理)
有时候你所在的公司基于安全因素考虑,要求你使用通过安全认证的代理访问因特网。这时就需要为Maven配置HTTP代理。
1
2
3
4
5
6
7
8
9
10
11
12
|
<
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
>
|
参考:http://maven.apache.org/settings.html