android eclipse javadoc

android - Javadoc en Eclipse no reconoce paquetes



(8)

¡las respuestas de arriba son bastante buenas! incluya el classpath en su javadoc.xml y ejecute vía ant-command o eclipse -> Ejecutar como -> Ant Build

¡PERO asegúrese de que no haya espacios en blanco en los caminos! Tuve este problema con C: / Program Files / ... y no funcionó hasta que lo cambié a C: / Progra ~ 1 / ...

también poner el camino entre comillas no funcionó para mí.

Gracias a este hilo , pude obtener enlaces de Javadoc para trabajar en mi proyecto de Android dentro de Eclipse en Windows. En concreto, "{@link android.widget.Toast}" se está convirtiendo actualmente en un enlace a " http://d.android.com/reference/android/widget/Toast.html?is-external=true ". Lo logré con la opción Javadoc:

-linkoffline http://d.android.com/reference "file: / C: / Android / android-sdk-windows / docs / reference"

Sin embargo, recibo errores como los siguientes basados ​​en líneas de mi código Java (no en los comentarios de Javadoc):

C:/Users/Ellen/workspace/TestableToast/src/edu/mills/cs180/HelloAndroid.java:5: package android.view does not exist import android.view.View; ^ C:/Users/Ellen/workspace/TestableToast/src/edu/mills/cs180/HelloAndroid.java:6: package android.view.View does not exist import android.view.View.OnClickListener; ^ C:/Users/Ellen/workspace/TestableToast/src/edu/mills/cs180/HelloAndroid.java:8: package android.widget does not exist import android.widget.Toast; ^ C:/Users/Ellen/workspace/TestableToast/src/edu/mills/cs180/HelloAndroid.java:10: cannot find symbol symbol: class Activity public class HelloAndroid extends Activity implements OnClickListener { ^

¿Cómo puedo arreglar estas referencias?

Esta solución en eclipse funcionó para mí:

  1. Vaya a Proyecto => Propiedades y seleccione "Ruta de compilación Java"
  2. Seleccione la pestaña "Ordenar y exportar"
  3. Mueva "android 2.xx" y "Dependencias de Android" a la parte superior de la lista

Esto funciona en Eclipse para mí:

  1. Proyecto -> generar Javadoc
  2. Vaya a "Configurar argumentos de Javadoc".
  3. en las opciones de VM, agregue "-bootclasspath /path/to/sdk/platforms/android-##/android.jar"

Gracias a la respuesta proporcionada por @PaŭloEbermann y @ MarcelD-B, pude entender la causa raíz del problema. Sin embargo, dado que estoy usando Android Studio , estaba un poco confundido en cuanto a dónde agregar el argument. Después de un tiempo, pude resolverlo finalmente y lo estoy poniendo aquí como respuesta para cualquier otra persona que encuentre un problema similar.

Para Android Studio , abra Tools > Generate JavaDocs y agregue el siguiente argument en Other command line arguments: -

-bootclasspath /path/to/sdk/platforms/android-##/android.jar

Nota: - No es necesario agregar comas en el argument. Sin embargo, si su SDK Path contiene espacios, incluya la ruta entre comillas dobles ( " ). Por ejemplo, mi SDK Path contiene espacios, así que usé el argument :

-bootclasspath "F:/Android SDK/platforms/android-21/android.jar"

Proyecto> generar Javadoc. Luego, vaya a "Configurar argumentos de Javadoc" y en las opciones de VM agregue "-bootclasspath /path/to/sdk/platforms/android-##/android.jar".

Trabajó para mi :)

También debe colocar las clases de Android en su classpath javadoc. Para esto, agregue el archivo android jar al argumento -classpath de javadoc (como lo haría con su compilador).

Sin embargo, no tengo ni idea de dónde y dónde Eclipse le da alguna opción de configuración para esto.

Solución Windows Eclipse

Agregar android.jar a -classpath es de hecho el enfoque correcto. No ANT es necesario, aunque también viable. En caso de que desee utilizar la GUI de Eclipse (Archivo-> Exportar-> Java-> Javadoc) para generar Javadoc, no hay opción para editar la ruta de clases en el cuadro de diálogo. Necesita tener el classpath configurado correctamente de antemano. Dos formas de lograr eso:

  1. Edite manualmente el <path_to_your_project>/.classpath y agregue la siguiente línea:

    <classpathentry kind="lib" path="<path_to_your_android_skd>/platforms/android-<version>/android.jar"/>

  2. Haga clic derecho en su proyecto-> Propiedades-> Java Build Path-> Libraries-> Add External JARs-> navigate to <path_to_your_android_skd>/platforms/android-<version>/android.jar

Encontré el enfoque de la GUI de Eclipse mejor que el uso de ANT que se insinuó en algunas de las respuestas aquí porque se obtienen referencias clicables a su código fuente en cualquier advertencia / error de Javadoc en la Consola. Al usar ANT, todo lo que obtiene en la consola es la salida impresa del comando javadoc.exe.

No -classpath parámetro para agregar -classpath en la última pantalla del asistente "Generate Javadoc ...": recibí un mensaje de error que decía que el parámetro -classpath solo se puede especificar una vez.

No es realmente una solución, sino una solución:

  • En el asistente "Generate Javadoc ...", marque la opción "Guardar la configuración de esta exportación Javadoc como un script Ant". Esto genera el archivo javadoc.xml en el directorio del proyecto
  • Edite el archivo javadoc.xml y edite el atributo classpath. Específicamente, agregue "/ruta/a/sdk/plataformas/android-##/android.jar" allí y cualquier otra jarra de la que reciba mensajes de advertencia sobre
  • Genera el javadoc con: ant -buildfile javadoc.xml . Para su comodidad, puse esta línea en un javadoc.sh shell javadoc.sh .