Question

我正在尝试准备并将我的Android库上传到Bintray，该过程的一部分运行以下javadoc任务：

task javadoc(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}

此任务是此处较大的gradle脚本的一部分： https://raw.githubusercontent.com/attwellBrian/JCenter/master/bintrayv1.gradle

当javadoc任务运行时，会出现以下问题：

项目中的每个@NonNull和@Nullable注释报告错误“错误：找不到符号”
我为Android类编写的每个Javadoc引用，如{@link Toolbar}，都报告错误“error：reference not found”

如何在生成Javadoc时纠正这些引用问题？

修改看起来并非所有Android类链接都会产生问题，它可能只是来自Android支持库的类（也就是注释的来源）。是否需要特殊的东西才能链接到gradle依赖项中的源文件？

Answer 1

您还应该将所有依赖项添加到javadoc.classpath。试试这个：

▲

Answer 2

因此，这些错误意味着JavaDoc无法链接不在同一模块中的类（没有进一步配置）。如果您不关心这一点（即具有模块外部类的超链接），您可以忽略错误

task javadoc(type: Javadoc) {
    failOnError false
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}

See here for more info on the Javadoc Task

Android Studio Javadoc：找不到符号

2 个答案: