Nowa wersja wtyczki ADT r17 do Eclipse dodaje funkcję automatycznego ustawiania zależności JAR. Wszelkie pliki .jar w folderze / libs są teraz dodawane do konfiguracji kompilacji. Niestety kontener ścieżki klas zależności systemu Android jest niemodyfikowalny.

Jak mogę dołączyć javadoc i źródła do automatycznie wstawionego pliku .jar (z folderu / libs)?

Najlepszym sposobem na udzielenie odpowiedzi na pytanie jest streszczenie odpowiedzi Xaviera , plastiva , VinceFR i Christophera .

Przewodnik krok po kroku

Aby połączyć źródła i javadoc z biblioteką .jar, która jest automatycznie łączona przez Eclipse, musisz wykonać następujące czynności:

1. Umieść plik .jar biblioteki w folderze libs , a powiązane źródłowe pliki .jar i doc .jar w osobnych podfolderach, takich jak libs / src i libs / docs . Jeśli chcesz, możesz użyć nazwy innej niż src i docs , ale ważne jest, aby pliki .jar nie znajdowały się bezpośrednio w folderze libs .
2. Utwórz .propertiesplik w folderze libs z dokładną nazwą faktycznej biblioteki .jar (patrz przykład). Upewnij się, że zachowałeś część .jar .
3. Określ względne ścieżki do źródeł i .propertiespliku javadoc .jar w pliku.
4. Zamknij i ponownie otwórz projekt Eclipse! Opcjonalnie odśwież projekt, naciskając F5.
5. Wybierz obiekt połączonej biblioteki w kodzie źródłowym.
6. Otwórz widok Javadoc w Eclipse, aby sprawdzić dokumentację (patrz zrzut ekranu).
7. Otwórz deklarację kodu źródłowego (domyślny skrót:) F3wybranego obiektu.

Przykład

W przykładzie użyto biblioteki Gson .

Struktura katalogów folderu 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

Zawartość pliku gson-2.2.2.jar.properties

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

Dodatkowe informacje

Oczywiście możesz przenieść javadoc i źródła .jar do innych folderów i określić ścieżki względne. To zależy od Ciebie. Umieszczenie słoika źródłowego i javadoc bezpośrednio w folderze lib jest możliwe, ale nie zalecane , ponieważ powoduje to dołączenie dokumentacji i kodu źródłowego do aplikacji .

Zrzut ekranu panelu Eclipse JavaDoc:

Zrzut ekranu projektu Eclipse przy użyciu Gson z Androidem 4.2.2 .:

Odwoływanie się do rozpakowanych javadocs

Jeśli chcesz odwoływać się do javadoców, które nie są dostarczane jako spakowane, .jarale po prostu jako pliki i foldery, o które prosi deweloper Androida w komentarzach, wykonaj następujące czynności:

1. Umieść bibliotekę .jarw libs/folderze

2. Utwórz yourlibraryname.jar.propertiesplik ( nie zapomnij.jar ) o następującej treści:

    doc=docs

3. Dodaj foldery javadocs do libs/folderu.

Powinieneś wymyślić następującą strukturę folderów:

├── 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

Nie zapomnij zamknąć i ponownie otworzyć projektu Eclipse, jak wspomniano powyżej! Oto zrzut ekranu działającego przykładowego projektu odwołującego się do biblioteki GoogleAdMobAds na Androida .

W systemie Windows musisz uciec od ukośnika odwrotnego, aby uzyskać odniesienia do ścieżek doc i src w pliku właściwości. Przykład: dla pliku android-support-v4.jar zawartość pliku właściwości przypomina:

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

Odpowiedź pochodzi z http://code.google.com/p/android/issues/detail?id=27490#c21

W folderze libs musisz mieć:

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

I w twoim foo.jar.properties, po prostu włóżdoc=./doc/foo_doc

Być może będziesz musiał odświeżyć swój projekt, wyczyścić go, zamknąć i ponownie otworzyć.

Mi to pasuje!

Próbowałem wszystkich powyższych i żadne z nich nie działało dla mnie. Wymyśliłem metodę, która zawsze będzie działać. Zasadniczo winowajcą jest sposób, w jaki ADT traktuje folder „libs”, więc wychodzę z folderu „libs”. Zamiast tego utworzyłem folder „bibliotek” i wykorzystałem go.

