Heredar JavaDoc desde Android SDK con Gradle

Problema:

Quiero añadir algo de JavaDoc que se hereda del SDK de Android. Sin embargo, Gradle JavaDoc no parece ser capaz de encontrar el código fuente de Android y por lo tanto ignora la etiqueta de {@inheritDoc} .

Clase de ejemplo

 public class MyCursor implements android.database.Cursor { /** * {@inheritDoc} */ public int getCount() { return 42; } // ... All other interface methods } 

Tarea Gradle

 def javadocTask = task("javadoc${variant.name.capitalize()}", type: Javadoc) { description "Generates Javadoc for $variant.name." group 'Docs' source = variant.javaCompile.source source files("${android.sdkDirectory}/sources/${android.compileSdkVersion}") ext.androidJar = files(plugins.findPlugin("com.android.library").getBootClasspath()) classpath = files(variant.javaCompile.classpath.files) + ext.androidJar include 'my/package/**' exclude 'my/package/internal/**' exclude '**/BuildConfig.java' exclude '**/R.java' } 

Algunas especulaciones:

  • El SDK de Android utiliza @hide mucho que bloquea la generación de JavaDoc.

  • El uso de excluir también parece impedir la herencia de esas clases.

FlipAndroid es un fan de Google para Android, Todo sobre Android Phones, Android Wear, Android Dev y Aplicaciones para Android Aplicaciones.