设置

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

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

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

XSD 可在以下位置获得：

<settings>
  <localRepository/>
  <interactiveMode/>
  <usePluginRegistry/>
  <offline/>
  <proxies>
    <proxy>
      <active/>
      <protocol/>
      <username/>
      <password/>
      <port/>
      <host/>
      <nonProxyHosts/>
      <id/>
    </proxy>
  </proxies>
  <servers>
    <server>
      <username/>
      <password/>
      <privateKey/>
      <passphrase/>
      <filePermissions/>
      <directoryPermissions/>
      <configuration/>
      <id/>
    </server>
  </servers>
  <mirrors>
    <mirror>
      <mirrorOf/>
      <name/>
      <url/>
      <id/>
    </mirror>
  </mirrors>
  <profiles>
    <profile>
      <activation>
        <activeByDefault/>
        <jdk/>
        <os>
          <name/>
          <family/>
          <arch/>
          <version/>
        </os>
        <property>
          <name/>
          <value/>
        </property>
        <file>
          <missing/>
          <exists/>
        </file>
      </activation>
      <properties/>
      <repositories>
        <repository>
          <releases>
            <enabled/>
            <updatePolicy/>
            <checksumPolicy/>
          </releases>
          <snapshots>
            <enabled/>
            <updatePolicy/>
            <checksumPolicy/>
          </snapshots>
          <id/>
          <name/>
          <url/>
          <layout/>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <releases>
            <enabled/>
            <updatePolicy/>
            <checksumPolicy/>
          </releases>
          <snapshots>
            <enabled/>
            <updatePolicy/>
            <checksumPolicy/>
          </snapshots>
          <id/>
          <name/>
          <url/>
          <layout/>
        </pluginRepository>
      </pluginRepositories>
      <id/>
    </profile>
  </profiles>
  <activeProfiles/>
  <pluginGroups/>
</settings>

设置

用户配置文件的根元素。

元素 描述
localRepository 本地存储库。
interactiveMode Maven 是否应该尝试与用户交互以获取输入。默认值为true。
usePluginRegistry Maven 是否应该使用 plugin-registry.xml 文件来管理插件版本。默认值为false。
offline 指示 maven 是否应该在离线模式下全职运行。默认值为false。
proxies 不同代理配置文件的配置。对于在笔记本电脑或其他移动平台上工作的任何人来说，多个代理配置文件可能会派上用场，以便通过简单地指定配置文件 ID 来轻松切换整个代理配置，同样可以从命令行或下面的默认部分。
servers 服务器特定设置的配置，主要是身份验证方法。这允许在每个服务器的基础上配置身份验证。
mirrors 为存储库配置下载镜像。
profiles 配置构建配置文件以根据环境参数调整构建。
activeProfiles 手动激活的构建配置文件列表，按应用顺序指定。
pluginGroups 未明确提供插件 groupId 时搜索插件的 groupId 列表。

代理

该<proxy>元素包含代理设置所需的信息。

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

服务器

该<server>元素包含服务器设置所需的信息。

元素 描述
username 用于身份验证的用户名。
password 与用户名一起使用的密码进行身份验证。
privateKey 用于身份验证的私钥位置。
passphrase 与 privateKey 结合使用的密码进行身份验证。
filePermissions 创建文件时的权限。
directoryPermissions 创建目录时的权限。
configuration 传输层的额外配置。
id 没有说明。默认值为default。

镜子

给定存储库的下载镜像。

元素 描述
mirrorOf 被镜像的存储库的服务器 ID，例如“中央”。这不能与镜像 ID 匹配。
name 描述镜像的可选名称。
url 镜像仓库的 URL。
id 没有说明。默认值为default。

轮廓

以某种环境参数为关键的构建过程的修改。

元素 描述
activation 将自动触发包含此配置文件的条件逻辑。
properties 特定于此配置文件的扩展配置位于此处。内容形式为 适当的价值
repositories 远程存储库的列表。
pluginRepositories 用于发现插件的远程存储库列表。
id 没有说明。默认值为default。

激活

构建运行时环境中将触发自动包含父构建配置文件的条件。

元素 描述
activeByDefault 指定此配置文件是否作为默认活动的标志。默认值为false。
jdk 指定在检测到匹配的 JDK 时激活此配置文件。
os 指定在检测到匹配的操作系统属性时激活此配置文件。
property 指定在指定此系统属性时将激活此配置文件。
file 指定将根据文件的存在激活此配置文件。

操作系统

这是一个激活器，它将检测操作系统的属性以激活其配置文件。

元素 描述
name 用于激活配置文件的操作系统的名称。
family 用于激活配置文件的一般操作系统系列（例如“windows”）
arch 用于激活配置文件的操作系统架构。
version 用于激活配置文件的操作系统版本。

财产

这是用于激活配置文件的属性规范。如果 value 字段为空，则命名属性的存在将激活配置文件，否则它也会对属性值进行区分大小写的匹配。

元素 描述
name 用于激活配置文件的属性名称。
value 用于激活配置文件的属性值。

文件

这是用于激活配置文件的文件规范。缺少的值将是需要存在的文件的位置，如果不存在，则必须运行配置文件。另一方面，exists 将测试文件是否存在，如果存在将运行配置文件。

元素 描述
missing 激活配置文件时应该缺少的文件的名称。
exists 应该存在以激活配置文件的文件的名称。

存储库

存储库包含与远程存储库建立连接所需的信息

元素 描述
releases 如何处理从此存储库下载版本
snapshots 如何处理从此存储库下载快照
id 存储库的唯一标识符。
name 存储库的人类可读名称。
url 存储库的 url。
layout 此存储库用于定位和存储工件的布局类型 - 可以是“旧版”或“默认”。默认值为default。

发布

下载政策

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

快照

下载政策

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

插件库

存储库包含与远程存储库建立连接所需的信息

元素 描述
releases 如何处理从此存储库下载版本
snapshots 如何处理从此存储库下载快照
id 存储库的唯一标识符。
name 存储库的人类可读名称。
url 存储库的 url。
layout 此存储库用于定位和存储工件的布局类型 - 可以是“旧版”或“默认”。默认值为default。

发布

下载政策

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

快照

下载政策

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