配置报告

Maven 有几个报告,您可以将它们添加到您的网站以显示项目的当前状态。这些报告采用插件的形式,就像用于构建项目的那些一样。

通过从 POM 中提取信息可以获得许多标准报告。目前这些是默认提供的:

  • 持续集成
  • 依赖项
  • 问题跟踪
  • 执照
  • 邮件列表
  • 项目团队
  • 源存储库

要了解更多信息,请参阅项目信息报告插件

要将这些报告添加到您的站点,您必须将插件添加到 POM 中的<reporting>元素。以下示例显示如何配置标准项目信息报告,以友好的格式显示来自 POM 的信息:

<project>
  ...
  <reporting>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-project-info-reports-plugin</artifactId>
        <version>2.1.1</version>
      </plugin>
    </plugins>
  </reporting>
  ...
</project>

如果您在站点描述符中包含了适当的<menu ref="reports"/>标记,那么当您重新生成站点时,这些项目将出现在名为“项目报告”的菜单中。

注意:许多报告插件提供了一个名为outputDirectory或类似的参数来指定其报告输出的目的地。此参数仅在报告插件独立运行时才相关,即直接从命令行调用。相反,当报告作为站点的一部分生成时,Maven 站点插件的配置将确定有效的输出目录,以确保所有报告最终都位于一个公共位置。

查看插件页面的报告部分,了解可用报告插件的列表。