plugin para descargar complemento android eclipse adt javadoc

para - java android eclipse



¿Cómo adjuntar javadoc o fuentes a los tarros en la carpeta libs? (12)

En ADT 22 no pude acceder a Javadoc para commons-io-2.4.jar y android-support-v4.jar

Así es como lo arreglé:

  1. Condición previa: ambas bibliotecas se enumeran en "Bibliotecas de referencia".

  2. Haga clic con el botón derecho en commons-io-2.4.jar y seleccione Propiedades. Aparece esta ventana:

commons-io-2.4.jar se incluye con commons-io-2.4-javadoc.jar, por lo que especifiqué el Javadoc en el archivo Ruta del archivo externo.

Hice lo mismo para la biblioteca de soporte: haga clic derecho en android-support-v4.jar y seleccione Propiedades. Aparece esta pantalla:

Esta vez especifiqué la ruta al directorio de origen.

La nueva versión del complemento ADT r17 para Eclipse ha agregado la función para configurar automáticamente las dependencias JAR. Todos los archivos .jar en la carpeta / libs se agregan a la configuración de compilación ahora. Desafortunadamente, el contenedor classpath de Android Dependencies no es modificable.

¿Cómo puedo adjuntar javadoc y fuentes al archivo .jar insertado automáticamente (desde la carpeta / libs)?

En Windows, debe escapar de la barra diagonal inversa para obtener referencias a las rutas doc y src en el archivo de propiedades. Por ejemplo, para android-support-v4.jar el contenido del archivo de propiedades es algo así como:

doc=C://Program Files (x86)//Android//android-sdk//extras//android//support//v4//docs src=C://Program Files (x86)//Android//android-sdk//extras//android//support//v4//src

Intenté todo lo anterior y ninguno de ellos funcionó para mí. Descubrí un método que siempre funcionará. Básicamente, el culpable es la forma en que el ADT trata la carpeta "libs", por lo que dejé de usar la carpeta "libs". En cambio, creé una carpeta de "bibliotecas" y la usé.

Puede hacer lo siguiente y siempre funcionará, incluso si el ADT debería cambiar la forma en que cambia la forma en que trata la carpeta "libs" en el futuro:

  1. Crear una carpeta de "bibliotecas".
  2. Cree una subcarpeta debajo de cada biblioteca.
  3. Coloque todos los archivos para cada biblioteca en la carpeta apropiada (archivo jar de java, archivo jar de origen, archivo jar de javadoc, etc.).
  4. Agregue el archivo jar de java para cada proyecto en la pestaña "Bibliotecas" de Java Build Path haciendo clic en el botón Agregar tarros ... para agregar el tarro de la subcarpeta de la biblioteca en la carpeta "bibliotecas".
  5. Adjunte la fuente / javadocs a cada proyecto abriendo el proyecto en la pestaña "Bibliotecas", seleccionando el elemento deseado y haciendo clic en el botón Editar ... para agregar la fuente / javadocs desde la subcarpeta de la biblioteca en las "bibliotecas" carpeta.
  6. Marque la casilla de verificación de cada proyecto en la pestaña "Ordenar y exportar" para la ruta de compilación de Java.
  7. Después de verificar que todas las bibliotecas se han movido, elimine la carpeta "libs".

Al seguir el procedimiento anterior, su proyecto tendrá carpetas que se verán así:

Tu Java Build Path se verá así:

En Orden y Exportación las bibliotecas están marcadas:

La mejor manera de responder a su pregunta es resumir las respuestas de code.google.com/p/android/issues/detail?id=27490#c21 , plastiv , VinceFR y Christopher .

Guía paso por paso

Para vincular las fuentes y javadoc a una biblioteca .jar que Eclipse vincula automáticamente, debe hacer lo siguiente:

  1. Coloque el archivo .jar de la biblioteca en la carpeta libs y los archivos .jar y .jar de origen asociados en subcarpetas separadas, como libs / src y libs / docs . Puede usar un nombre que no sea src y docs si lo desea, pero es importante que los archivos .jar no estén directamente en la carpeta libs .
  2. Cree un archivo .properties en la carpeta libs con el nombre exacto de la biblioteca real .jar (ver ejemplo). Asegúrate de mantener la parte .jar .
  3. Especifique las rutas relativas a las fuentes y javadoc .jar en el archivo .properties .
  4. ¡Cierra y vuelve a abrir el proyecto Eclipse! Opcionalmente, actualice el proyecto presionando F5 .
  5. Seleccione un objeto de la biblioteca vinculada en el código fuente.
  6. Abra la vista Javadoc en Eclipse para verificar la documentación (ver captura de pantalla).
  7. Abra la declaración del código fuente (acceso directo predeterminado: F3 ) del objeto seleccionado.


