maven安装和eclipse集成以及Maven之setting.xml配置文件详解

超、凢脫俗 2022-06-05 07:08 220阅读 0赞

## 由于maven需要JDK的支持，所以在安装maven之前请确保电脑上已经安装了JDK，且配置好了环境变量，具体的JDK的安装及配置可自行百度。下面进入安装  一、maven安装  前面已经下载了相应版本的maven，且已经配置好JDK的环境；      1、把下载好的压缩包解压到一个路径，我这里解压的路径为：e:\\maven\\apache-maven-3.2.2，      2、解压之后需要配置环境变量，新建MAVEN\_HOME环境变量，值为：e:\\maven\\apache-maven-3.2.2，然后向path环境变量值的最后添加如下内容：%maven\_home%\\bin;，注意在向path中添加值的时候不同的值需要以英文状态下分号隔开，且最后一个值也需要以分号结尾，点击确定完成环境变量的配置。      3、测试，在命令行中输入：mvn -v ，回车，如果出现如下图所示，则证明maven安装成功，  ![985599-20160925170607744-2119735801.png][]     maven安装完成之后可以单独使用，独立使用maven创建项目、构建工程等。这里不介绍其单独使用的方式，这里介绍它和eclipse集成的方法。  二、和eclipse的集成  eclipse一个集成的开发环境，在开发过程中用的很广泛，下面看如何在eclipse中使用maven，在eclipse的4.4以上的版本加入了对maven的支持，即不需要安装maven插件，但对4.4以下的版本需要自己安装插件，可以在下面的网址：http://marketplace.eclipse.org/content/maven-integration-eclipse-luna，去了解安装过程，安装完成之后，      1、在windows-->>preferences中找到maven选项，下图，  ![985599-20160925172027367-390461291.png][]  上图中我们找到maven-->>installations看到，已经有了，但是我们要使用刚才安装的maven，选择add按钮，找到刚才解压的maven的路径，如下，  ![985599-20160925172230813-468127317.png][]  由于我这里已经安装过，所以提示已经存在，修改完maven的位置之后，我们需要修改配置文件      2、修改配置文件，找到maven的解压目录，之后进入conf文件夹，编辑settings.xml，在settings找到注释掉的localRespository标签，此标签的目的是配置本地的maven仓库，我们加入这样一个配置：<localRepository>E:/apache-maven-3.3.1-bin/mvn/mvnrepository</localRepository>，即把本地仓库设置为我的本地目录。然后保存即可。      3、eclipse中更新配置文件      在eclipse中windows-->preferences，找到maven，然后如下图所示，找到User settings，修改配置文件为刚才修改的配置文件，  ![985599-20160925172923404-1265994932.png][]  修改完成之后，则和eclipse的集成完成。     经过以上的步骤则maven和eclipse的集成完成，接下来可以使用maven了，但，如果你的电脑是通过代理上网的话，必须在settings.xml文件中配置代理，这样才可以从maven的仓库中下载所需的文件，配置的代理的方式如下，在settings.xml文件中添加如下内容，  ![复制代码][copycode.gif]  <proxy> <id>myProxy</id> <active>true</active> <protocol>http</protocol> <username></username> <password></password> <host>proxy.xxxxx</host> <port>910</port> </proxy>  ![复制代码][copycode.gif]  id  代理ID 标识代理  active  设置代理是否启用  protocol  代理使用的协议  username  连接代理的用户名，如，此代理不需要用户名则可以把此标签删掉  password  连接代理的密码，如，同上  host  代理的网址  port  代理使用的端口  上面是使用代理上网的配置，如果上网没使用代理，则不需要配置。  三、使用maven创建项目  java开发过程中使用的最多的是java、javaWeb项目，  file-->>new--->project，然后找到maven，如下图选择，  ![985599-20160925173727985-1628996985.png][]  点击next,  ![985599-20160925173810426-273158137.png][]  在点击next,  ![985599-20160925173903195-29932328.png][]  第一个红框内表示的是新建java项目，第二个是javaWeb项目，这里选择第一个，  ![985599-20160925174036295-1205981750.png][]  输入红框的内容之后，点击finish，ecplise则会开始创建项目，此时会连接网络从网上下载需要的jar包，jar包存放的路径就是配置的本地仓库的路径，我的在：E:\\apache-maven-3.3.1-bin\\mvn\\mvnrepository路径下，在E:\\apache-maven-3.3.1-bin\\mvn\\mvnrepository\\org\\apache\\maven\\plugins文件夹下是maven插件所需的依赖插件。      ##

