Apache Maven Invoker 插件 - 调用者：运行

调用者：运行

全名：

org.apache.maven.plugins:maven-invoker-plugin:1.9:run

说明：

搜索集成测试 Maven 项目，并执行每个项目，在项目目录中收集日志，并将结果输出到命令行。

属性：

需要执行一个 Maven 项目。
需要对范围内的工件进行依赖解析：test。
目标是线程安全的并支持并行构建。
自版本：1.0。
默认绑定到生命周期阶段：集成测试。

可选参数

姓名	类型	自从	描述
addTestClassPath	`布尔值`	`1.2`	一个标志，被测项目的测试类路径是否应该包含在构建前/构建后脚本的类路径中。如果设置为`false`，则脚本解释器的类路径仅包含Maven Invoker 插件的运行时依赖项。如果设置为 `true`，项目的测试类路径将被添加到解释器类路径中。除其他外，此功能允许脚本从项目的测试源访问实用程序类。默认值为：`false`。用户属性是：`invoker.addTestClassPath`。
克隆所有文件	`布尔值`	`1.2`	将 IT 项目从参数 projectsDirectory 指定的目录复制到 cloneProjectsTo 指定的目录（例如`.svn`、 `CVS`、`~`等）时，通常会排除某些文件。将此参数设置为 `true`将导致将所有文件复制到 cloneProjectsTo 目录。默认值为*：`false`。
克隆清洁	`布尔值`	`1.6`	确保`cloneProjectsTo`目录没有被早期调用程序运行的文件污染。默认值为：`false`。
克隆项目到	`文件`	`1.1`	在执行之前应将项目克隆到的目录。如果未指定，则每个集成测试都将在找到相应 IT POM 的目录中运行。在这种情况下，您很可能希望将 SCM 配置为忽略测试基本目录中的`target`和 `build.log`。
调试	`布尔值`	`1.0`	是否在构建输出中显示调试语句。默认值为：`false`。用户属性是：`invoker.debug`。
禁用报告	`布尔值`	`1.4`	禁用生成报告生成的标志。默认值为：`false`。用户属性是：`invoker.disableReports`。
编码	`细绳`	`1.2`	构建前/构建后脚本的文件编码以及目标和配置文件的列表文件。默认值为：`${project.build.sourceEncoding}`。用户属性是：`编码`。
环境变量	`地图`	`1.8`	要在命令行上设置的其他环境变量。
失败如果没有项目	`布尔值`	`1.9`	如果没有要调用的项目，将其设置为`true会导致失败。` 用户属性是：`invoker.failIfNoProjects`。
过滤器属性	`地图`	`1.3`	将用于过滤 POM 和目标文件中的令牌的附加属性列表。
目标	`列表`	`1.0`	每个项目要执行的目标列表。默认值为： `包`。
目标文件	`细绳`	`1.0`	已弃用。从 1.2 版开始，应该使用参数 `invokerPropertiesFile指定的属性文件中的键invoker.goals 。`默认值为：`goals.txt`。用户属性是：`invoker.goalsFile`。
忽略失败	`布尔值`	`1.3`	控制子构建失败是否也应该使主构建失败的标志。如果设置为`true`，即使一个或多个子构建失败，主构建也会继续。默认值为：`false`。用户属性是：`maven.test.failure.ignore`。
插值属性	`特性`	`1.1`	已弃用。从 1.3 版开始，应改为使用参数`filterProperties 。`
调用者属性文件	`细绳`	`1.2`	包含用于指定单个 Maven 调用设置的属性的可选项目特定文件的名称。文件中存在的任何属性都将覆盖插件配置中的相应设置。属性的值被过滤，并且可以使用像 `${project.version}`这样的表达式来引用来自参数`filterProperties`的项目属性或值。下面的代码片段描述了支持的属性： # A comma or space separated list of goals/phases to execute, may # specify an empty list to execute the default goal of the IT project invoker.goals = clean install # Optionally, a list of goals to run during further invocations of Maven invoker.goals.2 = ${project.groupId}:${project.artifactId}:${project.version}:run # A comma or space separated list of profiles to activate invoker.profiles = its,jdk15 # The path to an alternative POM or base directory to invoke Maven on, defaults to the # project that was originally specified in the plugin configuration # Since plugin version 1.4 invoker.project = sub-module # The value for the environment variable MAVEN_OPTS invoker.mavenOpts = -Dfile.encoding=UTF-16 -Xms32m -Xmx256m # Possible values are "fail-fast" (default), "fail-at-end" and "fail-never" invoker.failureBehavior = fail-never # The expected result of the build, possible values are "success" (default) and "failure" invoker.buildResult = failure # A boolean value controlling the aggregator mode of Maven, defaults to "false" invoker.nonRecursive = true # A boolean value controlling the network behavior of Maven, defaults to "false" # Since plugin version 1.4 invoker.offline = true # The path to the properties file from which to load system properties, defaults to the # filename given by the plugin parameter testPropertiesFile # Since plugin version 1.4 invoker.systemPropertiesFile = test.properties # An optional human friendly name for this build job to be included in the build reports. # Since plugin version 1.4 invoker.name = Test Build 01 # An optional description for this build job to be included in the build reports. # Since plugin version 1.4 invoker.description = Checks the support for build reports. # A comma separated list of JRE versions on which this build job should be run. # Since plugin version 1.4 invoker.java.version = 1.4+, !1.4.1, 1.7- # A comma separated list of OS families on which this build job should be run. # Since plugin version 1.4 invoker.os.family = !windows, unix, mac # A comma separated list of Maven versions on which this build should be run. # Since plugin version 1.5 invoker.maven.version = 2.0.10+, !2.1.0, !2.2.0 # A boolean value controlling the debug logging level of Maven, , defaults to "false" # Since plugin version 1.8 invoker.debug = true 默认值为：`invoker.properties`。用户属性是：`invoker.invokerPropertiesFile`。
调用者测试	`细绳`	`1.1（自 1.8 起排除）`	要运行的项目名称模式的逗号分隔列表。指定此参数以按文件名运行单个测试，覆盖 `setupIncludes`、`pomIncludes`和 `pomExcludes`参数。您在此处指定的每个模式都将用于创建格式 `为 ${projectsDirectory}/ pattern`的包含/排除模式。要排除测试，请在模式前加上 ' `!` '。因此，您只需键入`-Dinvoker.test=SimpleTest,CompTest,!Compare即可在${projectsDirectory}/SimpleTest`和 `${projectsDirectory}/ComplexTest`中运行构建，但 `${projectsDirectory}/CompareTest` 用户属性为：`调用者.test`。
主页	`文件`	`1.3`	用于分叉 Maven 调用的`JAVA_HOME环境变量。`默认为当前 Java 主目录。用户属性是：`invoker.javaHome`。
本地存储库路径	`文件`	`1.0`	用于缓存工件的本地存储库。强烈建议指定一个独立存储库的路径，例如 `${project.build.directory}/it-repo`。否则，将使用您的普通本地存储库，可能会被损坏的工件弄脏。默认值为：`${settings.localRepository}`。用户属性是：`invoker.localRepositoryPath`。
maven可执行文件	`细绳`	`1.8`	mavenExecutable 可以是相对于 `${maven.home}/bin/`的文件，也可以是绝对文件。用户属性是：`invoker.mavenExecutable`。
行家之家	`文件`	`1.3`	用于分叉构建的 Maven 安装的主目录。默认为当前的 Maven 安装。用户属性是：`invoker.mavenHome`。
mavenOpts	`细绳`	`1.2`	调用 Maven 时使用的`MAVEN_OPTS`环境变量。可以使用`invokerPropertiesFile`为单个集成测试覆盖此值。用户属性是：`invoker.mavenOpts`。
合并用户设置	`布尔值`	`1.6`	如果启用并且您为执行配置了设置文件，它将与您的用户设置合并。默认值为：`false`。用户属性是：`invoker.mergeUserSettings`。
无日志	`布尔值`	`1.0`	禁止将日志记录到`build.log`文件。默认值为：`false`。用户属性是：`invoker.noLog`。
并行线程	`整数`	`1.6`	并行运行测试的线程数。这将是并行的 Maven 分叉进程的数量。默认值为：`1`。用户属性是：`invoker.parallelThreads`。
绒球	`文件`	`1.0`	要构建的单个 POM，跳过任何扫描参数和行为。用户属性是：`invoker.pom`。
pom不包括	`列表`	`1.0`	排除用于搜索集成测试目录的模式。此参数旨在从 POM 中设置。默认情况下，不排除任何 POM 文件。为了方便使用 `*之类的包含模式，参数settingsFile`指定的自定义设置文件将始终被自动排除。
pom包括	`列表`	`1.0`	包括用于在集成测试目录中搜索项目的模式。此参数旨在从 POM 中设置。如果未设置此参数，插件将搜索位于`projectsDirectory下一个目录的所有pom.xml`文件（即`/pom.xml`）。从 1.3 版开始，这些模式也可以匹配单纯的目录。例如，包含模式`将在projectsDirectory` 的所有直接子目录上运行 Maven 构建，无论它们是否包含 `pom.xml`。这允许执行需要/不应该依赖于 POM 存在的构建。
postBuildHookScript	`细绳`	`1.0`	执行构建后要运行的清理/验证挂钩脚本的相对路径。该脚本可以使用 BeanShell 或 Groovy（从 1.3 开始）编写。如果省略文件扩展名（例如`verify`），插件会通过尝试众所周知的扩展名`.bsh`和 `.groovy`来搜索文件。如果此脚本存在于特定项目但返回任何不同于 `true`的非空值或引发异常，则相应的构建将被标记为失败。默认值为：`postbuild`。用户属性是：`invoker.postBuildHookScript`。
preBuildHookScript	`细绳`	`1.0`	在执行构建之前运行的预构建钩子脚本的相对路径。该脚本可以使用 BeanShell 或 Groovy（从 1.3 开始）编写。如果省略文件扩展名（例如 `prebuild`），插件会通过尝试众所周知的扩展名`.bsh`和 `.groovy`来搜索文件。如果此脚本存在于特定项目但返回任何不同于 `true`的非空值或引发异常，则相应的构建将被标记为失败。在这种情况下，既不会调用 Maven 也不会调用构建后挂钩脚本。默认值为：`预构建`。用户属性是：`invoker.preBuildHookScript`。
简介	`列表`	`1.1`	要在构建中显式触发的配置文件标识符列表。
配置文件文件	`细绳`	`1.1`	已弃用。从 1.2 版开始，应该使用参数 `invokerPropertiesFile指定的属性文件中的键invoker.profiles 。`默认值为：`profiles.txt`。用户属性是：`invoker.profilesFile`。
项目目录	`文件`	`1.0`	搜索集成测试的目录。默认值为：`${basedir}/src/it/`。用户属性是：`invoker.projectsDirectory`。
特性	`地图`	`1.1`	通过 -D 参数在每个项目的命令行上传递的一组通用属性。
报告目录	`文件`	`1.4`	写入所有构建报告的基本目录。集成测试的每次执行都会生成一个 XML 文件，其中包含有关特定构建作业成功或失败的信息。生成的 XML 文件的格式记录在给定的构建作业参考中。默认值为：`${project.build.directory}/invoker-reports`。用户属性是：`invoker.reportsDirectory`。
脚本变量	`地图`	`1.9`	用于挂钩脚本的附加变量。
选择器脚本	`细绳`	`1.5`	选择器脚本的相对路径，以决定是否应该执行构建。该脚本可以使用 BeanShell 或 Groovy 编写。如果省略文件扩展名（例如 `selector`），插件会通过尝试众所周知的扩展名`.bsh`和 `.groovy`来搜索文件。如果此脚本存在于特定项目但返回任何不同于 `true`的非空值，则相应的构建将被标记为已跳过。在这种情况下，不会调用构建前挂钩脚本、Maven 和构建后挂钩脚本。如果此脚本抛出异常，则相应的构建被标记为错误，并且不会调用构建前的钩子脚本，Maven 而不是构建后的钩子脚本。默认值为：`选择器`。用户属性是：`invoker.selectorScript`。
设置文件	`文件`	`1.2`	用于所有 IT 的 Maven 调用的备用`settings.xml的路径。`请注意，此设置文件的 `<localRepository>`元素始终被忽略，即参数 `localRepositoryPath`给出的路径占主导地位。用户属性是：`invoker.settingsFile`。
设置包括	`列表`	`1.3`	包括用于在项目目录中搜索需要在其他项目之前运行的项目的模式。此参数允许声明执行设置任务的项目，例如将实用程序工件安装到本地存储库中。与这些模式匹配的项目被隐式地排除在普通项目的扫描之外。此外，由参数 `pomExcludes`定义的排除项也适用于设置项目。默认值为：`setup*/pom.xml`。
显示错误	`布尔值`	`1.0`	是否在构建输出中显示错误。默认值为：`false`。用户属性是：`invoker.showErrors`。
显示版本	`布尔值`	`1.4`	启用用于运行其的显示 mvn 版本的标志（cli 选项：-V，--show-version）默认值为：`false`。用户属性是：`invoker.showVersion`。
跳过调用	`布尔值`	`1.1`	用于禁止某些调用的标志。这在使用配置文件定制构建时很有用。默认值为：`false`。用户属性是：`invoker.skip`。
流日志	`布尔值`	`1.0`	用于确定是否应将构建日志输出到普通 mojo 日志的标志。默认值为：`false`。用户属性是：`invoker.streamLogs`。
抑制摘要	`布尔值`	`1.0`	用于禁止通知成功和失败的摘要输出的标志。如果设置为`true`，构建成功或失败的唯一指示将是它对主构建的影响（如果失败，主构建也应该失败）。如果启用了`streamLogs`，子构建摘要也将提供指示。默认值为：`false`。
测试属性	`特性`	`1.0`	已弃用。从 1.1 版开始，请改用`properties`参数。
测试属性文件	`细绳`	`1.0`	为测试定义 CLI 属性的属性文件的位置。默认值为：`test.properties`。用户属性是：`invoker.testPropertiesFile`。

