maven-site-plugin笔记——2.3到3.0之间的变化

刚才正在配置一个项目的报告输出，在配置pom的时候按照maven2的做法在节点下加上了pmd、checkstyle等plugin

  
    
      org.apache.maven.plugins
      maven-checkstyle-plugin
      ${checkstyle.plugin.version}
    
    
      org.apache.maven.plugins
      maven-pmd-plugin
      ${pmd.plugin.version}
    

却发现在target/site目录下除了image及css文件夹之外，一个html也没有，而且预期的报告也没有生成，我就纳闷了

几经Google后，终于查到，原来maven-site-plugin在3.0版本采用了一种全新的配置形式，导致不能接受节点下声明的报告插件，这一点在其官方网站上有介绍：http://maven.apache.org/plugins/maven-site-plugin/maven-3.html#Configuration_formats

解决办法就是，将内的plugin声明，转换为如下形式：

  org.apache.maven.plugins
  maven-site-plugin
  3.0
  
    
      
        org.apache.maven.plugins
        maven-checkstyle-plugin
      
      
        org.apache.maven.plugins
        maven-pmd-plugin
      
    
  

注意，这里的plugin声明已经成为了maven-site-plugin中的一个configuration项，已不再享有原来plugin那种继承规则，在可视化编辑器内也再没有语法提示。

还有一点就是，在3.0版本中，在maven-site-plugin内声明的插件是可以忽略version的，maven-site-plugin会按照如下顺序查找：

1. build.plugins

2. build.pluginsManagement

3.repository（在repository中查找可能会使用Snapshot的插件，和maven插件一样规则）

至此，改动已经完成，运行mvn clean site即可看见project-reports.html文件，打开所期望的报告页面了。

但是，index.html呢。。。

让index.html回来，请看《maven-site-plugin笔记——内部工作原理》