Maven settings.xml配置详解

╰半橙微兮° 2022-06-06 10:15 777阅读 0赞

# [Maven settings.xml配置详解][Maven settings.xml] #

标签： [maven][][合并][Link 1][操作系统][Link 2][java][][settings][]

2017-05-13 17:01   909人阅读   [评论][Link 3](0)   收藏   [举报][Link 4]

![category_icon.jpg][]   分类：

Maven*（12）* ![arrow_triangle_20_down.jpg][]

目录[(?)][Link 5][\[+\]][Link 5]

## **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。

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

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

## profile节点 ##

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

节点包含了**激活**(**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都会被激活。

[Maven settings.xml]: http://blog.csdn.net/thousa_ho/article/details/71843637
[maven]: http://www.csdn.net/tag/maven
[Link 1]: http://www.csdn.net/tag/%e5%90%88%e5%b9%b6
[Link 2]: http://www.csdn.net/tag/%e6%93%8d%e4%bd%9c%e7%b3%bb%e7%bb%9f
[java]: http://www.csdn.net/tag/java
[settings]: http://www.csdn.net/tag/settings
[Link 3]: http://blog.csdn.net/Thousa_Ho/article/details/71843637#comments
[Link 4]: http://blog.csdn.net/Thousa_Ho/article/details/71843637#report
[category_icon.jpg]: /images/20220606/08452eecef5d46d1a96ae87553afcfe1.png
[arrow_triangle_20_down.jpg]: /images/20220606/c0c37cbf577d425b96f19051f9bd44fd.png
[Link 5]: http://blog.csdn.net/Thousa_Ho/article/details/71843637#