Maven工具学习使用(十)——生成项目站点
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>