Ejemplo

El ejemplo utiliza la biblioteca Gson .

Estructura de directorios de la carpeta libs:

libs ├── docs │   └── gson-2.2.2-javadoc.jar ├── gson-2.2.2.jar ├── gson-2.2.2.jar.properties └── src └── gson-2.2.2-sources.jar

Contenido de gson-2.2.2.jar.properties

src=src/gson-2.2.2-sources.jar doc=docs/gson-2.2.2-javadoc.jar


Información Adicional

Por supuesto, puede mover el javadoc y las fuentes .jar a otras carpetas y especificar rutas relativas. Eso depende de usted. Es posible colocar los archivos fuente y javadoc directamente en la carpeta lib, pero no es recomendable , ya que eso hace que la documentación y el código fuente se incluyan en su aplicación .


Captura de pantalla del panel JavaDoc de Eclipse:

Captura de pantalla de un proyecto de Eclipse usando Gson con Android 4.2.2 .:

Referencia de javadocs desempaquetados

En el caso de que desee hacer referencia a javadocs que no se proporcionan como un .jar empaquetado, sino simplemente como archivos y carpetas según lo solicitado por el desarrollador de Android en los comentarios, haga lo siguiente:

  1. Coloque la biblioteca .jar en la carpeta libs/

  2. Cree un archivo yourlibraryname.jar.properties ( no olvide el archivo .jar ) con el siguiente contenido:

    doc=docs

  3. Agregue las carpetas javadocs a la carpeta libs/ .

Debería venir con la siguiente estructura de carpetas:

├── docs │   ├── allclasses-frame.html │   ├── allclasses-noframe.html │   ├── com │   │   └── google │   │   └── ads │   │   ├── Ad.html │   │   │  .... │   │   └── package-tree.html │   │   ... │   └── stylesheet.css ├── GoogleAdMobAdsSdk-6.4.1.jar └── GoogleAdMobAdsSdk-6.4.1.jar.properties

¡No olvide cerrar y volver a abrir el proyecto Eclipse como se mencionó anteriormente! Aquí hay una captura de pantalla de un proyecto de ejemplo de trabajo que hace referencia a la biblioteca de Android GoogleAdMobAds .

La referencia de la biblioteca a commons-io-2.0.1.jar se rompió cuando actualicé a SDK Tools y ADT revisión 17.

Para resolver el problema, utilicé Project -> Properties -> Java Build Path y seleccioné la pestaña Libraries. Eliminé cualquier referencia a commons-io-2.0.1.jar y luego usé Add Jar para volver a agregar commons-io-2.0.1.jar al proyecto. Luego hago clic en la flecha ''>'' al lado del nombre de la biblioteca para expandir la referencia de la biblioteca y utilicé los botones de edición para configurar el archivo adjunto de Source y la ubicación de Javadoc.

Lo siento, no puedo publicar una imagen porque no tengo suficiente representante (por favor ...).

Mi solucion

Descargue un plugin de eclipse llamado: "Característica del atacante de origen Java".

Más tarde, seleccione un tarro y adjunte el código fuente utilizando este complemento. Haga clic en el archivo jar para seleccionarlo, a la derecha del botón del mouse, y luego seleccione "adjuntar java source".

Cuando tienes el código fuente tienes automáticamente el javadoc.

Ahora puede usar F2 sobre las clases para ver el javadoc asociado.

Disfrutar

Para cualquier tarro dado, si desea ver la ayuda de Javadoc en la información sobre herramientas mientras codifica, haga lo siguiente: Haga clic con el botón derecho en su proyecto> Propiedades> Ruta de compilación de Java> Ficha Bibliotecas. Haga clic en la flecha al lado de su frasco para expandir.

Los datos adjuntos de origen deben apuntar a la ubicación del tarro real (probablemente justo en su carpeta Java).