## setting.xml配置文件 ##

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

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

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

前者又被叫做全局配置，对操作系统的所有使用者生效；后者被称为用户配置，只对当前操作系统的使用者生效。如果两者都存在，它们的内容将被合并，并且用户范围的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][]  [copy][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的版本，在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都会被激活。

## settings.xml有什么用？ ##

如果在Eclipse中使用过Maven插件，想必会有这个经验：配置settings.xml文件的路径。  
![Paste\_Image.png][Paste_Image.png]  
settings.xml文件是干什么的，为什么要配置它呢？  
从settings.xml的文件名就可以看出，它是用来设置maven参数的配置文件。并且，settings.xml是maven的全局配置文件。而pom.xml文件是所在项目的局部配置。  
Settings.xml中包含类似本地仓储位置、修改远程仓储服务器、认证信息等配置。

## settings.xml文件位置 ##

settings.xml文件一般存在于两个位置：  
全局配置: $\{M2\_HOME\}/conf/settings.xml  
用户配置: \$\{user.home\}/.m2/settings.xml note：用户配置优先于全局配置。\$\{user.home\} 和和所有其他系统属性只能在3.0+版本上使用。请注意windows和Linux使用变量的区别。

## 配置优先级 ##

需要注意的是：局部配置优先于全局配置。  
配置优先级从高到低：pom.xml> user settings > global settings  
如果这些文件同时存在，在应用配置时，会合并它们的内容，如果有重复的配置，优先级高的配置会覆盖优先级低的。

# settings.xml元素详解 #

## 顶级元素概览 ##

下面列举了`settings.xml`中的顶级元素

## LocalRepository ##

作用：该值表示构建系统本地仓库的路径。  
其默认值：~/.m2/repository。

<localRepository>${user.home}/.m2/repository</localRepository>

## InteractiveMode ##

作用：表示maven是否需要和用户交互以获得输入。  
如果maven需要和用户交互以获得输入，则设置成true，反之则应为false。默认为true。

## UsePluginRegistry ##

作用：maven是否需要使用plugin-registry.xml文件来管理插件版本。  
如果需要让maven使用文件~/.m2/plugin-registry.xml来管理插件版本，则设为true。默认为false。

<usePluginRegistry>false</usePluginRegistry>

## Offline ##

作用：表示maven是否需要在离线模式下运行。  
如果构建系统需要在离线模式下运行，则为true，默认为false。  
当由于网络设置原因或者安全因素，构建服务器不能连接远程仓库的时候，该配置就十分有用。

<offline>false</offline>

## PluginGroups ##

作用：当插件的组织id（groupId）没有显式提供时，供搜寻插件组织Id（groupId）的列表。  
该元素包含一个pluginGroup元素列表，每个子元素包含了一个组织Id（groupId）。  
当我们使用某个插件，并且没有在命令行为其提供组织Id（groupId）的时候，Maven就会使用该列表。默认情况下该列表包含了`org.apache.maven.plugins`和`org.codehaus.mojo`。

<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 https://maven.apache.org/xsd/settings-1.0.0.xsd">
      ...
      <pluginGroups>
        
        <pluginGroup>org.codehaus.mojo</pluginGroup>
      </pluginGroups>
      ...
    </settings>

## Servers ##

作用：一般，仓库的下载和部署是在pom.xml文件中的`repositories`和`distributionManagement`元素中定义的。然而，一般类似用户名、密码（有些仓库访问是需要安全认证的）等信息不应该在pom.xml文件中配置，这些信息可以配置在`settings.xml`中。

<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 https://maven.apache.org/xsd/settings-1.0.0.xsd">
      ...
      
      <servers>
        
        <server>
          
          <id>server001</id>
          
          <username>my_login</username>
          
          <password>my_password</password>
          
          <privateKey>${usr.home}/.ssh/id_dsa</privateKey>
          
          <passphrase>some_passphrase</passphrase>
          
          <filePermissions>664</filePermissions>
          
          <directoryPermissions>775</directoryPermissions>
        </server>
      </servers>
      ...
    </settings>

## Mirrors ##

作用：为仓库列表配置的下载镜像列表。

<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 https://maven.apache.org/xsd/settings-1.0.0.xsd">
      ...
      <mirrors>
        
        <mirror>
          
          <id>planetmirror.com</id>
          
          <name>PlanetMirror Australia</name>
          
          <url>http://downloads.planetmirror.com/pub/maven2</url>
          
          <mirrorOf>central</mirrorOf>
        </mirror>
      </mirrors>
      ...
    </settings>

## Proxies ##

作用：用来配置不同的代理。

<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 https://maven.apache.org/xsd/settings-1.0.0.xsd">
      ...
      <proxies>
        
        <proxy>
          
          <id>myproxy</id>
          
          <active>true</active>
          
          <protocol>http</protocol>
          
          <host>proxy.somewhere.com</host>
          
          <port>8080</port>
          
          <username>proxyuser</username>
          
          <password>somepassword</password>
          
          <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts>
        </proxy>
      </proxies>
      ...
    </settings>

## Profiles ##

作用：根据环境参数来调整构建配置的列表。  
`settings.xml`中的`profile`元素是`pom.xml`中`profile`元素的裁剪版本。  
它包含了`id`、`activation`、`repositories`、`pluginRepositories`和 `properties`元素。这里的profile元素只包含这五个子元素是因为这里只关心构建系统这个整体（这正是settings.xml文件的角色定位），而非单独的项目对象模型设置。如果一个`settings.xml`中的`profile`被激活，它的值会覆盖任何其它定义在`pom.xml`中带有相同id的`profile`。

### Activation ###

作用：自动触发`profile`的条件逻辑。  
如`pom.xml`中的`profile`一样，`profile`的作用在于它能够在某些特定的环境中自动使用某些特定的值；这些环境通过`activation`元素指定。  
`activation`元素并不是激活`profile`的唯一方式。`settings.xml`文件中的`activeProfile`元素可以包含`profile`的`id`。`profile`也可以通过在命令行，使用-P标记和逗号分隔的列表来显式的激活（如，-P test）。

<activation>
      
      <activeByDefault>false</activeByDefault>
      
      <jdk>1.5</jdk>
      
      <os>
        
        <name>Windows XP</name>
        
        <family>Windows</family>
        
        <arch>x86</arch>
        
        <version>5.1.2600</version>
      </os>
      
      <property>
        
        <name>mavenVersion</name>
        
        <value>2.0.3</value>
      </property>
      
      <file>
        
        <exists>${basedir}/file2.properties</exists>
        
        <missing>${basedir}/file1.properties</missing>
      </file>
    </activation>

注：在maven工程的pom.xml所在目录下执行`mvn help:active-profiles`命令可以查看中央仓储的profile是否在工程中生效。

### properties ###

作用：对应`profile`的扩展属性列表。  
maven属性和ant中的属性一样，可以用来存放一些值。这些值可以在`pom.xml`中的任何地方使用标记`${X}`来使用，这里X是指属性的名称。属性有五种不同的形式，并且都能在settings.xml文件中访问。

<properties>
      <user.install>${user.home}/our-project</user.install>
    </properties>

注：如果该profile被激活，则可以在`pom.xml`中使用$\{user.install\}。

### Repositories ###

作用：远程仓库列表，它是maven用来填充构建系统本地仓库所使用的一组远程仓库。

<repositories>
      
      <repository>
        
        <id>codehausSnapshots</id>
        
        <name>Codehaus Snapshots</name>
        
        <releases>
          
          <enabled>false</enabled>
          
          <updatePolicy>always</updatePolicy>
          
          <checksumPolicy>warn</checksumPolicy>
        </releases>
        
        <snapshots>
          <enabled />
          <updatePolicy />
          <checksumPolicy />
        </snapshots>
        
        <url>http://snapshots.maven.codehaus.org/maven2</url>
        
        <layout>default</layout>
      </repository>
    </repositories>

### pluginRepositories ###

作用：发现插件的远程仓库列表。  
和`repository`类似，只是`repository`是管理jar包依赖的仓库，`pluginRepositories`则是管理插件的仓库。  
maven插件是一种特殊类型的构件。由于这个原因，插件仓库独立于其它仓库。`pluginRepositories`元素的结构和`repositories`元素的结构类似。每个`pluginRepository`元素指定一个Maven可以用来寻找新插件的远程地址。

## ActiveProfiles ##

作用：手动激活profiles的列表，按照`profile`被应用的顺序定义`activeProfile`。  
该元素包含了一组`activeProfile`元素，每个`activeProfile`都含有一个profile id。任何在`activeProfile`中定义的profile id，不论环境设置如何，其对应的 `profile`都会被激活。如果没有匹配的`profile`，则什么都不会发生。  
例如，env-test是一个activeProfile，则在pom.xml（或者profile.xml）中对应id的profile会被激活。如果运行过程中找不到这样一个profile，Maven则会像往常一样运行。

至此，maven settings.xml中的标签都讲解完毕，希望对大家有所帮助。

# 一.Maven的setting配置文件 和 在Eclipse中对Maven的正确配置。 #

### 1.Maven的配置文件（Maven的安装目录/conf/settings.xml ） 和 Maven仓库下（默认的Maven仓库的是用户家目录下的.m2文件，可以另行制定）的settings.xml文件 ###

在Maven中提供了一个settings.xml文件来定义Maven的全局环境信息。这个文件会存在于Maven的安装目录的conf子目录下面，或者是用户家目录的.m2子目录下面。我们可以通过这个文件来定义本地仓库、远程仓库和联网使用的代理信息等。

其实相对于多用户的PC机而言，在Maven安装目录的conf子目录下面的settings.xml才是真正的全局的配置。而用户家目录的.m2子目录下面的settings.xml的配置只是针对当前用户的。

当这两个文件同时存在的时候，那么对于相同的配置信息用户家目录下面的settings.xml中定义的会覆盖Maven安装目录下面的settings.xml中的定义。

用户家目录下的settings.xml文件一般是不存在的，但是Maven允许我们在这里定义我们自己的settings.xml，如果需要在这里定义我们自己的settings.xml的时候就可以把Maven安装目录下面的settings.xml文件拷贝到用户家目录的.m2目录下，然后改成自己想要的样子。

### 2.在Eclipse中正确的配置Maven（此处我的Maven仓库由默认的用户家目录下的.m2文件改成了F:\\Development\\m2\\repository） ###

博客园编辑器对图片的显示有压缩,看高清大图请点击:[/images/20220605/66fee60729a14ed0b11ae7ee7201d19c.png][http_images2017.cnblogs.com_blog_610238_201710_610238-20171014114125668-433293838.png]

![http_images2017.cnblogs.com_blog_610238_201710_610238-20171014114125668-433293838.png][]

# 二.settings.xml文件中对应的配置项 #

先来看看一个基本的settings.xml文件中的内容:（如果使用默认的settings.xml文件很多配置多都注释掉了,只有一个<localRepository>，此处该settings.xml文件进行了一些其他配置）

![复制代码][copycode.gif]

<?xml version="1.0" encoding="UTF-8"?>
    <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>D:\\develop\\mavenRepository</localRepository>
      <interactiveMode>true</interactiveMode>
      <offline>false</offline>
      <pluginGroups>
     
      </pluginGroups>
     
      <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>
     
      <servers>
        <server>
          <id>deploymentRepo</id>
          <username>repouser</username>
          <password>repopwd</password>
        </server>
      </servers>
     
      <mirrors>
        <mirror>
          <id>mirrorId</id>
          <mirrorOf>repositoryId</mirrorOf>
          <name>Human Readable Name for this Mirror.</name>
          <url>http://my.repository.com/repo/path</url>
        </mirror>
      </mirrors>
     
      <profiles>
        <profile>
          <id>jdk-1.5</id>
          <activation>
            <jdk>1.5</jdk>
          </activation>
          <repositories>
            <repository>
              <id>jdk15</id>
              <name>jdk1.5</name>
              <url>http://www.myhost.com/maven/jdk15</url>
              <layout>default</layout>
              <snapshotPolicy>always</snapshotPolicy>
            </repository>
          </repositories>
        </profile>
      </profiles>
      <activeProfiles>
        <activeProfile>jdk-1.5</activeProfile>
      </activeProfiles>
    </settings>

![复制代码][copycode.gif]

## settings.xml中主要包括以下元素： ##

## 1.localRepository： ##

表示Maven用来在本地储存信息的本地仓库的目录。默认是用户家目录下面的.m2/repository目录。

## 2.interactiveMode： ##

表示是否使用交互模式，默认是true；如果设为false，那么当Maven需要用户进行输入的时候，它会使用一个默认值。

## 3.offline： ##

表示是否离线，默认是false。这个属性表示在Maven进行项目编译和部署等操作时是否允许Maven进行联网来下载所需要的信息。

## 4.pluginGroups： ##

在pluginGroups元素下面可以定义一系列的pluginGroup元素。表示当通过plugin的前缀来解析plugin的时候到哪里寻找。pluginGroup元素指定的是plugin的groupId。默认情况下，Maven会自动把org.apache.maven.plugins和org.codehaus.mojo添加到pluginGroups下。

## 5.proxies： ##

其下面可以定义一系列的proxy子元素，表示Maven在进行联网时需要使用到的代理。当设置了多个代理的时候第一个标记active为true的代理将会被使用。下面是一个使用代理的例子：

![复制代码][copycode.gif]

<proxies>
      <proxy>
          <id>xxx</id>
          <active>true</active>
          <protocol>http</protocol>
          <username>用户名</username>
          <password>密码</password>
          <host>代理服务器地址</host>
          <port>代理服务器的端口</port>
          <nonProxyHosts>不使用代理的主机</nonProxyHosts>
      </proxy>
    </proxies>

![复制代码][copycode.gif]

## 6.servers： ##

其下面可以定义一系列的server子元素，表示当需要连接到一个远程服务器的时候需要使用到的验证方式。这主要有username/password和privateKey/passphrase这两种方式。以下是一个使用servers的示例：

![复制代码][copycode.gif]

![复制代码][copycode.gif]

## 7.mirrors： ##

用于定义一系列的远程仓库的镜像。我们可以在pom中定义一个下载工件的时候所使用的远程仓库。但是有时候这个远程仓库会比较忙，所以这个时候人们就想着给它创建镜像以缓解远程仓库的压力，也就是说会把对远程仓库的请求转换到对其镜像地址的请求。每个远程仓库都会有一个id，这样我们就可以创建自己的mirror来关联到该仓库，那么以后需要从远程仓库下载工件的时候Maven就可以从我们定义好的mirror站点来下载，这可以很好的缓解我们远程仓库的压力。在我们定义的mirror中每个远程仓库都只能有一个mirror与它关联，也就是说你不能同时配置多个mirror的mirrorOf指向同一个repositoryId。

看以下是一个使用mirrors的例子：

![复制代码][copycode.gif]

<mirrors>
        <mirror>
          <id>mirrorId</id>
          <mirrorOf>repositoryId</mirrorOf>
          <name>定义一个容易看懂的名称 </name>
          <url>http://my.repository.com/repo/path</url>
        </mirror>
    </mirrors>

![复制代码][copycode.gif]

### 　　1> id： ###

是用来区别mirror的，所有的mirror不能有相同的id

### 　　2> mirrorOf： ###

用来表示该mirror是关联的哪一个仓库，其值为其关联仓库的id。当要同时关联多个仓库时，这多个仓库之间可以用逗号隔开；当要关联所有的仓库时，可以使用“\*”表示；当要关联除某一个仓库以外的其他所有仓库时，可以表示为“\*,!repositoryId”；当要关联不是localhost或用file请求的仓库时，可以表示为“external:\*”。

### 　　3> url： ###

表示该镜像的url。当Maven在建立系统的时候就会使用这个url来连接到我们的远程仓库。

## 8.profiles： ##

用于指定一系列的profile。profile元素由activation、repositories、pluginRepositories和properties四个元素组成。当一个profile在settings.xml中是处于活动状态并且在pom.xml中定义了一个相同id的profile时，settings.xml中的profile会覆盖pom.xml中的profile。

### 　　1> activation： ###

这是profile中最重要的元素。跟pom.xml中的profile一样，settings.xml中的profile也可以在特定环境下改变一些值，而这些环境是通过activation元素来指定的。

看下面一个例子：

![复制代码][copycode.gif]

<profiles>
        <profile>
          <id>test</id>
          <activation>
            <activeByDefault>false</activeByDefault>
            <jdk>1.6</jdk>
            <os>
              <name>Windows 7</name>
              <family>Windows</family>
              <arch>x86</arch>
              <version>5.1.2600</version>
            </os>
            <property>
              <name>mavenVersion</name>
              <value>2.0.3</value>
            </property>
            <file>
              <exists>${basedir}/file2.properties</exists>
              <missing>${basedir}/file1.properties</missing>
            </file>
          </activation>
          ...
        </profile>
      </profiles>

![复制代码][copycode.gif]

在上面这段代码中，当所有的约束条件都满足的时候就会激活这个profile。

jdk：表示当jdk的版本满足条件的时候激活，在这里是1.6。这里的版本还可以用一个范围来表示，如

<jdk>\[1.4,1.7)</jdk>表示1.4、1.5和1.6满足；

<jdk>\[1.4,1.7\]</jdk>表示1.4、1.5、1.6和1.7满足；

os：表示当操作系统满足条件的时候激活。

property：property是键值对的形式，表示当Maven检测到了这样一个键值对的时候就激活该profile。

①下面的示例表示当存在属性hello的时候激活该profile。

<property>
           <name>hello</name>
    </property>

②下面的示例表示当属性hello的值为world的时候激活该profile。

<property>
           <name>hello</name>
           <value>world</value>
    </property>

这个时候如果要激活该profile的话，可以在调用Maven指令的时候加上参数hello并指定其值为world，如：mvn compile –Dhello=world

### 　　2>file： ###

表示当文件存在或不存在的时候激活，exists表示存在，missing表示不存在。如下面的例子表示当文件hello/world不存在的时候激活该profile。

![复制代码][copycode.gif]

<profile>
           <activation>
                  <file>
                         <missing>hello/world</missing>
                  </file>
           </activation>
    </profile>

![复制代码][copycode.gif]

### 　　3>activeByDefault： ###

当其值为true的时候表示如果没有其他的profile处于激活状态的时候，该profile将自动被激活。

### 　　4>properties： ###

用于定义属性键值对的。当该profile是激活状态的时候，properties下面指定的属性都可以在pom.xml中使用。

### 　　5>repositories： ###

用于定义远程仓库的，当该profile是激活状态的时候，这里面定义的远程仓库将作为当前pom的远程仓库。

![复制代码][copycode.gif]

<repositories>
            <repository>
              <id>codehausSnapshots</id>
              <name>Codehaus Snapshots</name>
              <releases>
                <enabled>false</enabled>
                <updatePolicy>always</updatePolicy>
                <checksumPolicy>warn</checksumPolicy>
              </releases>
              <snapshots>
                <enabled>true</enabled>
                <updatePolicy>never</updatePolicy>
                <checksumPolicy>fail</checksumPolicy>
              </snapshots>
              <url>http://snapshots.maven.codehaus.org/maven2</url>
              <layout>default</layout>
            </repository>
          </repositories>

![复制代码][copycode.gif]

releases、snapshots：这是对于工件的类型的限制。

enabled：表示这个仓库是否允许这种类型的工件

updatePolicy：表示多久尝试更新一次。可选值有always、daily、interval:minutes（表示每多久更新一次）和never。

checksumPolicy：当Maven在部署项目到仓库的时候会连同校验文件一起提交，checksumPolicy表示当这个校验文件缺失或不正确的时候该如何处理，可选项有ignore、fail和warn。

###        6>pluginRepositories： ###

在Maven中有两种类型的仓库，一种是存储工件的仓库，另一种就是存储plugin插件的仓库。pluginRepositories的定义和repositories的定义类似，它表示Maven在哪些地方可以找到所需要的插件。

## 9.activeProfiles： ##

底包含一系列的activeProfile元素，表示对于所有的pom都处于活跃状态的profile。如：

<activeProfiles>
        <activeProfile>alwaysActiveProfile</activeProfile>
        <activeProfile>anotherAlwaysActiveProfile</activeProfile>
      </activeProfiles>

[985599-20160925170607744-2119735801.png]: http://images2015.cnblogs.com/blog/985599/201609/985599-20160925170607744-2119735801.png
[985599-20160925172027367-390461291.png]: http://images2015.cnblogs.com/blog/985599/201609/985599-20160925172027367-390461291.png
[985599-20160925172230813-468127317.png]: http://images2015.cnblogs.com/blog/985599/201609/985599-20160925172230813-468127317.png
[985599-20160925172923404-1265994932.png]: http://images2015.cnblogs.com/blog/985599/201609/985599-20160925172923404-1265994932.png
[copycode.gif]: /images/20220605/74e4a2a7f13c453b88a226d9acddd092.png
[985599-20160925173727985-1628996985.png]: http://images2015.cnblogs.com/blog/985599/201609/985599-20160925173727985-1628996985.png
[985599-20160925173810426-273158137.png]: http://images2015.cnblogs.com/blog/985599/201609/985599-20160925173810426-273158137.png
[985599-20160925173903195-29932328.png]: http://images2015.cnblogs.com/blog/985599/201609/985599-20160925173903195-29932328.png
[985599-20160925174036295-1205981750.png]: /images/20220605/110decc1ad5c4cf2b072162cc04fc259.png
[view plain]: http://blog.csdn.net/u012152619/article/details/51485152#
[Paste_Image.png]: /images/20220605/4a3adf3bf9a345dbbe57f4f6d0eab5b3.png
[http_images2017.cnblogs.com_blog_610238_201710_610238-20171014114125668-433293838.png]: /images/20220605/66fee60729a14ed0b11ae7ee7201d19c.png