詳解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