Jak korzystać z dokumentacji Android SDK offline

Question

Pobrałem dokumentację SDK systemu Android przy użyciu Menedżera SDK, aby używać go z Androidem Studio v2.3.0.8, offline.

Ale za każdym razem, gdy wciskam ctrl + q, aby wyświetlić szybkie informacje o typie, wpisz "Fetching Documentation ...", a po odczekaniu ~ 20s pokazuje informację.

Nie chcę tego opóźnienia ani korzystania z pomocy online, a lokalne dokumenty są na miejscu, więc dlaczego tak jest? Jakie jest rozwiązanie?

Edit: Dzieje się tak, gdy jestem online, ale nie opóźnienie w ogóle, kiedy jestem zalogowany, Jakby IDE próbuje dostać świeżą wersję dokumentów.

Answer 1

Udoskonalone rozwiązanie do wyświetlania dokumentacji (ze źródeł).

Znaleziono, że jeśli pobierzesz dokumentację za pomocą menedżera SDK (będzie ona znajdować się w .../sdk/docs/reference), użyjesz only 24 API documentation. (Wyobraź sobie, że docelowy pakiet SDK dla projektu to na przykład 25 lub 22).

Aby rozwiązać ten problem, trzeba:

1. Delete dokumentacji przez kierownika SDK Android Studio.
2. Tam, pobierz źródła dla zainteresowanych API (źródła zawierają już dokumentację). Zauważyłem także, że pobieranie documentation from sources jest nieco szybsze w porównaniu z offlineem w wersji .../sdk/docs/reference.

3. Usuń wszystkie ścieżki javadoc z jdk.table.xml. Ścieżka do tego pliku na 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. Reboot Studio. Cieszyć się!

Answer 2

Pobrałem go też, i zauważyłem, że Android Studio nie wygenerował javadocPath prawidłowo jdk.table.xml, to jak plik wygląda (części, do której tag jdk z nazwą 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> 
     ... 

Plik znajduje się na Android Studio Configuration folder/config/options/jdk.table.xml

Zauważ, że numer javadocPath wskazuje adres internetowy, po prostu zmień go na lokalną kopię, w moim przypadku folder docs znajduje się pod numerem /home/mauricio/android-sdk/docs, w systemie Windows jest to coś w rodzaju C:/android-sdk/docs.

Struktura url, że masz do naśladowania jest file://<path-to-sdk>/docs/reference

Ty mieć aby wskazać folder reference wewnątrz docs.

To będzie wyglądać mniej więcej tak:

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

Następnie, jeśli jest uruchomiony, uruchom ponownie Android Studio to zrobić.
Mam również dysk SSD, a dokumentacja trybu offline powoduje natychmiastowe otwarcie.

Uwaga: Trzeba to zrobić w ogóle javadocPath w pliku (dość łatwe przy użyciu Replace all w dowolnym edytorze tekstowym), a po pobraniu nowego Androida API, co musisz zrobić to jeszcze raz, ponieważ generuje URL wskazując na dokumenty online.

---

myślę, że jest to błąd w Android Studio, ponieważ sourcePath i classPath jest wykrywany i generowany poprawnie. Warto im raportować.

Answer 3

do narzędzi SDK V26, korzystając z wiersza polecenia:

PATH_TO_SDK/tools/bin/sdkmanager "docs" 

następnie przejdź do katalogu/docs PATH_TO_SDK i otwartej index.html pliku.