Możesz wykonać następujące czynności i zawsze będzie działać - nawet jeśli ADT powinien zmienić sposób, w jaki zmienia sposób obsługi folderu „libs” w przyszłości:

1. Utwórz folder „bibliotek”.
2. Utwórz pod nim podfolder dla każdej biblioteki.
3. Umieść wszystkie pliki dla każdej biblioteki w odpowiednim folderze (plik jar java, źródłowy plik jar, plik jar javadoc itp.).
4. Dodaj plik jar Java dla każdego projektu na karcie „Biblioteki” ścieżki kompilacji Java, klikając przycisk Add Jars... przycisk, aby dodać jar z podfolderu biblioteki w folderze „biblioteki”.
5. Dołącz source / javadocs do każdego projektu, otwierając projekt w zakładce „Biblioteki”, wybierając żądany element i klikając Edit...przycisk, aby dodać source / javadocs z podfolderu biblioteki w folderze „biblioteki”.
6. Zaznacz pole wyboru dla każdego projektu na karcie „Zamów i eksportuj” ścieżki kompilacji Java.
7. Po sprawdzeniu, że wszystkie biblioteki zostały przeniesione, usuń folder „libs”.

Postępując zgodnie z powyższą procedurą, twój projekt będzie miał foldery, które wyglądają tak:

Ścieżka kompilacji Java będzie wyglądać mniej więcej tak:

W zamówieniach i eksportach zaznaczone są biblioteki:

Na razie przenieś bibliotekę, do której chcesz Javadoc lib. Dodaj tę bibliotekę Build Pathi dodaj Javadoc.

Sprawdź ten komentarz w kwestiach Androida.

W ADT 22 nie mogłem uzyskać dostępu do Javadoc zarówno dla commons-io-2.4.jar, jak i android-support-v4.jar

Tak to naprawiłem:

1. Warunek: obie biblioteki są wymienione w sekcji „Biblioteki referencyjne”.

2. Kliknij prawym przyciskiem myszy plik commons-io-2.4.jar i wybierz polecenie Właściwości. Pojawi się to okno:

commons-io-2.4.jar jest w pakiecie z commons-io-2.4-javadoc.jar, więc podałem Javadoc w zewnętrznej ścieżce pliku archiwum.

Zrobiłem to samo dla biblioteki wsparcia: kliknij prawym przyciskiem myszy na android-support-v4.jar i wybierz Właściwości. Pojawia się ten ekran:

Tym razem podałem ścieżkę do katalogu źródłowego.

Odwołanie do biblioteki commons-io-2.0.1.jar zostało zerwane podczas aktualizacji do narzędzi SDK i wersji ADT 17.

Aby rozwiązać problem, użyłem Project -> Właściwości -> Ścieżka kompilacji Java i wybrałem kartę Biblioteki. Usunąłem wszelkie odniesienia do pliku commons-io-2.0.1.jar, a następnie użyłem polecenia Dodaj jar, aby ponownie dodać plik commons-io-2.0.1.jar do projektu. Następnie klikam strzałkę „>” obok nazwy biblioteki, aby rozwinąć odwołanie do biblioteki, i użyłem przycisków edycji, aby ustawić załącznik źródła i lokalizację Javadoc.

Niestety nie mogę opublikować obrazu, ponieważ nie mam wystarczającej liczby przedstawicieli (proszę ...).

Wydaje się być ruchomym celem, ale po zebraniu fragmentów z wielu miejsc (w tym odpowiedzi na to pytanie, które pomogły, ale nie opisały wszystkich niezbędnych szczegółów, a może w międzyczasie system nieco się zmienił), wydaje się, że tak jest rozwiązanie, przynajmniej na razie (28 sierpnia 2013 r.).

• Otwórz folder dla javadocs gdzieś poza projektem.
• Umieść tam swoje javadoki rozpakowane, każdy w osobnym folderze.
• W swoim libfolderze dodaj xxx.jar.propertiesplik dla każdej biblioteki, z którą chcesz skojarzyć javadoc.
• W tym pliku właściwości zapoznaj się z folderem, do którego rozpakowałeś odpowiedni plik javadoc (w systemie Windows unikaj ukośników odwrotnych):

