Apache Maven 调用程序插件
Invoker Plugin 用于运行一组 Maven 项目。该插件可以确定每个项目执行是否成功,并且可以选择验证从给定项目执行生成的输出。
这个插件对于执行其他 Maven 插件的集成测试特别方便。Invoker Plugin 可用于运行一组测试项目,这些项目旨在断言被测插件的某些功能。
目标概述
该插件有四个参与默认构建生命周期的目标:
- invoker:install将主构建的项目工件和依赖项复制到专用的本地存储库中,以准备在隔离环境中执行选定的子项目。
- invoker:integration-test在一个目录中运行一组 Maven 项目。
- invoker:verify验证
invoker:integration-test
. - invoker:run在一个目录中运行一组 Maven 项目并验证结果。这相当于同时运行
invoker:integration-test
和invoker:verify
。
最后一个目标旨在用于站点生命周期:
- invoker:report将以前构建的结果集成到站点中。
用法
有关如何使用 Invoker 插件的一般说明可以在使用页面上找到。下面给出的示例中描述了一些更具体的用例。
如果您对插件的使用仍有疑问,请查看常见问题解答并随时联系用户邮件列表。邮件列表中的帖子已存档,并且可能已经包含您问题的答案,作为旧线程的一部分。因此,也值得浏览/搜索邮件存档。
如果您觉得插件缺少功能或存在缺陷,您可以在我们的问题跟踪器中填写功能请求或错误报告。创建新问题时,请提供您所关注问题的全面描述。特别是对于修复错误,开发人员可以重现您的问题至关重要。出于这个原因,非常感谢附在问题上的整个调试日志、POM 或最好的小演示项目。当然,补丁也是受欢迎的。贡献者可以从我们的源代码库中查看该项目,并将在帮助使用 Maven 的指南中找到补充信息。
例子
以下示例配置可用于更详细地说明所选用例:
- 运行前将项目克隆到临时目录。
- 在开始构建之前过滤文件以引入一些更新。
- 在运行之前将项目工件安装到本地存储库。
- 运行 BeanShell 或 Groovy 脚本来验证项目输出。
- 快速调用插件配置以加速项目执行。
- 访问测试类以在挂钩脚本之间共享代码。
- 使用 Invoker Properties为各个项目配置目标、配置文件等。
- 使用选择器条件跳过基于 JRE 版本或操作系统系列的项目。
- 通过在其他项目之前构建一些设置项目来准备构建环境。
- 通过将检查集成测试的结果与执行集成测试分离,与其他集成测试框架一起使用。
您还可以通过浏览位于项目源代码树src/it
目录中的自己的集成测试来研究 Invoker 插件的一些实际用法。