我正在使用这个gradle任务为我的Android项目生成javadoc:
android.applicationVariants.all { variant ->
task("generate${variant.name.capitalize()}Javadoc", type: Javadoc) {
description "Generates Javadoc for $variant.name."
source = variant.javaCompile.source
classpath = files(variant.javaCompile.classpath.files, project.android.getBootClasspath())
exclude '**/BuildConfig.java'
exclude '**/R.java'
options.links("http://docs.oracle.com/javase/7/docs/api/");
options.linksOffline("http://d.android.com/reference","${android.sdkDirectory}/docs/reference");
options {
failOnError false
}
destinationDir = file("${project.projectDir}/javadoc")
}
}
它排除了R.java
,因此我没有在输出目录中获得R.html。
但是,在cannot find symbol class R
行中为我常用的java类生成doc的过程中,我遇到了非常烦人的错误import com.mypackagename.R
。我使用常见的android事件,如R.string.string_res
,所以我无法删除此导入。
是否有正确的方法将符号R
包含在索引中,但不包含在javadoc中,或者至少是为了抑制此错误?
答案 0 :(得分:3)
您可以尝试在代码中添加下两行:
classpath += files("build/generated/source/r/${variant.flavorName}/release")
classpath += files("build/generated/source/buildConfig/${variant.flavorName}/release")
但在这种情况下,您的任务应该依赖于生成R类的任务之一。