programacion - Cómo utilizar la documentación de Android SDK sin conexión

manual de programacion android pdf

Question

He descargado la documentación de Android SDK utilizando el Administrador de SDK, para usarla con Android Studio v2.3.0.8, sin conexión.

Pero cada vez que presiono ctrl + q para mostrar información rápida sobre un tipo | miembro de tipo, muestra "Fetching Documentation ...", y después de esperar ~ 20s, muestra la información.

No quiero ese retraso o el uso de la ayuda en línea, y los documentos locales están en su lugar, ¿por qué es eso? Y cual es la solución ?

Edición: esto sucede cuando estoy en línea, pero no hay demora en absoluto cuando estoy fuera de línea , como si el IDE intentara obtener una versión nueva de los documentos.

Answer 1

Para sdk tools v26, usando la línea de comandos:

PATH_TO_SDK/tools/bin/sdkmanager "docs"

Luego vaya al directorio PATH_TO_SDK / docs y abra el archivo index.html .

Answer 2

También lo descargué, y me di cuenta de que Android Studio no generó el javadocPath correctamente en jdk.table.xml , así es como se ve el archivo (parte que tiene la etiqueta jdk con el nombre Android API ## Platform ):

...
<jdk version="2">
  <name value="Android API 25 Platform" />
  <type value="Android SDK" />
  <homePath value="$USER_HOME$/android-sdk" />
  <roots>
      ...
    <javadocPath>
      <root type="composite">
        <root type="simple" url="http://developer.android.com/reference/" />
      </root>
    </javadocPath>
      ...

El archivo se encuentra en la Android Studio Configuration folder /config/options/jdk.table.xml

Tenga en cuenta que javadocPath apunta a la url en línea, solo cámbielo a su copia local, en mi caso, la carpeta docs está en /home/mauricio/android-sdk/docs , en Windows es algo como C:/android-sdk/docs .

La estructura de URL que debe seguir es file://<path-to-sdk>/docs/reference

Tienes que apuntar a la carpeta de reference dentro de los documentos.

Se verá algo como esto:

  <root type="simple" url="file:///home/mauricio/android-sdk/docs/reference" />
  <!-- if it''s Windows -->
  <root type="simple" url="file://C:/android-sdk/docs/reference" />

Luego, si se está ejecutando, reinicie Android Studio y listo.
También tengo un SSD, y la documentación fuera de línea hace que se abra al instante.

Nota: javadocPath hacer eso en todo javadocPath en el archivo (es bastante fácil usar Replace all en cualquier editor de texto), y cuando descarga una nueva API de Android, debe hacerlo nuevamente porque genera la URL que apunta a los documentos en línea. .

Creo que esto es un error en Android Studio, porque la sourcePath y classPath se detecta y genera correctamente. Vale la pena informarles.

Answer 3

Una forma de arreglar config/options/jdk.table.xml es detener el IDE, eliminar el archivo y reiniciar el anuncio. El IDE encuentra los SDK instalados y regenera el archivo de opciones.

Tuve problemas con una actualización de una versión preliminar a 3.2 y los documentos tardaron en mostrarse, y lo anterior solucionó el problema.

Answer 4

Solución mejorada para mostrar documentación (desde fuentes).

Se encontró que si descarga la documentación a través del administrador de SDK (se ubicará en .../sdk/docs/reference ), only 24 API documentation usará la only 24 API documentation . (Imagínese, el SDK de destino de su proyecto es 25 o 22, por ejemplo).

Para arreglar esto, necesitas:

1. Eliminar la documentación a través del administrador de SDK en Android Studio.
2. Allí mismo, descargue las fuentes para las API interesadas (las fuentes ya contienen documentación). También encontré, que recuperar documentation from sources un poco más rápido en comparación con una sin conexión dentro de .../sdk/docs/reference .

3. Elimine todas las rutas javadoc de jdk.table.xml . Ruta a este archivo en OS X: /Users/.../Library/Preferences/AndroidStudio.../options/jdk.table.xml

   --> Delete all of these and all occurrences -->
   
   <javadocPath>
     <root type="composite">
       <root type="simple" url="http://developer.android.com/reference/" />
     </root>
   </javadocPath>

4. Reiniciar el estudio. ¡Disfrutar!