调用者：运行

全名：

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

说明：

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

属性：

  • 需要执行 Maven 2.0 项目。
  • 需要范围内工件的依赖关系解析：test.
  • 自版本：1.0.
  • 默认绑定到生命周期阶段：integration-test.

可选参数

姓名 类型 自从 描述
addTestClassPath boolean 1.2 一个标志，被测项目的测试类路径是否应该包含在构建前/构建后脚本的类路径中。如果设置为false，则脚本解释器的类路径仅包含Maven Invoker 插件的运行时依赖项。如果设置 true，项目的测试类路径将被添加到解释器类路径中。除其他外，此功能允许脚本从项目的测试源访问实用程序类。默认值为：false。
克隆所有文件 boolean 1.2 将 IT 项目从参数 projectsDirectory 指定的目录复制到 cloneProjectsTo 指定的目录（例如.svn、 CVS、*~等）时，通常会排除一些文件。将此参数设置为 true将导致所有文件复制到 cloneProjectsTo 目录。默认值为：false。
克隆项目到 File 1.1 在执行之前应将项目克隆到的目录。如果未指定，则每个集成测试都将在找到相应 IT POM 的目录中运行。在这种情况下，您很可能希望将 SCM 配置为忽略target并 build.log位于测试的基本目录中。
调试 boolean 1.0 是否在构建输出中显示调试语句。默认值为：false。
编码 String 1.2 构建前/构建后脚本的文件编码以及目标和配置文件的列表文件。默认值为：${project.build.sourceEncoding}。
目标 List 1.0 每个项目要执行的目标列表。默认值为： package。
目标文件 String 1.0 已弃用。从 1.2 版开始，应该使用参数 invokerPropertiesFile 指定的属性文件。默认值为：goals.txt。
插值属性 Properties 1.1 将用于插入目标文件的属性列表。
调用者属性文件 String 1.2 包含用于配置集成测试调用的属性的可选测试特定文件的名称。此属性文件可用于指定单个测试调用的设置。文件中存在的任何属性都将覆盖插件配置中的相应设置。属性的值被过滤，并且可以使用表达式 ${project.version}来引用项目属性或参数中的值interpolationsProperties。下面的代码片段描述了支持的属性： 
# 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 package site

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

# 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 -N flag, defaults to "false"
invoker.nonRecursive=false
默认值为：invoker.properties。
调用者测试 String 1.1 指定此参数以按文件名运行单个测试，覆盖pomIncludes和 pomExcludes参数。您在此处指定的每个模式都将用于创建格式为 的包含模式 ${projectsDirectory}/${invoker.test}，因此您只需键入“-Dinvoker.test=MyTest”即可在 ${projectsDirectory}/${invoker.test} 中运行单个它。
本地存储库路径 File 1.0 用于缓存工件的本地存储库。
mavenOpts String 1.2 MAVEN_OPTS调用 Maven 时使用的环境变量。可以使用invokerPropertiesFile.
无日志 boolean 1.0 禁止记录到build.log文件。默认值为：false。
绒球 File 1.0 要构建的单个 POM，跳过任何扫描参数和行为。
pom不包括 List 1.0 排除搜索集成测试目录。此参数旨在从 POM 中设置。默认情况下，不排除任何 POM 文件。
pom包括 List 1.0 包括用于搜索集成测试目录。此参数旨在从 POM 中设置。如果未设置此参数，插件将搜索下pom.xml一个目录projectsDirectory （*/pom.xml）下的所有文件。
postBuildHookScript String 1.0 执行构建后要运行的清理/验证 BeanShell 脚本的相对路径。默认值为：postbuild.bsh。
preBuildHookScript String 1.0 在执行构建之前运行的预构建挂钩 BeanShell 脚本的相对路径。默认值为：prebuild.bsh。
简介 List 1.1 要在构建中显式触发的配置文件标识符列表。
配置文件文件 String 1.1 已弃用。从 1.2 版开始，应该使用参数 invokerPropertiesFile 指定的属性文件。默认值为：profiles.txt。
项目目录 File 1.0 搜索集成测试的目录。默认值为：${basedir}/src/projects/。
特性 Map 1.1 通过 -D 参数在每个项目的命令行上传递的一组通用属性。
设置文件 File 1.2 settings.xml用于所有 IT 的 Maven 调用的备用路径。
显示错误 boolean 1.0 是否在构建输出中显示错误。默认值为：false。
跳过调用 boolean 1.1 用于禁止某些调用的标志。这在使用配置文件定制构建时很有用。默认值为：false。
流日志 boolean 1.0 用于确定是否应将构建日志输出到普通 mojo 日志的标志。默认值为：false。
抑制摘要 boolean 1.0 用于禁止通知成功和失败的摘要输出的标志。如果设置为true，构建成功或失败的唯一指示将是它对主构建的影响（如果失败，主构建也应该失败）。如果 streamLogs启用，子构建摘要也将提供指示。默认值为：false。
测试属性 Properties 1.0 已弃用。请改用属性参数。
测试属性文件 String 1.0 为测试定义 CLI 属性的属性文件的位置。默认值为：test.properties。

