¿Cómo creo un jar distributable para javadocs?

Question

He creado una API que publico como un archivo JAR. Es propietario, así que tuve que quitar los archivos fuente.

Actualmente incluyo una carpeta separada/doc que contiene el resultado del asistente de export-to-javadoc de Eclipse. No está mal, pero me gustaría dar un paso más.

Me gustaría distribuir javadocs como un archivo jar que se puede soltar fácilmente en un proyecto futuro que incluye el archivo jar para mi API. Sé que lo he visto así varias veces con otras distribuciones que he usado, pero no he tenido suerte buscando.

El objetivo final es permitir a los futuros desarrolladores tener un fácil acceso para pasar el mouse sobre los comentarios y cosas de esa naturaleza.

Gracias!

Answer 1

Parece que es suficiente para empaquetar el carpeta documento que contiene el eclipse documentación generada como un archivo jar . Entonces, si usted desea utilizar el frasco como javadocs de la jarra real que contiene los archivos .class compilados, se asigna el tarro de javadoc con el "Javadoc en el archivo" en Eclipse y establecer la ruta de dentro del mismo archivo como doc. Parece que Eclipse busca index.html y lista de paquetes entradas en la carpeta doc.

También usar maven-javadoc-plugin puede ser una manera fácil de hacerlo. Consulte el siguiente enlace:

http://www.avajava.com/tutorials/lessons/how-do-i-generate-and-deploy-a-javadoc-jar-file-for-my-project.html

Answer 2

Si su objetivo final es sólo para los futuros desarrolladores puedan ver sus instrucciones javadoc cuando están utilizando sus clases o métodos, en Eclipse que puede tener la opción de exportar java archivos de origen al exportar su biblioteca frasco como se muestra en la siguiente imagen:

Esto también permite a los desarrolladores a intervenir y ver sus códigos durante la depuración.