maven配置文件setting.xml详解

忘是亡心i 2022-06-11 03:39 167阅读 0赞

maven的配置文件**settings.xml**存在于两个地方：

1.安装的地方：$\{M2\_HOME\}/conf/settings.xml

2.用户的目录：$\{user.home\}/.m2/settings.xml

前者又被叫做**全局配置**，对[操作系统][Link 1]的所有使用者生效；后者被称为**用户配置**，只对当前操作系统的使用者生效。如果两者都存在，它们的内容将被合并，并且用户范围的settings.xml会覆盖全局的settings.xml。

Maven安装后，用户目录下不会自动生成settings.xml，只有全局配置文件。如果需要创建用户范围的settings.xml，可以将安装路径下的settings复制到目录$\{user.home\}/.m2/。Maven默认的settings.xml是一个包含了注释和例子的模板，可以快速的修改它来达到你的要求。

全局配置一旦更改，所有的用户都会受到影响，而且如果maven进行升级，所有的配置都会被清除，所以要提前复制和备份$\{M2\_HOME\}/conf/settings.xml文件，一般情况下不推荐配置全局的settings.xml。

**\[html\]** [ view plain][view plain] [ copy][view plain] [ print][view plain] [?][view plain]

1.  <?xml version="1.0" encoding="UTF-8"?>  
2.      
3.  <settings   xmlns="http://maven.apache.org/POM/4.0.0"    
4.      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    
5.      xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">  
6.          
7.        
8.      <localRepository>usr/local/maven</localRepository>  
9.          
10.       
11.     <interactiveMode>true</interactiveMode>  
12.         
13.       
14.       
15.       
16.     <usePluginRegistry>false</usePluginRegistry>  
17.         
18.       
19.       
20.     <offline>false</offline>  
21.         
22.       
23.       
24.       
25.       
26.     <pluginGroups>  
27.             
28.           
29.         <pluginGroup>org.codehaus.mojo</pluginGroup>  
30.            
31.     </pluginGroups>  
32.         
33.       
34.     <proxies>  
35.             
36.           
37.         <proxy>  
38.                 
39.               
40.             <id>myproxy</id>  
41.                 
42.               
43.             <active>true</active>  
44.                 
45.               
46.             <protocol>http://…</protocol>  
47.                 
48.               
49.             <host>proxy.somewhere.com</host>  
50.                 
51.               
52.             <port>8080</port>  
53.                 
54.                
55.             <username>proxyuser</username>  
56.                 
57.               
58.             <password>somepassword</password>  
59.                 
60.               
61.             <nonProxyHosts>\*.google.com|ibiblio.org</nonProxyHosts>  
62.                 
63.         </proxy>  
64.            
65.     </proxies>  
66.         
67.       
68.     <servers>  
69.             
70.           
71.         <server>  
72.                 
73.               
74.             <id>server001</id>  
75.                 
76.               
77.             <username>my\_login</username>  
78.                 
79.               
80.             <password>my\_password</password>  
81.                 
82.               
83.               
84.             <privateKey>$\{usr.home\}/.ssh/id\_dsa</privateKey>  
85.                 
86.               
87.             <passphrase>some\_passphrase</passphrase>  
88.                 
89.               
90.               
91.             <filePermissions>664</filePermissions>  
92.                 
93.               
94.             <directoryPermissions>775</directoryPermissions>  
95.                 
96.               
97.             <configuration></configuration>  
98.                 
99.         </server>  
100.            
101.     </servers>  
102.         
103.       
104.     <mirrors>  
105.             
106.           
107.         <mirror>  
108.                 
109.               
110.             <id>planetmirror.com</id>  
111.                 
112.               
113.             <name>PlanetMirror Australia</name>  
114.                 
115.               
116.             <url>http://downloads.planetmirror.com/pub/maven2</url>  
117.                 
118.               
119.               
120.             <mirrorOf>central</mirrorOf>  
121.                 
122.         </mirror>  
123.            
124.     </mirrors>  
125.         
126.       
127.       
128.       
129.       
130.     <profiles>  
131.             
132.           
133.         <profile>  
134.                 
135.               
136.             <id>test</id>  
137.                 
138.               
139.               
140.               
141.               
142.             <activation>  
143.                     
144.                   
145.                 <activeByDefault>false</activeByDefault>  
146.                     
147.                   
148.                 <jdk>1.7</jdk>  
149.                     
150.                   
151.                 <os>  
152.                         
153.                       
154.                     <name>Windows XP</name>  
155.                         
156.                       
157.                     <family>Windows</family>  
158.                         
159.                       
160.                     <arch>x86</arch>  
161.                         
162.                       
163.                     <version>5.1.2600</version>  
164.                           
165.                 </os>  
166.                     
167.                   
168.                   
169.                 <property>  
170.                         
171.                       
172.                     <name>mavenVersion</name>  
173.                         
174.                       
175.                     <value>2.0.3</value>  
176.                           
177.                 </property>  
178.                     
179.                   
180.                   
181.                 <file>  
182.                         
183.                       
184.                     <exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</exists>  
185.                         
186.                       
187.                     <missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</missing>  
188.                           
189.                 </file>  
190.                      
191.             </activation>  
192.                 
193.                
194.               
195.                
196.               
197.               
198.               
199.               
200.               
201.             <properties>  
202.               
203.                   
204.                 <user.install>usr/local/winner/jobs/maven-guide</user.install>  
205.                      
206.             </properties>  
207.                 
208.               
209.             <repositories>  
210.                     
211.                   
212.                 <repository>  
213.                         
214.                       
215.                     <id>codehausSnapshots</id>  
216.                         
217.                       
218.                     <name>Codehaus Snapshots</name>  
219.                         
220.                       
221.                     <releases>  
222.                             
223.                           
224.                         <enabled>false</enabled>  
225.                             
226.                           
227.                           
228.                         <updatePolicy>always</updatePolicy>  
229.                             
230.                           
231.                           
232.                         <checksumPolicy>warn</checksumPolicy>  
233.                                
234.                     </releases>  
235.                         
236.                       
237.                       
238.                     <snapshots>  
239.                                 
240.                         <enabled />  
241.                         <updatePolicy />  
242.                         <checksumPolicy />  
243.                                
244.                     </snapshots>  
245.                         
246.                       
247.                     <url>http://snapshots.maven.codehaus.org/maven2</url>  
248.                         
249.                       
250.                       
251.                     <layout>default</layout>  
252.                           
253.                 </repository>  
254.                      
255.             </repositories>  
256.                 
257.               
258.               
259.               
260.             <pluginRepositories>  
261.                     
262.                   
263.                 <pluginRepository>  
264.                     <releases>  
265.                         <enabled />  
266.                         <updatePolicy />  
267.                         <checksumPolicy />  
268.                     </releases>  
269.                            
270.                     <snapshots>  
271.                         <enabled />  
272.                         <updatePolicy />  
273.                         <checksumPolicy />  
274.                     </snapshots>  
275.                            
276.                     <id />  
277.                     <name />  
278.                     <url />  
279.                     <layout />  
280.                 </pluginRepository>  
281.                           
282.             </pluginRepositories>  
283.                 
284.               
285.               
286.               
287.               
288.             <activeProfiles>  
289.                       
290.                 <activeProfile>env-test</activeProfile>  
291.                      
292.             </activeProfiles>  
293.                 
294.         </profile>  
295.            
296.     </profiles>  
297.         
298. </settings>

