Лучший способ ответить на ваш вопрос - обобщить ответы от Ксавье , пластив , VinceFR и Кристофер .
Пошаговое руководство
Чтобы связать источники и javadoc с библиотекой .jar, которая автоматически связывается Eclipse, вам необходимо выполнить следующие действия:
- Поместите файл библиотеки .jar в папку libs и связанные исходные файлы .jar и doc .jar в отдельные подпапки, такие как libs / src и * 1022.* LIBS / Docs .Вы можете использовать имя, отличное от src и docs , если хотите, но важно, чтобы файлы .jar не находились непосредственно в папке libs .
- Создайте файл
.properties в папке libs с точным именем фактической библиотеки .jar (см. Пример).Обязательно сохраните часть .jar . - Укажите относительные пути к источникам и javadoc .jar в файле
.properties. - Закрыть и заново откройте проект Eclipse!При желании обновите проект, нажав F5 .
- Выберите объект связанной библиотеки в исходном коде.
- Откройте представление Javadoc в Eclipse, чтобы проверить документацию (см. скриншот).
- Открыть объявление исходного кода (ярлык по умолчанию: F3 ) выбранного объекта.
Пример
В примере используется библиотека Gson .
Структура каталогов папки 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
Содержимоеgson-2.2.2.jar.properties
src=src/gson-2.2.2-sources.jar
doc=docs/gson-2.2.2-javadoc.jar
Дополнительная информация
Конечно, вы можете переместить javadoc и sources .jar в другие папки и указать относительные пути.Это зависит от вас.Размещение JAR-файлов с исходным кодом и javadoc непосредственно в папке lib возможно, но не рекомендуется , так как это приводит к тому, что документация и исходный код включаются в ваше приложение .
Снимок экрана панели Eclipse JavaDoc:
Снимок экрана проекта Eclipse с использованием Gson с Android 4.2.2.:
Ссылка на распакованный javadocs
Если вы хотите сослаться на javadocs, которые не предоставляются как упакованные .jar, а просто в виде файлов и папок в соответствии с запросом разработчика Androidв комментариях выполните следующие действия:
- Поместите библиотеку
.jar в папку libs/ Создайте файл yourlibraryname.jar.properties (не забудьте .jar) со следующим содержимым:
doc=docs
Добавьте папки javadocs в папку libs/.
Вы должны придумать следующую структуру папок:
├── 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
Не забудьте закрыть и заново открыть проект Eclipse, как упомянуто выше!Вот снимок экрана рабочего примера проекта со ссылкой на библиотеку GoogleAdMobAds Android .