Ubicación de Javadoc : tienes dos opciones aquí: URL y archivo. Si sus javadocs para este jar tienen la forma de una carpeta que contiene un archivo index.html en el primer nivel, elija ''URL de Javadoc'' y apunte a esa carpeta. Si sus javadocs están en un tarro, elija ''Javadoc en archivo'' y apunte al tarro. No olvide reiniciar su área de trabajo / cerrar y reabrir su proyecto para actualizar la información sobre herramientas con la información de Javadoc.

Espero que esto ayude a dar una respuesta simple para lo que creo que debería ser una tarea muy simple.

Parece ser un objetivo en movimiento, pero después de haber recopilado fragmentos y piezas de muchos lugares (incluidas las respuestas a esta pregunta que ayudó pero no pudo describir todos los detalles necesarios, o quizás el sistema haya cambiado ligeramente mientras tanto), parece ser La solución, al menos a partir de ahora (28 de agosto de 2013).

  • Abre una carpeta para tus javadocs en algún lugar que no esté dentro de tu proyecto.
  • Ponga sus javadocs allí descomprimidos, cada uno en su propia carpeta.
  • Dentro de su carpeta lib , agregue un archivo xxx.jar.properties para cada lib con la que desee asociar un javadoc.
  • En ese archivo de propiedades, consulte la carpeta en la que descomprimió el javadoc apropiado (en Windows, evite las barras invertidas):

doc=d://Android//javadoc//libGoogleAnalyticsServices

  • Cierre y vuelva a abrir su proyecto en Eclipse (actualizar no es suficiente). Ahora debería ver la información sobre herramientas cuando se desplaza sobre las clases apropiadas.

No cumplir con ninguno de estos pasos (no descomprimir el javadoc, hacer referencia a un archivo en lugar de una carpeta, etc.) parece romperlo.

Por ahora, mueva la biblioteca que desea a Javadoc a lib . Ellos agregan esa biblioteca a la Build Path y agregan el Javadoc.

Compruebe este comment en los temas de Android.

Sé que esta pregunta es bastante antigua, pero cuando enfrenté el mismo problema ayer y la solución publicada anteriormente era demasiado molesta para mí, descubrí que uno puede agregar fácilmente una definición de ruta de origen al archivo .classpath del proyecto. Eclipse lo adaptará y podrá navegar por la fuente.

entrada classpath antes:

<classpathentry kind="lib" path="[PATH_TO_MY_JAR]"/>

Después de agregar el camino a la fuente

<classpathentry kind="lib" path="[PATH_TO_MY_JAR]" sourcepath="[PATH_TO_MY_SOURCE_JAR]"/>

Espero que esto ayude

Una respuesta proviene de code.google.com/p/android/issues/detail?id=27490#c21

En tu carpeta libs, debes tener:

doc(folder) foo_doc(folder) index.html ... ... foo.jar foo.jar.properties

Y en su foo.jar.properties , simplemente ponga doc=./doc/foo_doc

Tal vez tendrá que actualizar su proyecto, limpiarlo, cerrarlo y volver a abrirlo.

¡Esto funciona para mi!

acaba de actualizar el complemento ADT. ¡Eso funcionó para mí!

  1. Inicie Eclipse, luego seleccione Ayuda> Instalar nuevo software.
  2. Haga clic en Agregar, en la esquina superior derecha.
  3. En el cuadro de diálogo Agregar repositorio que aparece, ingrese "Complemento ADT" para el Nombre y la siguiente URL para la Ubicación: https://dl-ssl.google.com/android/eclipse/ Nota: El sitio de actualización de Android Developer Tools requiere una conexión segura. Asegúrese de que la URL del sitio de actualización que ingrese comience con HTTPS.
  4. Haga clic en Aceptar. En el cuadro de diálogo Software disponible, seleccione la casilla de verificación junto a Herramientas de desarrollo y haga clic en Siguiente.
  5. En la siguiente ventana, verá una lista de las herramientas que se descargarán. Haga clic en Siguiente.
  6. Lea y acepte los acuerdos de licencia, luego haga clic en Finalizar.
  7. Si recibe una advertencia de seguridad que dice que no se puede establecer la autenticidad o validez del software, haga clic en Aceptar.
  8. Cuando finalice la instalación, reinicie Eclipse

¡Espero que ayude!