参数详情

addTestClassPath：

一个标志，被测项目的测试类路径是否应该包含在构建前/构建后脚本的类路径中。如果设置为false，则脚本解释器的类路径仅包含Maven Invoker 插件的运行时依赖项。如果设置为 true，项目的测试类路径将被添加到解释器类路径中。除其他外，此功能允许脚本从项目的测试源访问实用程序类。

类型：布尔值
从: 1.2
要求：否
用户属性：invoker.addTestClassPath
默认值：假

克隆所有文件：

将 IT 项目从参数 projectsDirectory 指定的目录复制到 cloneProjectsTo 指定的目录（例如.svn、 CVS、*~等）时，通常会排除某些文件。将此参数设置为 true将导致将所有文件复制到 cloneProjectsTo 目录。

类型：布尔值
从: 1.2
要求：否
默认值：假

克隆清洁：

确保cloneProjectsTo目录没有被早期调用程序运行的文件污染。

类型：布尔值
从: 1.6
要求：否
默认值：假

cloneProjectsTo：

在执行之前应将项目克隆到的目录。如果未指定，则每个集成测试都将在找到相应 IT POM 的目录中运行。在这种情况下，您很可能希望将 SCM 配置为忽略测试基本目录中的target和 build.log。

类型：java.io.File
从: 1.1
要求：否

