Новая версия плагина ADT r17 для функции добавления Eclipse для автоматической настройки зависимостей JAR. Любые файлы .jar в папке /libs теперь добавляются в конфигурацию сборки. К сожалению, контейнер для классов Android Dependencies не модифицируется.
Как я могу подключить javadoc и источники к автоматически вставленному .jar(из папки/libs)?
Лучший способ ответить на ваш вопрос - суммировать ответы от Xavier, plastiv, VinceFR и Christopher.
Чтобы связать источники и javadoc с библиотекой.jar, которая автоматически связана Eclipse, вам необходимо сделать следующее:
.properties в папке libs с точным именем фактической библиотеки.jar (см. Пример). Убедитесь, что вы сохранили часть.jar..properties.
В этом примере используется библиотека Gson.
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
src=src/gson-2.2.2-sources.jar
doc=docs/gson-2.2.2-javadoc.jar
Конечно, вы можете перемещать javadoc и источники.jar в другие папки и указывать относительные пути. Это вам. Размещение исходных и javadoc банок непосредственно в папке lib возможно, но не рекомендуется, поскольку это приводит к включению документации и исходного кода в ваше приложение.
Снимок экрана панели JavaDoc Eclipse:
Скриншот проекта Eclipse с использованием Gson с Android 4.2.2.:
Если вы хотите ссылаться на 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, как указано выше! Вот скриншот рабочего примера проекта, связанного с библиотекой Android GoogleAdMobAds.
В окнах вам нужно избежать обратного слэша для ссылок на пути doc и src в файле свойств. Пример: для android-support-v4.jar - содержимое файла свойств:
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
Ответ получен из http://code.google.com/p/android/issues/detail?id=27490#c21
В вашей папке libs вы должны:
doc(folder)
foo_doc(folder)
index.html
...
...
foo.jar
foo.jar.properties
И в вашем foo.jar.properties просто поместите doc=./doc/foo_doc
Возможно, вам придется обновить свой проект, очистить его, закрыть его и снова открыть.
Это работает для меня!
Я пробовал все вышеперечисленное, и никто из них не работал у меня. Я понял метод, который всегда будет работать. В принципе, виновником является то, как ADT обрабатывает папку "libs", поэтому я ухожу из папки "libs". Вместо этого я создал папку "libraries" и использовал ее.
Вы можете сделать следующее, и он всегда будет работать, даже если ADT должен изменить, как он изменит, как он относится к папке "libs" в будущем:
Следуя приведенной выше процедуре, ваш проект будет иметь папки, которые выглядят так:
Ваш путь построения Java будет выглядеть примерно так:
В порядке и экспорте библиотеки отмечены галочкой:
Теперь переместите библиотеку, в которой вы хотите, чтобы Javadoc был lib. Они добавят эту библиотеку в Build Path и добавят Javadoc.
Отметьте этот комментарий в проблемах Android.
В ADT 22 я не смог получить доступ к Javadoc для обеих коммон-io-2.4.jar и android-support-v4.jar
Вот как я его исправил:
Предварительное условие: обе библиотеки перечислены в разделе "Связанные библиотеки".
Щелкните правой кнопкой мыши на commons-io-2.4.jar и выберите "Свойства". Появится следующее окно:
commons-io-2.4.jar в комплекте с commons-io-2.4-javadoc.jar, поэтому я указал Javadoc в архиве Внешний путь к файлу.
Я сделал то же самое для библиотеки поддержки: щелкните правой кнопкой мыши на android-support-v4.jar и выберите "Свойства". Появится этот экран:
На этот раз я указал путь к исходному каталогу.
Ссылка на библиотеку commons-io-2.0.1.jar была повреждена, когда я обновился до SDK Tools и версии 17 для ADT.
Чтобы решить проблему, я использовал Project → Properties → Java Build Path, и я выбрал вкладку Libraries. Я удалил любую ссылку на commons-io-2.0.1.jar, а затем использовал Add Jar для повторного добавления commons-io-2.0.1.jar в проект. Затем я нажимаю стрелку " > рядом с именем библиотеки, чтобы развернуть ссылку на библиотеку, и я использовал кнопки редактирования, чтобы установить вложение" Источник "и местоположение Javadoc.
Извините, я не могу опубликовать изображение, так как мне не хватает репутации (пожалуйста...).
Кажется, это движущаяся цель, но после того, как собрал биты и куски из многих мест (включая ответы на этот самый вопрос, который помог, но не смог описать все необходимые детали, или, может быть, система немного изменилась за это время), это представляется решением, по крайней мере, на данный момент (28 августа 2013 г.).
lib добавьте файл xxx.jar.properties для каждого lib, с которым вы хотите связать javadoc с. doc=d:\\Android\\javadoc\\libGoogleAnalyticsServices
Несоблюдение любого из этих шагов (не распаковывая javadoc, ссылаясь на файл вместо папки и т.д.), похоже, нарушает его.
Я знаю, что этот вопрос довольно старый, но когда я столкнулся с той же проблемой вчера, и решение, вышедшее выше, было слишком раздражающим для меня, я обнаружил, что можно легко добавить определение исходного пути в файл .classpath проект. Eclipse затем адаптирует его, и вы сможете просмотреть источник.
classpath запись до:
<classpathentry kind="lib" path="[PATH_TO_MY_JAR]"/>
После добавления пути к источнику
<classpathentry kind="lib" path="[PATH_TO_MY_JAR]" sourcepath="[PATH_TO_MY_SOURCE_JAR]"/>
Надеюсь, что это поможет
просто обновите плагин ADT. Это сработало для меня!
Надеюсь, что это поможет!
Для любого заданного jar, если вы хотите увидеть помощь Javadoc во всплывающей подсказке во время кодирования, сделайте следующее: Щелкните правой кнопкой мыши проект > Свойствa > Путь сборки Java > вкладка "Библиотеки". Нажмите стрелку рядом с банкой, чтобы развернуть ее.
Вложение источника должно указывать на местоположение фактической банки (возможно, прямо в вашей папке java).
Местоположение Javadoc. Здесь у вас есть два варианта: URL и архив. Если ваши javadocs для этой банки представлены в виде папки, содержащей файл index.html на первом уровне, выберите "Javadoc URL" и укажите на эту папку. Если ваши javadocs находятся в банке, выберите "Javadoc в архиве" и укажите на банку. Не забудьте перезапустить рабочее пространство/закрыть и снова открыть проект, чтобы обновить всплывающую подсказку с помощью информации Javadoc.
Надеюсь, это поможет дать простой ответ на то, что, по моему мнению, должно быть очень простой задачей.
Мой соблазн:
Загрузите плагин eclipse под названием "Функция источника источника Java".
Затем выберите банку и прикрепите исходный код с помощью этого плагина. Нажмите в файле jar, чтобы выбрать его, правой кнопкой мыши на мыши, а затем выберите "attach java source".
Когда у вас есть исходный код, вы автоматически используете javadoc.
Теперь вы можете использовать F2 над классами для просмотра asaviated javadoc.
Enjoy