在JDK由版本7升级到8时,使用maven编译会报doc错误,原因是JAVA8不支持JAVA7编写的doc,报错信息如下:

1
2
@param name 未找到
@return 的用法无效

可以使添加配置-Xdoclint:none,忽略这个问题

如果使用的maven-javadoc-plugin版本在3.0.0以前,配置如下:

1
2
3
4
5
6
7
8
9
<plugins>
  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <configuration>
      <additionalparam>-Xdoclint:none</additionalparam>
    </configuration>
  </plugin>
</plugins>

3.0.0以后,可以使用如下配置:

1
2
3
4
5
6
7
8
9
<plugins>
  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <configuration>
      <doclint>none</doclint>
    </configuration>
  </plugin>
</plugins>

Ant可以使用additionalparam配置,参考http://ant.apache.org/manual/Tasks/javadoc.html

Gradle不支持additionalparam配置,可以使用如下方式:

1
2
3
4
5
6
7
if (JavaVersion.current().isJava8Compatible()) {
  allprojects {
    tasks.withType(Javadoc) {
      options.addStringOption('Xdoclint:none', '-quiet')
    }
  }
}

 

posted on   yytxdy  阅读(506)  评论(0编辑  收藏  举报
努力加载评论中...

点击右上角即可分享
微信分享提示