简介

基于检测到的或用户提供的环境参数，项目本地覆盖构建过程。这是 ${basedir}/profiles.xml 的模型规范。 

<profilesXml>
  <profiles>
    <profile>
      <id/>
      <activation>
        <activeByDefault/>
        <jdk/>
        <os>
          <name/>
          <family/>
          <arch/>
          <version/>
        </os>
        <property>
          <name/>
          <value/>
        </property>
        <file>
          <missing/>
          <exists/>
        </file>
      </activation>
      <properties>
        <key>value</key>
      <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>
    </profile>
  </profiles>
  <activeProfiles/>
</profilesXml>

配置文件Xml

profile.xml 文件的根元素。

元素 类型 描述
profiles/profile* List<Profile> （许多） 构建配置文件的配置，用于根据环境参数调整构建
activeProfiles/activeProfile* List<String> （许多） 手动激活的构建配置文件列表，按照应用它们的顺序指定。

轮廓

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

元素 类型 描述
id String 此构建配置文件的 ID，用于激活目的。
activation Activation 将自动触发包含此配置文件的条件逻辑。
properties/key=value* Properties （许多）特定于此配置文件的扩展配置在这里。
repositories/repository* List<Repository> （许多）远程存储库的列表
pluginRepositories/pluginRepository* List<Repository> （许多） 用于发现插件的远程存储库列表

激活

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

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

操作系统

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

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

财产

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

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

文件

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

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

存储库

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

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

发布

下载政策

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

快照

下载政策

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

插件库

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

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