Eclipse, як пов’язати jar, що містить javadocs / source, з його двійковим файлом?

80

Я хотів би, щоб коментарі javadoc, що містяться у файлі jar, відображалися в eclipse, коли я навожу курсор на клас.

Наприклад, після завантаження JODA-2.0 отримуються три банки:

У eclipse [проект правою кнопкою миші -> Властивості -> Шлях побудови Java -> Бібліотеки -> ДОДАТИ JAR ...] включає двійковий файл у проекті (може посилатися на ці класи) для joda-time-2.0.jar.

Але як я можу зв’язати в коментарях джерела / javadoc, що містяться в інших двох файлах jar, так що, коли я наводжу курсор на ці класи, я бачу javadocs?

Додавання двох інших банок (joda-time-2.0-javadoc.jar та joda-time-2.0-sources.jar) до шляху збірки не пов'язує javadocs або джерело.

java  eclipse  jar  javadoc 
— земляний стрибок
джерело

Відповіді:

67

Ви можете спробувати натиснути CTRL + клацнути на класі, до якого не вкладено джерело (зробіть це у редакторі). Коли він покаже вам деяку інформацію про клас, ви побачите кнопку, яка вказує на приєднання діалогового вікна джерела. Клацніть на ньому та у діалоговому вікні, що з’явиться, виберіть місце розташування джерела / Java для вашого класу.

Ви також можете зробити це із зазначених вами налаштувань шляху збірки проекту: виберіть вкладку бібліотек, розгорніть потрібну бібліотеку (jar), і вам буде запропоновано вибрати: вкладення джерела, вкладення javadoc, місце розташування рідної бібліотеки тощо. що завгодно і відредагуйте його поточні налаштування.

Або ви можете зробити так, як сказав @JB Nizet ...

— драганстанкович
джерело
8
Яка різниця між приєднанням джерела та приєднанням Javadoc ?
— Pacerier
Джерело @Pacerier містить вихідний код програми, де javadoc містить документацію та коментарі, що пояснюють функціональність програми.
— Стевойсяк,
1
Я отримую повідомлення "JAR цього файлу класу належить до контейнера" ​​Приватні бібліотеки Android ", який не дозволяє модифікувати вихідні вкладення в своїх записах
— Radon8472,
70
  1. Клацніть правою кнопкою миші над проектом -> Шлях збірки -> Налаштуйте шлях збірки
  2. У новому вікні перейдіть на вкладку "Бібліотеки".
  3. Виберіть бібліотеку та розгорніть її.
  4. Є 4 варіанти дитини. Виберіть "Розташування Javadoc" і натисніть кнопку "Редагувати" праворуч.
  5. Тепер ви можете додати файл jar, що містить документи. Це буде просто zip-файл із розширенням, зміненим на jar. Переконайтеся, що всередині банки index.html знаходиться в корені. Ви можете натиснути кнопку "Перевірити", щоб перевірити, чи все в порядку.
— Містер Сміт
джерело
до 3. Виберіть безпосередньо бібліотеку, а не ту, що вказана в Приватних бібліотеках Android (функція редагування відсутня). До 4: Використовуйте Javadoc в архівах, а не URL
— Гуннар Бернштейн
Додамо лише, що якщо ви використовуєте загальну бібліотеку, ви можете приєднати посилання на API в Інтернеті замість жорстко закодованого локального шляху до файлу JAR.
— Сіна Мадані
11

Клацніть правою кнопкою миші на jar (на тій, що має файли класів), виберіть «Властивості», «Розташування Javadoc» і виберіть файл jar з javadoc. Подібні дії виконайте для вихідної банки, використовуючи "вкладення джерела Java".

— Й. Б. Нізет
джерело
4
Це може бути лише я, але це працює лише в тому випадку, якщо Eclipse "розпізнає" файл як банку. Це саме вона має маленьку піктограму баночки поруч. Коли я імпортую сторонні банки, на них з’являється піктограма документа. Вони працюють з чудовим кодом, але властивості клацання правою кнопкою миші не отримують "розташування Javadoc".
— Мігель Молл
Якщо ваші банки знаходяться в WEB-INF / lib, не слід клацати правою кнопкою миші на них (як ви вже сказали, вони відображаються як документи), а з еквівалента всередині "Бібліотеки веб-додатків"
— xtian
9

Ви також можете редагувати classpathentry у файлі ".classpath" у своєму проекті eclipse. Це може бути корисно, якщо ви хочете змінити багато записів одночасно або якщо ви хочете сформувати шлях. наприклад:

<classpathentry kind="var" path="HOME/3rdparty/junit.jar" sourcepath="/SOURCE/junit_src.zip"/>

— Michael_S
джерело
+1 відповідь! Я думав про такий спосіб, який можна додати відразу для різних банок.
— Вікас Ратурі,
-1 Ви не хочете редагувати файл .classpath безпосередньо. Він призначений для використання лише в eclipse, а не для редагування вручну. @Mister Smith насправді дає справжню правильну відповідь тут. Хоча draganstankovic пояснює метод, який принаймні допоможе зробити роботу ...
— aaiezza
@scribaniwannabe: Я знаю, що це не передбачений, не підтримуваний спосіб, ані найпростіший спосіб, але для згаданих випадків використання він працює набагато швидше і без проблем. Однак ви повинні бути обережними, щоб використовувати дійсний синтаксис XML.
— Michael_S
0

Найпростіший спосіб:

  1. Натисніть control + (Слово, для якого ви хочете побачити документ Java)
  2. З'явиться сторінка, на якій є кнопка для підключення джерела
  3. Виберіть Зовнішнє розташування.
  4. Перегляньте розташування в папці Java, ніж ваша. jdk Потім виберіть src .zip.
  5. натисніть OK.

Проблема вирішена.

— радж
джерело
Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.