参数详情

addTestClassPath：

一个标志，被测项目的测试类路径是否应该包含在构建前/构建后脚本的类路径中。如果设置为false，则脚本解释器的类路径仅包含Maven Invoker 插件的运行时依赖项。如果设置 true，项目的测试类路径将被添加到解释器类路径中。除其他外，此功能允许脚本从项目的测试源访问实用程序类。
  • 类型：boolean
  • 自：1.2
  • 必需：No
  • 表达式：${invoker.addTestClassPath}
  • 默认：false

克隆所有文件：

将 IT 项目从参数 projectsDirectory 指定的目录复制到 cloneProjectsTo 指定的目录（例如.svn、 CVS、*~等）时，通常会排除一些文件。将此参数设置为 true将导致所有文件复制到 cloneProjectsTo 目录。
  • 类型：boolean
  • 自：1.2
  • 必需：No
  • 默认：false

cloneProjectsTo：

在执行之前应将项目克隆到的目录。如果未指定，则每个集成测试都将在找到相应 IT POM 的目录中运行。在这种情况下，您很可能希望将 SCM 配置为忽略target并 build.log位于测试的基本目录中。
  • 类型：java.io.File
  • 自：1.1
  • 必需：No

调试：

是否在构建输出中显示调试语句。
  • 类型：boolean
  • 自：1.0
  • 必需：No
  • 表达式：${invoker.debug}
  • 默认：false

编码：

构建前/构建后脚本的文件编码以及目标和配置文件的列表文件。
  • 类型：java.lang.String
  • 自：1.2
  • 必需：No
  • 表达式：${encoding}
  • 默认：${project.build.sourceEncoding}

目标：

每个项目要执行的目标列表。默认值为： package。
  • 类型：java.util.List
  • 自：1.0
  • 必需：No

目标文件：

已弃用。从 1.2 版开始，应该使用参数 invokerPropertiesFile 指定的属性文件。
包含要为该测试执行的目标枚举的项目特定文件的名称。
  • 类型：java.lang.String
  • 自：1.0
  • 必需：No
  • 表达式：${invoker.goalsFile}
  • 默认：goals.txt

插值属性：

将用于插入目标文件的属性列表。
  • 类型：java.util.Properties
  • 自：1.1
  • 必需：No

调用者属性文件：

包含用于配置集成测试调用的属性的可选测试特定文件的名称。此属性文件可用于指定单个测试调用的设置。文件中存在的任何属性都将覆盖插件配置中的相应设置。属性的值被过滤，并且可以使用表达式 ${project.version}来引用项目属性或参数中的值interpolationsProperties。下面的代码片段描述了支持的属性： 
# 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 package site

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

# 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 -N flag, defaults to "false"
invoker.nonRecursive=false
  • 类型：java.lang.String
  • 自：1.2
  • 必需：No
  • 表达式：${invoker.invokerPropertiesFile}
  • 默认：invoker.properties

调用者测试：

指定此参数以按文件名运行单个测试，覆盖pomIncludes和 pomExcludes参数。您在此处指定的每个模式都将用于创建格式为 的包含模式 ${projectsDirectory}/${invoker.test}，因此您只需键入“-Dinvoker.test=MyTest”即可在 ${projectsDirectory}/${invoker.test} 中运行单个它。
  • 类型：java.lang.String
  • 自：1.1
  • 必需：No
  • 表达式：${invoker.test}

本地存储库路径：

用于缓存工件的本地存储库。
  • 类型：java.io.File
  • 自：1.0
  • 必需：No
  • 表达式：${invoker.localRepositoryPath}

mavenOpts：

MAVEN_OPTS调用 Maven 时使用的环境变量。可以使用invokerPropertiesFile.
  • 类型：java.lang.String
  • 自：1.2
  • 必需：No
  • 表达式：${invoker.mavenOpts}

无日志：

禁止记录到build.log文件。
  • 类型：boolean
  • 自：1.0
  • 必需：No
  • 表达式：${invoker.noLog}
  • 默认：false

pom：

要构建的单个 POM，跳过任何扫描参数和行为。
  • 类型：java.io.File
  • 自：1.0
  • 必需：No
  • 表达式：${invoker.pom}

pom排除：

排除搜索集成测试目录。此参数旨在从 POM 中设置。默认情况下，不排除任何 POM 文件。
  • 类型：java.util.List
  • 自：1.0
  • 必需：No

pom包括：

包括用于搜索集成测试目录。此参数旨在从 POM 中设置。如果未设置此参数，插件将搜索下pom.xml一个目录projectsDirectory （*/pom.xml）下的所有文件。
  • 类型：java.util.List
  • 自：1.0
  • 必需：No

postBuildHookScript：

执行构建后要运行的清理/验证 BeanShell 脚本的相对路径。
  • 类型：java.lang.String
  • 自：1.0
  • 必需：No
  • 表达式：${invoker.postBuildHookScript}
  • 默认：postbuild.bsh

preBuildHookScript：

在执行构建之前运行的预构建挂钩 BeanShell 脚本的相对路径。
  • 类型：java.lang.String
  • 自：1.0
  • 必需：No
  • 表达式：${invoker.preBuildHookScript}
  • 默认：prebuild.bsh

简介：

要在构建中显式触发的配置文件标识符列表。
  • 类型：java.util.List
  • 自：1.1
  • 必需：No

配置文件文件：

已弃用。从 1.2 版开始，应该使用参数 invokerPropertiesFile 指定的属性文件。
包含用于该测试的配置文件枚举的项目特定文件的名称。如果文件存在且为空，即使设置了配置文件，也不会使用任何配置文件
  • 类型：java.lang.String
  • 自：1.1
  • 必需：No
  • 表达式：${invoker.profilesFile}
  • 默认：profiles.txt

项目目录：

搜索集成测试的目录。
  • 类型：java.io.File
  • 自：1.0
  • 必需：No
  • 表达式：${invoker.projectsDirectory}
  • 默认：${basedir}/src/projects/

属性：

通过 -D 参数在每个项目的命令行上传递的一组通用属性。
  • 类型：java.util.Map
  • 自：1.1
  • 必需：No

设置文件：

settings.xml用于所有 IT 的 Maven 调用的备用路径。
  • 类型：java.io.File
  • 自：1.2
  • 必需：No
  • 表达式：${invoker.settingsFile}

显示错误：

是否在构建输出中显示错误。
  • 类型：boolean
  • 自：1.0
  • 必需：No
  • 表达式：${invoker.showErrors}
  • 默认：false

跳过调用：

用于禁止某些调用的标志。这在使用配置文件定制构建时很有用。
  • 类型：boolean
  • 自：1.1
  • 必需：No
  • 默认：false

流日志：

用于确定是否应将构建日志输出到普通 mojo 日志的标志。
  • 类型：boolean
  • 自：1.0
  • 必需：No
  • 表达式：${invoker.streamLogs}
  • 默认：false

抑制总结：

用于禁止通知成功和失败的摘要输出的标志。如果设置为true，构建成功或失败的唯一指示将是它对主构建的影响（如果失败，主构建也应该失败）。如果 streamLogs启用，子构建摘要也将提供指示。
  • 类型：boolean
  • 自：1.0
  • 必需：No
  • 默认：false

测试属性：

已弃用。请改用属性参数。
通过 -D 参数在每个 IT 的命令行上传递的一组通用测试属性。
  • 类型：java.util.Properties
  • 自：1.0
  • 必需：No

测试属性文件：

为测试定义 CLI 属性的属性文件的位置。
  • 类型：java.lang.String
  • 自：1.0
  • 必需：No
  • 表达式：${invoker.testPropertiesFile}
  • 默认：test.properties