在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' ) } } } |
无边沉沦,苦海渡航
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步