调试：

是否在构建输出中显示调试语句。

类型：布尔值
从: 1.0
要求：否
用户属性：invoker.debug
默认值：假

禁用报告：

禁用生成报告生成的标志。

类型：布尔值
从: 1.4
要求：否
用户属性：invoker.disableReports
默认值：假

编码：

构建前/构建后脚本的文件编码以及目标和配置文件的列表文件。

类型：java.lang.String
从: 1.2
要求：否
用户属性：编码
默认值：${project.build.sourceEncoding}

环境变量：

要在命令行上设置的其他环境变量。

类型：java.util.Map
从: 1.8
要求：否

失败如果没有项目：

如果没有要调用的项目，将其设置为true会导致失败。

类型：java.lang.Boolean
从: 1.9
要求：否
用户属性：invoker.failIfNoProjects

过滤器属性：

将用于过滤 POM 和目标文件中的令牌的附加属性列表。

类型：java.util.Map
从: 1.3
要求：否

目标：

每个项目要执行的目标列表。默认值为： 包。

类型：java.util.List
从: 1.0
要求：否

目标文件：

已弃用。从 1.2 版开始，应该使用参数 invokerPropertiesFile指定的属性文件中的键invoker.goals 。

包含要为该测试执行的目标枚举的项目特定文件的名称。

