详解Maven用户的配置settings.xml

Maven用户设置

作者其他技术文章

1）Oracle性能优化之查询语句通用原则  

2）Redis常用命令

3) SpringCloud入门之常用的配置文件 application.yml和 bootstrap.yml区别

4）#ifndef、#def、#endif说明

这是一份Maven的特定于用户的配置的参考。

包括不应与pom.xml文件一起分发的内容，例如开发人员身份，以及本地设置，如代理信息。

设置文件的默认位置是〜/ .m2 / settings.xml

1. <settings xmlns="http://maven.apache.org/SETTINGS/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
2. xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd">
3. <localRepository/>
4. <interactiveMode/>
5. <usePluginRegistry/>
6. <offline/>
7. <proxies>
8. <proxy>
9. <active/>
10. <protocol/>
11. <username/>
12. <password/>
13. <port/>
14. <host/>
15. <nonProxyHosts/>
16. <id/>
17. </proxy>
18. </proxies>
19. <servers>
20. <server>
23. <privateKey/>
24. <passphrase/>
25. <filePermissions/>
26. <directoryPermissions/>
27. <configuration/>
29. </server>
30. </servers>
31. <mirrors>
32. <mirror>
33. <mirrorOf/>
34. <name/>
35. <url/>
36. <layout/>
37. <mirrorOfLayouts/>
39. </mirror>
40. </mirrors>
41. <profiles>
42. <profile>
43. <activation>
44. <activeByDefault/>
45. <jdk/>
46. <os>
48. <family/>
49. <arch/>
50. <version/>
51. </os>
52. <property>
54. <value/>
55. </property>
56. <file>
57. <missing/>
58. <exists/>
59. </file>
60. </activation>
61. <properties>
62. <key>value</key>
63. </properties>
64. <repositories>
65. <repository>
66. <releases>
67. <enabled/>
68. <updatePolicy/>
69. <checksumPolicy/>
70. </releases>
71. <snapshots>
75. </snapshots>
80. </repository>
81. </repositories>
82. <pluginRepositories>
83. <pluginRepository>
98. </pluginRepository>
99. </pluginRepositories>
101. </profile>
102. </profiles>
103. <activeProfiles/>
104. <pluginGroups/>
105. </settings>

settings-Maven的用户配置文件settings.xml的根元素。

Element	Type	Description
localRepository	String	Maven本地存储库。 默认值为： $ {user.home} /.m2 / repository
interactiveMode	boolean	Maven是否应该尝试与用户进行交互以进行输入。 默认值为：true。
usePluginRegistry		Maven是否应该使用plugin-registry.xml文件来管理插件版本。 默认值为：false。
offline		指示maven是否应该在离线模式下运行。
proxies/proxy*	List<Proxy>	（多个）配置不同的代理配置文件。对于使用笔记本电脑或其他移动平台工作的任何人来说，多个代理配置文件可能会派上用场，只需从命令行或从下面的默认部分指定配置文件ID，即可轻松切换整个代理配置。
servers/server*	List<Server>	（很多）Maven配置服务器特定的设置，主要是身份验证方法。这允许基于每个服务器配置身份验证。
mirrors/mirror*	List<Mirror>	（很多）Maven配置存储库的下载镜像。
profiles/profile*	List<Profile>	（许多）Maven构建配置文件的配置，用于根据环境参数调整构建。
activeProfiles/activeProfile*	List<String>	（多个）Maven手动激活的构建配置文件列表，按照应用顺序指定。
pluginGroups/pluginGroup*		（很多）Maven当没有明确提供插件groupId时，要搜索插件的groupId列表。

proxy

Maven的用户配置文件settings.xml的<proxy>元素包含代理设置所需的信息。

active		Maven此代理配置是否为活动配置。
protocol		Maven代理协议。 默认值为：http。
username		Maven代理用户。
password		Maven代理密码。
port	int	Maven代理端口。 默认值为：8080。
host		Maven代理主机。
nonProxyHosts		Maven非代理主机列表（由|分隔）。
id		没有说明。 Maven默认值为：default。

server

Maven的用户配置文件settings.xml的<server>元素包含服务器设置所需的信息。

		Maven用于验证的用户名。
		与用户名一起使用的密码进行身份验证。
