Android Studio Javadoc:找不到符号 [英] Android Studio Javadoc: Cannot find symbol

问题描述

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

I'm trying to prepare and upload my Android library to Bintray and part of that process runs the following javadoc task:

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

This task is part of a larger gradle script here: https://raw.githubusercontent.com/attwellBrian/JCenter/master/bintrayv1.gradle

javadoc任务运行时，出现如下问题:

When the javadoc task runs, the following problems occur:

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

如何在生成 Javadoc 时更正这些参考问题?

How can I correct these reference issues when generating Javadocs?

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

EDIT It looks like its not all Android class links that are creating an issue, it may just be classes that come from the Android support library (which is also where the annotations come from). Does something special need to be done to link to source files in gradle dependencies?

推荐答案

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

You should also add all your dependency to the javadoc.classpath. Try this:

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
    })
}

这篇关于Android Studio Javadoc:找不到符号的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！