类型：java.lang.String
从: 1.0
要求：否
用户属性：invoker.goalsFile
默认值：目标.txt

忽略失败：

控制子构建失败是否也应该使主构建失败的标志。如果设置为true，即使一个或多个子构建失败，主构建也会继续。

类型：布尔值
从: 1.3
要求：否
用户属性：maven.test.failure.ignore
默认值：假

插值属性：

已弃用。从 1.3 版开始，应改为使用参数filterProperties 。

将用于插入目标文件的属性列表。

类型：java.util.Properties
从: 1.1
要求：否

调用者属性文件：

包含用于指定单个 Maven 调用设置的属性的可选项目特定文件的名称。文件中存在的任何属性都将覆盖插件配置中的相应设置。属性的值被过滤，并且可以使用像 ${project.version}这样的表达式来引用来自参数filterProperties的项目属性或值。下面的代码片段描述了支持的属性：

# A comma or space separated list of goals/phases to execute, may
# specify an empty list to execute the default goal of the IT project
invoker.goals = clean install

# Optionally, a list of goals to run during further invocations of Maven
invoker.goals.2 = ${project.groupId}:${project.artifactId}:${project.version}:run

# A comma or space separated list of profiles to activate
invoker.profiles = its,jdk15

# The path to an alternative POM or base directory to invoke Maven on, defaults to the
# project that was originally specified in the plugin configuration
# Since plugin version 1.4
invoker.project = sub-module

# The value for the environment variable MAVEN_OPTS
invoker.mavenOpts = -Dfile.encoding=UTF-16 -Xms32m -Xmx256m

# Possible values are "fail-fast" (default), "fail-at-end" and "fail-never"
invoker.failureBehavior = fail-never

# The expected result of the build, possible values are "success" (default) and "failure"
invoker.buildResult = failure

# A boolean value controlling the aggregator mode of Maven, defaults to "false"
invoker.nonRecursive = true

# A boolean value controlling the network behavior of Maven, defaults to "false"
# Since plugin version 1.4
invoker.offline = true

# The path to the properties file from which to load system properties, defaults to the
# filename given by the plugin parameter testPropertiesFile
# Since plugin version 1.4
invoker.systemPropertiesFile = test.properties

# An optional human friendly name for this build job to be included in the build reports.
# Since plugin version 1.4
invoker.name = Test Build 01

# An optional description for this build job to be included in the build reports.
# Since plugin version 1.4
invoker.description = Checks the support for build reports.

# A comma separated list of JRE versions on which this build job should be run.
# Since plugin version 1.4
invoker.java.version = 1.4+, !1.4.1, 1.7-

# A comma separated list of OS families on which this build job should be run.
# Since plugin version 1.4
invoker.os.family = !windows, unix, mac

