安卓工作室Javadoc : Cannot find symbol

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任务运行时出现如下问题:

1. 项目中的每一个@NonNull和@Nullable注解都报“error: cannot find symbol”的错误
2. 我为 Android 类编写的每个 Javadoc 引用，例如 {@link Toolbar}，都会报告错误“错误:找不到引用”

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

编辑 看起来并不是所有的 Android 类链接都产生了问题，它可能只是来自 Android 支持库的类(这也是注释的来源)。是否需要做一些特殊的事情来链接到 gradle 依赖项中的源文件？

Answer 1

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

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

afterEvaluate {
    javadoc.classpath += files(android.libraryVariants.collect { variant ->
        variant.javaCompileProvider.get().classpath.files
    })
}