Я создал задачу Gradle, которая генерирует javadoc, используя Doclava:
Мой код (аргументы некоторых моих методов) ссылается на классы, определенные в 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: неразрешенная ссылка/см. тег "Runnable" в ком...
В похожих вопросах в SO, рекомендуется использовать флаги -link
и -linkoffline
. Однако, когда я это делаю, я получаю:
javadoc: error - invalid flag: -linkoffline
Я использую Android Studio 1.5.1 и Gradle 2.11.
Обновление
Кажется, что Doclava может не поддерживать -link
и -linksoffline
в соответствии с эти билеты. Если я использую стандартный doclet, ссылки работают правильно.