# A comma separated list of Maven versions on which this build should be run.
# Since plugin version 1.5
invoker.maven.version = 2.0.10+, !2.1.0, !2.2.0

# A boolean value controlling the debug logging level of Maven, , defaults to "false"
# Since plugin version 1.8
invoker.debug = true

类型：java.lang.String
从: 1.2
要求：否
用户属性：invoker.invokerPropertiesFile
默认值：invoker.properties

调用者测试：

要运行的项目名称模式的逗号分隔列表。指定此参数以按文件名运行单个测试，覆盖 setupIncludes、pomIncludes和 pomExcludes参数。您在此处指定的每个模式都将用于创建格式 为 ${projectsDirectory}/ pattern的包含/排除模式。要排除测试，请在模式前加上 ' ! '。因此，您只需键入-Dinvoker.test=SimpleTest,Comp*Test,!Compare*即可在${projectsDirectory}/SimpleTest和 ${projectsDirectory}/ComplexTest中运行构建，但不能在 ${projectsDirectory}/CompareTest

类型：java.lang.String
自：1.1（自 1.8 起排除）
要求：否
用户属性：invoker.test

主页：

用于分叉 Maven 调用的JAVA_HOME环境变量。默认为当前 Java 主目录。

类型：java.io.File
从: 1.3
要求：否
用户属性：invoker.javaHome

本地存储库路径：

用于缓存工件的本地存储库。强烈建议指定一个独立存储库的路径，例如 ${project.build.directory}/it-repo。否则，将使用您的普通本地存储库，可能会被损坏的工件弄脏。

类型：java.io.File
从: 1.0
要求：否
用户属性：invoker.localRepositoryPath
默认值：${settings.localRepository}

maven可执行文件：

mavenExecutable 可以是相对于 ${maven.home}/bin/的文件，也可以是绝对文件。

类型：java.lang.String
从: 1.8
要求：否
用户属性：invoker.mavenExecutable

maven主页：

用于分叉构建的 Maven 安装的主目录。默认为当前的 Maven 安装。

类型：java.io.File
从: 1.3
要求：否
用户属性：invoker.mavenHome

mavenOpts：

调用 Maven 时使用的MAVEN_OPTS环境变量。可以使用invokerPropertiesFile为单个集成测试覆盖此值。

类型：java.lang.String
从: 1.2
要求：否
用户属性：invoker.mavenOpts

合并用户设置：

如果启用并且您为执行配置了设置文件，它将与您的用户设置合并。

类型：布尔值
从: 1.6
要求：否
用户属性：invoker.mergeUserSettings
默认值：假

无日志：

禁止将日志记录到build.log文件。

类型：布尔值
从: 1.0
要求：否
用户属性：invoker.noLog
默认值：假

并行线程：

并行运行测试的线程数。这将是并行的 Maven 分叉进程的数量。

类型：整数
从: 1.6
要求：否
用户属性：invoker.parallelThreads
默认值：1

pom：

要构建的单个 POM，跳过任何扫描参数和行为。

类型：java.io.File
从: 1.0
要求：否
用户属性：invoker.pom

pom排除：

排除用于搜索集成测试目录的模式。此参数旨在从 POM 中设置。默认情况下，不排除任何 POM 文件。为了方便使用 *之类的包含模式，参数settingsFile指定的自定义设置文件将始终被自动排除。

类型：java.util.List
从: 1.0
要求：否

pom包括：

包括用于在集成测试目录中搜索项目的模式。此参数旨在从 POM 中设置。如果未设置此参数，插件将搜索位于projectsDirectory下一个目录的所有pom.xml文件（即*/pom.xml）。从 1.3 版开始，这些模式也可以匹配单纯的目录。例如，包含模式*将在projectsDirectory 的所有直接子目录上运行 Maven 构建，无论它们是否包含 pom.xml。这允许执行需要/不应该依赖于 POM 存在的构建。

类型：java.util.List
从: 1.0
要求：否

