2012-02-15 12 views
77

Me gustaría que los comentarios de javadoc contenidos en un archivo jar se muestren en eclipse cuando pase el ratón sobre una clase.Eclipse cómo vincular un recipiente que contiene javadocs/fuente con su binario?

Por ejemplo, después de la descarga JODA-2.0, se obtienen tres frascos:

en Eclipse, [proyecto de click derecho -> Propiedades -> Java Build Path -> Bibliotecas -> ADD JAR ...] incluye el binario en el proyecto (se puede hacer referencia a esas clases) para joda-time-2.0.jar.

Pero, ¿cómo puedo vincular los comentarios source/javadoc contenidos en los otros dos archivos jar para que cuando pase el ratón sobre esas clases vea los javadocs?

Agregar los otros dos jar (joda-time-2.0-javadoc.jar y joda-time-2.0-sources.jar) a la ruta de compilación no vincula los javadocs o la fuente.

Respuesta

63

Puede intentar presionar CTRL + clic en una clase que no tiene una fuente adjunta (haga eso en el editor). Cuando le muestre alguna información sobre la clase, verá el botón que guía para adjuntar el cuadro de diálogo fuente. Haga clic en él y, en el cuadro de diálogo emergente, seleccione la ubicación fuente/javadoc para su clase.

También puede hacer eso desde la configuración de la ruta de compilación del proyecto que está mencionando: seleccione la pestaña de bibliotecas, expanda la biblioteca (jar) que desee y se le ofrecerá elegir: archivo adjunto fuente, archivo adjunto javadoc, ubicación de biblioteca nativa, etc. . Solo elige lo que quieras y edita su configuración actual.

O bien, puede hacer lo que dijo @JB Nizet ...

+8

¿Cuál es la diferencia entre adjuntar ** fuente ** contra adjuntar ** javadoc **? – Pacerier

+0

@Pacerier ** source ** contiene el código fuente del programa, donde ** javadoc ** contiene documentación y comentarios que explican la funcionalidad del programa. –

+1

Aparece el mensaje "El JAR de este archivo de clase pertenece al contenedor 'Android Private libraries' que no permite modificaciones a los archivos adjuntos fuente en sus entradas – Radon8472

9

Haga clic con el botón derecho en el contenedor (el que tiene los archivos de clase), elija "Propiedades", la "ubicación Javadoc", y elija el archivo jar con javadoc. Haga lo mismo para el jar fuente, usando "Java source attachment".

+4

Podría ser solo yo, pero esto solo funciona si Eclipse "reconoce" el archivo como un contenedor. Que es tiene un pequeño icono de jar a su lado. Cuando importo frascos de terceros, aparecen con lo que parece ser el icono del documento. Trabajan muy bien con el código pero haciendo clic derecho en las propiedades No obtengo "ubicación de javadoc". –

+0

Si sus archivos jar están en WEB-INF/lib, no debe hacer clic con el botón derecho sobre ellos (como dijo, aparecen como documentos) sino desde el equivalente dentro de "Web App Libraries" – xtian

66
  1. Haga clic derecho sobre el proyecto -> Construir ruta -> Configurar construir camino
  2. En la nueva ventana, vaya a las "Bibliotecas" lengüeta.
  3. Seleccione la biblioteca y amplíela.
  4. Hay 4 opciones para niños. Seleccione "Ubicación de Javadoc" y haga clic en el botón "Editar" a la derecha.
  5. Ahora puede agregar un archivo jar que contenga los documentos. Esto sería solo un archivo zip con la extensión cambiada a jar. Asegúrese de que dentro del contenedor el index.html esté en la raíz. Puede presionar el botón "Validar" para verificar que todo esté bien.
+0

a 3. Seleccione la biblioteca directamente, no la que figura en las bibliotecas privadas de Android (no hay funcionalidad de edición). A 4: Use Javadoc en Archivos, no URL –

+0

Solo para agregar que si está usando una biblioteca común, puede adjuntar un enlace a la API en línea en lugar de una ruta local codificada a la Archivo JAR. –

9

También puede editar el paquete de clase en el archivo ". Classpath" en su proyecto de eclipse. Esto puede ser útil si quiere modificar muchas entradas a la vez o si desea generar la ruta. p.:

<classpathentry kind="var" path="HOME/3rdparty/junit.jar" sourcepath="/SOURCE/junit_src.zip"/>

+0

+1 respuesta! Estaba pensando en un método así para agregar varios frascos a la vez. –

+0

-1 No desea editar el archivo .classpath directamente. Está destinado a ser utilizado solo por eclipse, no editado manualmente. @Mister Smith realmente da la respuesta correcta aquí. Aunque draganstankovic explica un método que al menos conseguirá el trabajo hecho ... – aaiezza

+0

@scribaniwannabe: Sé que esta no es ni la manera deseada ni la más fácil, pero para los casos de uso que mencioné, funciona mucho más rápido y sin problemas. Sin embargo, debe tener cuidado de usar una sintaxis XML válida. –

0

La forma más sencilla es:

  1. presione Control + (La palabra para la que desea ver el documento de Java)
  2. Aparecerá una página que tiene un botón para conectar la fuente .Haga clic en
  3. Seleccione Ubicación Externa.
  4. Examinar la ubicación en la carpeta Java que su jdk. Que seleccione src .zip.
  5. presione OK.

Problema resuelto.

Cuestiones relacionadas