web-dev-qa-db-fra.com

Comment utiliser la documentation du SDK Android hors connexion

J'ai téléchargé la documentation du SDK Android à l'aide du Gestionnaire de SDK, pour l'utiliser avec Android Studio v2.3.0.8, hors connexion.

Mais chaque fois que j'appuie sur ctrl + q pour afficher des informations rapides sur un membre de type, il affiche "Fetching Documentation ...", et après une attente de ~ 20 secondes, il affiche les informations.

Je ne veux pas de ce délai ni de l'aide en ligne, et la documentation locale est en place, alors pourquoi est-ce? ?__. Et quelle est la solution?

Edit: Cela se produit lorsque je suis en ligne, mais aucun retard du tout lorsque je suis hors ligne , Comme si le IDE essayait d'obtenir une nouvelle version de la documentation.

androidandroid-studio-2.3
22
user7736965

Solution améliorée pour l'affichage de la documentation (à partir des sources).

Si vous téléchargez la documentation via le gestionnaire de SDK (elle se trouvera dans .../sdk/docs/reference), vous constaterez que vous utiliserez only 24 API documentation. (Imaginez, votre SDK cible du projet est 25 ou 22, par exemple).

 Only 24 API in downloaded documentation

Pour résoudre ce problème, vous avez besoin de:

  1. Supprimer la documentation via le gestionnaire de SDK dans Android Studio .  Delete documenattion in SDK manager
  2. Là, téléchargez les sources pour les API intéressées (les sources contiennent déjà de la documentation) Aussi, j’ai trouvé que récupérer documentation from sources un peu plus rapidement que le mode hors connexion dans .../sdk/docs/reference.  Download sources via SDK manager for interested APIs

  3. Supprimez tous les chemins d'accès javadoc de jdk.table.xml. Chemin d’accès à ce fichier sous 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. Redémarrez Studio. Prendre plaisir!
27
oxied

Je l'ai également téléchargé et j'ai constaté qu'Android Studio n'avait pas généré correctement la variable javadocPath dans jdk.table.xml. Le fichier ressemble à cela (partie contenant la balise jdk portant le nom 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>
      ...

Le fichier se trouve à Android Studio Configuration folder/config/options/jdk.table.xml

Notez que la variable javadocPath pointe vers l’URL en ligne, remplacez-la simplement par votre copie locale. Dans mon cas, le dossier docs est dans /home/mauricio/Android-sdk/docs, dans Windows, cela ressemble à C:/Android-sdk/docs.

La structure d'URL que vous devez suivre est file://<path-to-sdk>/docs/reference

Vous devez indiquer le dossier reference à l'intérieur de la documentation.

Ça va ressembler à quelque chose comme ça:

  <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" />

Ensuite, s'il est en cours d'exécution, redémarrez Android Studio et le tour est joué.
J'ai aussi un disque SSD, et la documentation hors ligne le rend ouvert instantanément.

Remarque: Vous devez faire cela dans tous les javadocPath dans le fichier (assez facile avec Replace all dans n'importe quel éditeur de texte), et lorsque vous téléchargez une nouvelle API Android, vous devez le refaire car il génère l'URL pointant vers la documentation en ligne.

Je pense que c'est un bogue dans Android Studio, car les variables sourcePath et classPath sont détectées et générées correctement. Cela vaut la peine de leur rendre compte.

16
Mauricio

Pour sdk tools v26, utilisez la ligne de commande:

PATH_TO_SDK/tools/bin/sdkmanager "docs"

Allez ensuite dans le répertoire PATH_TO_SDK/docs et ouvrez le fichier index.html .

2
OMar Mohamed

Une façon de corriger config/options/jdk.table.xml consiste à arrêter l'EDI, à supprimer le fichier et à redémarrer. Le IDE recherche les kits de développement logiciel installés et régénère le fichier d'options.

J'ai eu des problèmes avec une mise à niveau d'une version d'aperçu à la version 3.2 et la documentation a été lente à afficher, et ce qui précède a résolu le problème.

1
Mike Hanafey