我创建了一个使用Doclava生成javadoc的Gradle任务:
我的代码(我的一些方法的参数)引用了Android中定义的类。构建Javadoc时,这些引用正确链接到Android在线参考。但是,当我使用 @ling
标记链接到Android引用时,它不起作用,我会得到类似的内容:
configurations {
jaxDoclet
classpaths
}
dependencies {
// For Doclava JavaDoc
jaxDoclet("com.google.doclava:doclava:1.0.6")
classpaths files('build/intermediates/classes/debug')
classpaths project.files(android.getBootClasspath().join(File.pathSeparator))
}
task javadoc(type: Javadoc) {
source = android.sourceSets.main.allJava
source += fileTree("build/generated/source/r/debug")
title = null
options {
docletpath = configurations.jaxDoclet.files.asType(List)
doclet "com.google.doclava.Doclava"
bootClasspath new File(System.getenv('JAVA_HOME') + "/jre/lib/rt.jar")
classpath += configurations.classpaths.files.asType(List)
addStringOption "public"
addStringOption "federate android", "http://d.android.com/reference"
addStringOption "federationxml android", "http://doclava.googlecode.com/svn/static/api/android-10.xml"
}
}
警告101:未解决的链接/请参阅com中的“Runnable”标记
在similar questions in SO中,建议使用-link
和-linkoffline
标记。但是,当我这样做时,我得到:
javadoc: error - invalid flag: -linkoffline
我使用的是Android Studio 1.5.1和Gradle 2.11。
更新
根据{{3}} these,Doclava似乎不支持-link
和-linksoffline
。如果我使用默认doclet,链接可以正常工作。