doc=d:\\Android\\javadoc\\libGoogleAnalyticsServices

• Zamknij i ponownie otwórz projekt w środowisku Eclipse (odświeżanie to za mało). Powinieneś teraz zobaczyć podpowiedzi po najechaniu kursorem na odpowiednie klasy.

Nieprzestrzeganie żadnego z tych kroków (nie rozpakowywanie javadoc, odwoływanie się do pliku zamiast folderu itp.) Wydaje się go zepsuć.

Wiem, że to pytanie jest dość stare, ale kiedy wczoraj napotkałem ten sam problem, a powyższe rozwiązanie było dla mnie zbyt denerwujące, dowiedziałem się, że można łatwo dodać definicję ścieżki źródłowej do pliku .classpath projektu. Eclipse dostosuje go i będziesz mógł przeglądać źródła.

wpis ścieżki klasy przed:

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

Po dodaniu ścieżki do źródła

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

Mam nadzieję że to pomoże

po prostu zaktualizuj wtyczkę ADT. To działało dla mnie !!

1. Uruchom Eclipse, a następnie wybierz Pomoc> Zainstaluj nowe oprogramowanie.
2. Kliknij Dodaj w prawym górnym rogu.
3. W wyświetlonym oknie dialogowym Dodaj repozytorium wpisz „Wtyczka ADT” dla nazwy i następujący adres URL dla lokalizacji: https://dl-ssl.google.com/android/eclipse/ Uwaga: Witryna aktualizacji Narzędzi dla programistów Androida wymaga połączenie chronione. Upewnij się, że adres URL witryny aktualizacji zaczyna się od HTTPS.
4. Kliknij OK. W oknie dialogowym Dostępne oprogramowanie zaznacz pole wyboru obok Narzędzi programisty i kliknij Dalej.
5. W następnym oknie zobaczysz listę narzędzi do pobrania. Kliknij Następny.
6. Przeczytaj i zaakceptuj umowy licencyjne, a następnie kliknij przycisk Zakończ.
7. Jeśli pojawi się ostrzeżenie dotyczące bezpieczeństwa informujące, że nie można ustalić autentyczności lub ważności oprogramowania, kliknij przycisk OK.
8. Po zakończeniu instalacji uruchom ponownie Eclipse

Mam nadzieję, że to pomaga!

W przypadku dowolnego jar, jeśli chcesz wyświetlić pomoc Javadoc w etykiecie narzędzi podczas kodowania, wykonaj następujące czynności: Kliknij prawym przyciskiem myszy swój projekt> Właściwości> Ścieżka kompilacji Java> Karta Biblioteki. Kliknij strzałkę obok słoika, aby rozwinąć.

Załącznik źródłowy powinien wskazywać lokalizację rzeczywistego słoika (prawdopodobnie bezpośrednio w folderze Java).

Lokalizacja Javadoc : Masz tutaj dwie możliwości: URL i archiwum. Jeśli javadocs dla tego jar są w formie folderu zawierającego plik index.html na pierwszym poziomie, wybierz „Javadoc URL” i wskaż ten folder. Jeśli twoje javadoki są w słoiku, wybierz „Javadoc w archiwum” i wskaż słoik. Nie zapomnij zrestartować obszaru roboczego / zamknąć i ponownie otworzyć projekt, aby zaktualizować etykietkę z informacjami Javadoc.

Mam nadzieję, że to pomoże dać prostą odpowiedź na to, co moim zdaniem powinno być bardzo prostym zadaniem.

Moje rozwiązanie:

Pobierz wtyczkę Eclipse o nazwie: „Java Source Attacher Feature”.

Później wybierz słoik i dołącz kod źródłowy za pomocą tej wtyczki. Kliknij plik jar, aby go zaznaczyć, prawy przycisk myszy, a następnie wybierz opcję „dołącz źródło Java”.

Gdy masz kod źródłowy, automatycznie masz javadoc.

Teraz możesz użyć F2 w klasach, aby wyświetlić asocjowanego javadoc.

Cieszyć się