Maven settings.xml 配置详解

小咪咪 2022-08-02 09:55 142阅读 0赞

文件存放位置

全局配置: $\{M2\_HOME\}/conf/settings.xml

用户配置: $\{user.home\}/.m2/settings.xml

note：用户配置优先于全局配置。$\{user.home\} 和和所有其他系统属性只能在3.0+版本上使用。请注意windows和Linux使用变量的区别。

# settings.xml详解 #

## 声明规范 ##

<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="[http://maven.apache.org/POM/4.0.0][http_maven.apache.org_POM_4.0.0]" xmlns:xsi="[http://www.w3.org/2001/XMLSchema-instance][http_www.w3.org_2001_XMLSchema-instance]"

xsi:schemaLocation="[http://maven.apache.org/POM/4.0.0][http_maven.apache.org_POM_4.0.0] [http://maven.apache.org/xsd/settings-1.0.0.xsd][http_maven.apache.org_xsd_settings-1.0.0.xsd]">

## localRepository ##

<localRepository>usr/local/maven</localRepository>

## interactiveMode ##

## usePluginRegistry ##

<usePluginRegistry>false</usePluginRegistry>

## offline ##

<offline>false</offline>

## pluginGroups ##

<pluginGroup>org.codehaus.mojo</pluginGroup>

</pluginGroups>

## proxies ##

<proxy>

<id>myproxy</id>

<host>proxy.somewhere.com</host>

<username>proxyuser</username>

<password>somepassword</password>

<nonProxyHosts>\*.google.com|ibiblio.org</nonProxyHosts>

</proxy>

</proxies>

## servers ##

<id>server001</id>

<username>my\_login</username>

<password>my\_password</password>

<passphrase>some\_passphrase</passphrase>

</server>

</servers>

## mirrors ##

<id>planetmirror.com</id>

<name>PlanetMirror Australia</name>

<url>http://downloads.planetmirror.com/pub/maven2</url>

<mirrorOf>central</mirrorOf>

</mirror>

</mirrors>

## profiles ##

### Activation ###

<activeByDefault>false</activeByDefault>

<os>

<name>Windows XP</name>

<family>Windows</family>

</os>

<name>mavenVersion</name>

</property>

<file>

<exists>$\{basedir\}/file2.properties</exists>

<missing>$\{basedir\}/file1.properties</missing>

</file>

</activation>

### Properties ###

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

1. env.X: 在一个变量前加上"env."的前缀，会返回一个shell环境变量。例如,"env.PATH"指代了$path环境变量（在Windows上是%PATH%）。

2. project.x：指代了POM中对应的元素值。例如: <project><version>1.0</version></project>通过$\{project.version\}获得version的值。

3. settings.x: 指代了settings.xml中对应元素的值。例如：<settings><offline>false</offline></settings>通过 $\{settings.offline\}获得offline的值。

4. Java System Properties: 所有可通过java.lang.System.getProperties()访问的属性都能在POM中使用该形式访问，例如 $\{java.home\}。

5. x: 在<properties/>元素中，或者外部文件中设置，以$\{someVar\}的形式使用。 -->

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

</properties>

note：如果该profile被激活，则可以再POM中使用$\{user.install\}。

### Repositories ###

<id>codehausSnapshots</id>

<name>Codehaus Snapshots</name>

<enabled>false</enabled>

<updatePolicy>always</updatePolicy>

</releases>

</snapshots>

<url>http://snapshots.maven.codehaus.org/maven2</url>

<layout>default</layout>

</repository>

</repositories>

</releases>

</snapshots>

</pluginRepository>

</pluginRepositories>

</profile>

</profiles>

## activeProfiles ##

<!--手动激活profiles的列表，按照profile被应用的顺序定义activeProfile。 该元素包含了一组activeProfile元素，每个activeProfile都含有一个profile id。任何在activeProfile中定义的profile id，不论环境设置如何，其对应的

profile都会被激活。如果没有匹配的profile，则什么都不会发生。例如，env-test是一个activeProfile，则在pom.xml（或者profile.xml）中对应id的profile会被激活。如果运行过程中找不到这样一个profile，Maven则会像往常一样运行。 -->

</activeProfiles>

</settings>

<!--参考文献：

https://maven.apache.org/settings.html

http://pengqb.iteye.com/blog/825401

\-->

转：http://www.cnblogs.com/zz0412/p/Maven\_settings.html

[http_maven.apache.org_POM_4.0.0]: http://maven.apache.org/POM/4.0.0
[http_www.w3.org_2001_XMLSchema-instance]: http://www.w3.org/2001/XMLSchema-instance
[http_maven.apache.org_xsd_settings-1.0.0.xsd]: http://maven.apache.org/xsd/settings-1.0.0.xsd
[Link 1]: https://maven.apache.org/guides/mini/guide-encryption.html
[Link 2]: https://maven.apache.org/guides/mini/guide-mirror-settings.html