Cualquier forma de incrustar javadoc en un tarro

¿Hay una manera de incrustar javadoc (carpeta / doc producida por JavaDoc Ant Task) en mi jar biblioteca que contiene mis archivos .class?

Preferiría no enviar la fuente y quisiera que los usuarios pudieran ver los comentarios del javadoc en eclipse sin tener que ir a través de la lengüeta de las bibliotecas referenciadas y agregar la cremallera de JavaDoc a mi lib de tercera persona.

Seguro que puede poner javadoc en su archivo binario JAR … pero ¿realmente tiene sentido?

Para leer los javadocs, un usuario va a tener que desempaquetar los archivos HTML del archivo JAR en el sistema de archivos de Android, y luego apuntar el navegador de Android en el archivo index.html (o lo que sea). Pero el mejor modelo para usar el archivo JAR para ejecutar su código NO es descomprimirlo. Y si no esperas que tus usuarios intenten ver el javadoc en sus teléfonos (!?!) … entonces poner los javadocs en el archivo JAR es "peso muerto".

Tiene mucho más sentido distribuir el árbol javadoc en un archivo ZIP o tar separado.

Por último, si espera que los usuarios desarrollen código en contra de las API de su producto, será mucho más fácil para ellos si les proporciona código fuente. Obtendrá una mejor satisfacción del cliente, menos solicitudes de asistencia para ayudarles a depurar su código y menos quejas injustificadas sobre el funcionamiento del código.

Seguro que puede actualizar un archivo jar de esta manera.

jar uf <your_jar> doc/<your doc file>

  • Javadoc en Eclipse no reconoce paquetes
  • Cómo generar javadoc para la biblioteca de Android cuando tiene dependencias que también son bibliotecas aar?
  • Heredar JavaDoc desde Android SDK con Gradle
  • generar Java docs android studio
  • Cómo generar android estilo javadocs?
  • ¿Existe un estándar de documentación para atributos personalizados de estilo XML en Android?
  • Generar JavaDocs con el complemento Android Gradle
  • Documentación multilingüe de Android Sdk
  • Gradle, Javadoc y la documentación de Android
  • Generar un Javadoc para mi proyecto de Android
  • Cambiar plantilla de autor en Android Studio
  • FlipAndroid es un fan de Google para Android, Todo sobre Android Phones, Android Wear, Android Dev y Aplicaciones para Android Aplicaciones.