警告: @param 没有说明没有定义

最新推荐文章于 2025-05-23 23:27:02 发布

原创最新推荐文章于 2025-05-23 23:27:02 发布 · 7.1k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#javadoc #Error24 #8 警告 param 没有说明 #param 没有说明

技术博客专栏收录该内容

6 篇文章

订阅专栏

本文介绍了一种有效解决Android项目中因第三方lib库导致的@param警告的方法。通过调整build.gradle配置，无需手动修改每个@param注释即可消除警告。

转载请注明出处:http://blog.youkuaiyun.com/moushao/article/details/56009239

今儿同事集成了一个第三方的lib库,更新下来,clean项目没错没警告,但是编译项目的时候就报出警告
警告: @param 没有说明
警告: @param 没有定义

如图:

方式方法一:在每一个 @param XXX 后添加说明,比如 @param teacher 我是苍老师,没有定义的,按照如此格式添加定义便可
但是,一般一个项目下来会成千上万个这种方式定义的,总不能都手改吧.

看了下配置文件,和同事的并没有差别,但是同事可以正常编译而我的不行.
百度并看了下源码,初步判定还是相关配置的问题.但国内各大网站也没有一个正确明了的解决方法,翻墙出去,找到了答案,在第三方库的build.gradle中添加如下代码:

lintOptions {
    abortOnError false
}

tasks.withType(Javadoc) {
    options.addStringOption('Xdoclint:none', '-quiet')
    options.addStringOption('encoding', 'UTF-8')
    options.addStringOption('charSet', 'UTF-8')
}


如图:

但是有一个疑问,编译成功后,我再删除

tasks.withType(Javadoc) {
    options.addStringOption('Xdoclint:none', '-quiet')
    options.addStringOption('encoding', 'UTF-8')
    options.addStringOption('charSet', 'UTF-8')
}

这段代码,却又不报错了.