上面的配置文件对各个节点的含义及作用都有注解。实际应用中，经常使用的是<localRepository>、<servers>、<mirrors>、<profiles>有限几个节点，其他节点使用默认值足够应对大部分的应用场景。

### <profile>节点 ###

在仓库的配置一节中，已经对setting.xml中的常用节点做了详细的说明。在这里需要特别介绍一下的是<profile>节点的配置，profile是maven的一个重要特性。

<profile>节点包含了**激活(activation)**，**仓库(repositories)**，**插件仓库(pluginRepositories)**和**属性(properties)**共四个子元素元素。profile元素仅包含这四个元素是因为他们涉及到整个的构建系统，而不是个别的项目级别的POM配置。

profile可以让maven能够自动适应外部的环境变化，比如同一个项目，在[Linux][]下编译[linux][Linux]的版本，在win下编译win的版本等。一个项目可以设置多个profile，也可以在同一时间设置多个profile被激活（active）的。自动激活的 profile的条件可以是各种各样的设定条件，组合放置在activation节点中，也可以通过命令行直接指定。如果认为profile设置比较复杂，可以将所有的profiles内容移动到专门的 profiles.xml 文件中，不过记得和pom.xml放在一起。

activation节点是设置该profile在什么条件下会被激活，常见的条件有如下几个：

1.   **os**

判断操作系统相关的参数，它包含如下可以自由组合的子节点元素

message - 规则失败之后显示的消息

arch - 匹配cpu结构，常见为x86

family - 匹配操作系统家族，常见的取值为：dos，mac，netware，os/2，unix，windows，win9x，os/400等

name - 匹配操作系统的名字

version - 匹配的操作系统版本号

display - 检测到操作系统之后显示的信息

2.   **jdk**

检查jdk版本，可以用区间表示。

3.   **property**

检查属性值，本节点可以包含name和value两个子节点。

4.   **file**

检查文件相关内容，包含两个子节点：exists和missing，用于分别检查文件存在和不存在两种情况。

**如果settings中的profile被激活，那么它的值将覆盖POM或者profiles.xml中的任何相等ID的profiles**。

如果想要某个profile默认处于激活状态，可以在<activeProfiles>中将该profile的id放进去。这样，不论环境设置如何，其对应的 profile都会被激活。

[Link 1]: http://lib.csdn.net/base/operatingsystem
[view plain]: http://blog.csdn.net/u012152619/article/details/51485152#
[Linux]: http://lib.csdn.net/base/linux