privateKey		Maven用于进行身份验证的私钥位置。
passphrase		Maven密码与privateKey一起使用以进行身份验证。
filePermissions		Maven文件创建时的权限。
directoryPermissions		Maven创建目录时的目录权限。
configuration	DOM	Maven传输层的额外配置。
ID

mirror

Maven的用户配置文件settings.xml的<mirror>,存储库的下载镜像配置。

mirrorOf		Maven镜像存储库的服务器ID，例如“central”。这必须与镜像id不匹配。
name		Maven描述镜像的可选名称。
url		Maven镜像存储库的URL。
layout		Maven镜像存储库的布局。由于Maven 3.  默认值为：default。
mirrorOfLayouts		Maven存储库的布局是镜像的。此值可用于将镜像的使用限制为具有匹配布局的存储库（除了匹配的ID）。自Maven 3.  默认值为：default，legacy。

profile

Maven的用户配置文件settings.xml的<profile>,构建过程的定义，该过程以某种环境参数为基础。

activation	Activation	Maven条件逻辑将自动触发包含此配置文件。
properties/key=value*	Properties	（很多）Maven特定于此配置文件的扩展配置在这里。内容采用 <property.name> property.value </property.name>的形式
repositories/repository*	List<Repository>	（很多）Maven远程存储库的列表。
pluginRepositories/pluginRepository*		（很多）Maven用于发现插件的远程存储库列表。

Maven的用户配置文件settings.xml的<activation>,构建运行时环境条件将触发自动包含父构建概要文件。

activeByDefault		Maven标记此配置文件是否作为默认值处于活动状态。
jdk		Maven指定在检测到匹配的JDK时将激活此配置文件。
os	ActivationOS	Maven指定在检测到匹配的OS属性时将激活此配置文件。
property	ActivationProperty	Maven指定在指定此System属性时将激活此配置文件。
file	ActivationFile	Maven指定将根据文件的存在激活此配置文件。

Maven的用户配置文件settings.xml的<OS>,这是一个激活配置，它将检测操作系统的属性以激活其配置文件。

		Maven用于激活配置文件的OS的名称。
family		Maven用于激活配置文件的OS的一般系列（例如'windows'）
arch		Maven用于激活配置文件的OS的体系结构。
version		Maven用于激活配置文件的OS版本。

Maven的用户配置文件settings.xml的<Property>,这是用于激活配置文件的属性规范。如果value字段为空，则named属性的存在将激活配置文件，否则它也会对属性值进行区分大小写的匹配。

		Maven用于激活配置文件的属性的名称。
Value		Maven用于激活配置文件的属性的值。

Maven的用户配置文件settings.xml的<file>,这是用于激活配置文件的文件规范。默认值将是需要存在的文件的位置，如果不存在，则必须运行该配置文件。另一方面，exists将测试文件是否存在，如果存在则将运行配置文件。

missing		Maven激活配置文件时应该缺少的文件名。
exists		Maven激活配置文件时应存在的文件的名称。

repository

Maven的用户配置文件settings.xml的<repository>,存储库包含与远程存储库建立连接所需的信息

releases	RepositoryPolicy	Maven如何处理从此存储库下载的版本
snapshots		Maven如何处理从此存储库下载快照
		Maven存储库的唯一标识符。
		Maven友好可读的存储库名称。
		Maven存储库的URL。
		Maven此存储库用于定位和存储工件的布局类型 - 可以是“遗留”或“默认”。

Maven的用户配置文件settings.xml的<releases>,下载策略

enabled		Maven是否使用此存储库下载此类工件。
updatePolicy		Maven下载更新的频率 - 可以是“始终”，“每天”（默认），“间隔：XXX”（以分钟为单位）或“从不”（仅当它本地不存在时）。
checksumPolicy		Maven验证工件校验和失败时该怎么办 - 警告，失败等。有效值为“失败”或“警告”。

Maven的用户配置文件settings.xml的<snapshots>,下载策略

pluginRepository

Maven的用户配置文件settings.xml的<pluginRepository>,存储库包含与远程存储库建立连接所需的信息

		人类可读的存储库名称。

分类: java,SpringCloud