当前位置：首页 > news >正文

Maven工具学习使用（十）——生成项目站点

news 来源：原创 2025/5/26 10:23:26

maven2中站点生成是Maven核心的一部分，Maven3中这部分内容已经移除。maven3必须使用3.x版本的maven-site-plugin,maven2则使用最新的2.x的版本，执行mvn site命令，可以在项目的target/site/目录下找到Maven生成的站点文件。例如dependencies.html，打开文件能够看到好多信息的连接，如果是聚合项目还可以看到子模块的链接，打开文件单机子模块的连接无法转到子模块的项目页面，如果将站点发布到服务器上，点击这些连接就可以打开子模块的项目页面。或者将站点预发布到本地某个临时目录也是可以点击的。

mvn site:stage -DstagingDirectory=D:\temp 该命令生成项目站点，并预发布至D:\temp目录

site生命周期的site阶段绑定到了插件maven-site-plugin插件的site目标，site-deploy 目标绑定到了maven-site-plugin的deploy目标。

配置pom文件

默认情况下生成的站点包含了很多项目信息连接，这个主要是由maven-project-info-reports-plugin插件生成的。Maven3中该插件的配置内置在maven-site-plugin中。

站点的信息都来自于pom配置文件，所以需要配置pom文件才能展示响应的信息。如果需要选择性的生成项目信息，可以配置maven-project-info-reports-plugin

项目报告插件

报告插件的配置需要在Maven Site Plugin的插件配置元素下配置报告插件，运行mvn site会执行以下插件

<project>
    ...
    <reporting>
        <plugins>
            <!-- maven-project-info-reports-plugin
                该插件使站点的项目信息只包含依赖、团队、问题追踪系统、和许可证几项信息 
                可根据实际需要选择生成的项目信息
            -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-project-info-reports-plugin</artifactId>
                <version>2.1.2</version>
                <reportSets>
                    <reportSet>
                        <reports>
                            <report>dependencies</report>
                            <report>project-team</report>
                            <report>issue-tracking</report>
                            <report>license</report>