Apache Maven 帮助插件

Maven Help Plugin 用于获取有关项目或系统的相关信息。它可用于获取特定插件的描述,包括插件的目标及其参数和组件要求、当前构建的有效 POM 和有效设置,以及应用于当前正在构建的项目的配置文件。

目标概述

帮助插件有 7 个目标:

  • help:active-profiles列出当前为构建活动的配置文件。
  • help:all-profiles列出当前项目下可用的配置文件。
  • help:describe描述了插件和/或 Mojo(Maven 普通旧 Java 对象)的属性。
  • help:effective-pom将有效 POM 显示为当前构建的 XML,并考虑活动配置文件。如果verbose,将向每个 XML 元素添加注释,描述行的来源。
  • help:effective-settings将计算的设置显示为项目的 XML,给定任何配置文件增强功能以​​及将全局设置继承到用户级设置中。
  • help:evaluate以交互模式计算用户给出的 Maven 表达式。
  • help:system显示平台详细信息列表,例如系统属性和环境变量。

主要版本升级到版本 3.0.0

请注意,目标表达式已从插件中完全删除。PluginParameterExpressionEvaluator类的 Javadoc 中提供了所有支持作为插件参数的 Maven 表达式。

用法

有关如何使用帮助插件的一般说明可以在使用页面上找到。下面给出的示例中描述了一些更具体的用例。最后但同样重要的是,用户偶尔会向插件的 wiki 页面提供额外的示例、提示或勘误表。

如果您对插件的使用仍有疑问,请查看常见问题解答并随时联系用户邮件列表。邮件列表中的帖子已存档,并且可能已经包含您问题的答案,作为旧线程的一部分。因此,也值得浏览/搜索邮件存档

如果您觉得插件缺少功能或存在缺陷,您可以在我们的问题跟踪器中填写功能请求或错误报告。创建新问题时,请提供您所关注问题的全面描述。特别是对于修复错误,开发人员可以重现您的问题至关重要。出于这个原因,非常感谢附在问题上的整个调试日志、POM 或最好的小演示项目。当然,补丁也是受欢迎的。贡献者可以从我们的源代码库中查看该项目,并将在帮助使用 Maven 的指南中找到补充信息。

例子

为了让您更好地了解帮助插件的一些用法,您可以查看以下示例: