使用doclava生成Javadoc时Nullable注释出错

Question

我正在尝试使用Android Studio中的Doclava为Android库生成Javadoc。源代码使用＆＃34; Nullable＆＃34;在某些时候标记，这会在生成javadoc时导致崩溃：

  

在doclet类com.google.doclava.Doclava中，方法start抛出异常java.lang.reflect.InvocationTargetException   com.sun.tools.javac.code.Symbol $ CompletionFailure：找不到javax.annotation.Nullable的类文件

我可以以某种方式克服这个问题吗？

Answer 1

我必须在Javadoc的类路径中包含findbugs：jsr305库。

所以，在我的Gradle配置中，我添加了：

dependencies {

    // For Doclava JavaDoc
    jaxDoclet("com.google.doclava:doclava:1.0.6")
    classpaths files('build/intermediates/classes/release')
    classpaths 'com.google.code.findbugs:jsr305:3.0.1'
}

task javadoc(type: Javadoc) {
     //.... the rest of the configuration
     options {
         classpath += configurations.classpaths.files.asType(List)
         //.... the rest of the configuration
      } 
}  

Answer 2

对于此例外情况，请点击此处：https://code.google.com/p/android/issues/detail?id=1261

只需将-XDignore.symbol.file添加到命令的末尾，它就可以删除此异常。