postBuildHookScript：

执行构建后要运行的清理/验证挂钩脚本的相对路径。该脚本可以使用 BeanShell 或 Groovy（从 1.3 开始）编写。如果省略文件扩展名（例如verify），插件会通过尝试众所周知的扩展名.bsh和 .groovy来搜索文件。如果此脚本存在于特定项目但返回任何不同于 true的非空值或引发异常，则相应的构建将被标记为失败。

类型：java.lang.String
从: 1.0
要求：否
用户属性：invoker.postBuildHookScript
默认值：构建后

preBuildHookScript：

在执行构建之前运行的预构建钩子脚本的相对路径。该脚本可以使用 BeanShell 或 Groovy（从 1.3 开始）编写。如果省略文件扩展名（例如 prebuild），插件会通过尝试众所周知的扩展名.bsh和 .groovy来搜索文件。如果此脚本存在于特定项目但返回任何不同于 true的非空值或引发异常，则相应的构建将被标记为失败。在这种情况下，既不会调用 Maven 也不会调用构建后挂钩脚本。

类型：java.lang.String
从: 1.0
要求：否
用户属性：invoker.preBuildHookScript
默认值：预构建

简介：

要在构建中显式触发的配置文件标识符列表。

类型：java.util.List
从: 1.1
要求：否

配置文件文件：

已弃用。从 1.2 版开始，应该使用参数 invokerPropertiesFile指定的属性文件中的键invoker.profiles 。

包含用于该测试的配置文件枚举的项目特定文件的名称。如果文件存在且为空，即使设置了参数配置文件，也不会使用配置文件。

类型：java.lang.String
从: 1.1
要求：否
用户属性：invoker.profilesFile
默认：profiles.txt

项目目录：

搜索集成测试的目录。

类型：java.io.File
从: 1.0
要求：否
用户属性：invoker.projectsDirectory
默认：${basedir}/src/it/

属性：

通过 -D 参数在每个项目的命令行上传递的一组通用属性。

类型：java.util.Map
从: 1.1
要求：否

报告目录：

写入所有构建报告的基本目录。集成测试的每次执行都会生成一个 XML 文件，其中包含有关特定构建作业成功或失败的信息。生成的 XML 文件的格式记录在给定的构建作业参考中。

类型：java.io.File
从: 1.4
要求：否
用户属性：invoker.reportsDirectory
默认值：${project.build.directory}/invoker-reports

脚本变量：

用于挂钩脚本的附加变量。

类型：java.util.Map
从: 1.9
要求：否

选择器脚本：

选择器脚本的相对路径，以决定是否应该执行构建。该脚本可以使用 BeanShell 或 Groovy 编写。如果省略文件扩展名（例如 selector），插件会通过尝试众所周知的扩展名.bsh和 .groovy来搜索文件。如果此脚本存在于特定项目但返回任何不同于 true的非空值，则相应的构建将被标记为已跳过。在这种情况下，不会调用构建前挂钩脚本、Maven 和构建后挂钩脚本。如果此脚本抛出异常，则相应的构建被标记为错误，并且不会调用构建前的钩子脚本，Maven 而不是构建后的钩子脚本。

类型：java.lang.String
从: 1.5
要求：否
用户属性：invoker.selectorScript
默认值：选择器

设置文件：

用于所有 IT 的 Maven 调用的备用settings.xml的路径。请注意，此设置文件的 <localRepository>元素始终被忽略，即参数 localRepositoryPath给出的路径占主导地位。

类型：java.io.File
从: 1.2
要求：否
用户属性：invoker.settingsFile

设置包括：

包括用于在项目目录中搜索需要在其他项目之前运行的项目的模式。此参数允许声明执行设置任务的项目，例如将实用程序工件安装到本地存储库中。与这些模式匹配的项目被隐式地排除在普通项目的扫描之外。此外，由参数 pomExcludes定义的排除项也适用于设置项目。默认值为：setup*/pom.xml。