Отримайте вихідні файли jar, приєднані до Eclipse для Maven-залежностей

Я використовую Maven (та інтеграцію Maven Eclipse) для управління залежностями для моїх Java-проектів у Eclipse. Функція автоматичного завантаження файлів JAR з сховищ Maven - це реальна економія часу. На жаль, він не включає документацію API та вихідний код.

Як я можу налаштувати Maven автоматично також отримувати вкладення джерела та javadoc та реєструвати їх належним чином у Eclipse?

Я впевнений, що плагін m2eclipse Maven для Eclipse - навпаки - може це зробити. Ви можете налаштувати його для автоматичного завантаження і вихідних файлів, і javadoc.

Це досягається, зайшовши у вікно> Налаштування> Maven і перевіривши параметри "Завантажити джерела артефакту" та "Завантажити артефакт JavaDoc".

mvn eclipse:eclipse -DdownloadSources=true

або

mvn eclipse:eclipse -DdownloadJavadocs=true

або ви можете додати обидва прапори, як вказує Спенсер К.

Крім того, =trueпорція не потрібна, тому ви можете використовувати

mvn eclipse:eclipse -DdownloadSources -DdownloadJavadocs

Інші відповіді на цю роботу, але якщо ви хочете уникати запам'ятовування аргументів командного рядка, ви також можете просто додати до файлу downloadSources та конфігурації downloadJavadocs до розділу maven-eclipse-плагін вашого pom.xml:

<project>
    ...
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-eclipse-plugin</artifactId>
                <configuration>
                    <downloadSources>true</downloadSources>
                    <downloadJavadocs>true</downloadJavadocs>
                    ... other stuff ...
                </configuration>
            </plugin>
        </plugins>
    </build>
    ...
</project>

Я вважаю за краще не вводити параметри завантаження source / Javadoc у pom.xmlфайл проекту, оскільки я вважаю, що це налаштування користувача, а не властивості проекту. Натомість я розміщую їх у профілі у своєму settings.xmlфайлі:

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

  <profiles>
    <profile>
      <id>sources-and-javadocs</id>
      <properties>
        <downloadSources>true</downloadSources>
        <downloadJavadocs>true</downloadJavadocs>
      </properties>
    </profile>
  </profiles>

  <activeProfiles>
    <activeProfile>sources-and-javadocs</activeProfile>
  </activeProfiles>
</settings>

Клацніть правою кнопкою миші на проект -> maven -> завантажте джерела

Якщо джерельні банки знаходяться в локальному сховищі, а ви використовуєте підтримку Maven Eclipses, джерела автоматично приєднуються. Ви можете запустити, mvn dependency:sourcesщоб завантажити всі джерельні банки для даного проекту. Не знаю, як зробити те ж саме з документацією.

Якщо ви використовуєте meclipse, робіть

window -> maven -> Завантажити джерела артефактів (виберіть чек)

(Якщо ви все-таки отримаєте вікно джерела вкладення, натисніть кнопку прикріпити файл і закрийте вікно джерела вкладення. Наступного разу, коли ви спробуєте побачити джерело, воно відкриє правильне джерело)

Сурайж

Існує також подібне питання, яке відповідає на це, і включає в себе приклад налаштувань пом.

Я спробував windows-> pref ..-> Maven Але це не вийшло. Отже, я створив новий шлях до класу з командою mvn eclipse: eclipse -DdownloadSources = true і один раз оновив робочу область. вуаля .. Джерела були додані.

Запис банку в джерело доступний у класі. Отже, новобудова вирішила проблему ...

в моїй версії геліосів Eclipse з m2Eclipse немає

window --> maven --> Download Artifact Sources (select check)

Під вікном є лише "нове вікно", "новий редактор", "відкрита перспектива" тощо.

Якщо ви клацніть правою кнопкою миші на своєму проекті, тоді вибираєте maven -> завантажуйте джерела

Нічого не відбувається. жодні джерела не завантажуються, жодні файли пам’яті не оновлюються, не з’являється вікно із запитом, які джерела.

Робити mvn xxx поза затемненням небезпечно - деякі команди не працюють з m2ecilpse - я це зробив один раз і втратив весь проект, довелося перевстановити затемнення і почати з нуля.

Я все ще шукаю спосіб отримати ecilpse і maven для пошуку та використання джерела зовнішніх банок, таких як servlet-api.

Змінення pom для maven-eclipse-плагіна, щоб включити джерело / javadoc, просто застосуйте для нових залежностей, що додаються до pom. Якщо нам потрібно застосувати існуючі залежності, ми повинні запустити mvn залежність: джерела. Я це перевірив.

Перевірка джерела завантаження / javadoc у налаштуваннях Eclipse-Maven, іноді недостатня. У випадку, якщо maven з певних причин не вдалося їх завантажити (мережеве затемнення?), Maven створює деякі * .lastUpdate файли, після чого вони більше ніколи не завантажуються. Моє емпіричне рішення полягало в тому, щоб видалити каталог артефактів із .m2 / сховища та перезапустити робочу область eclipse із завантаженим джерелом завантаження / javadoc і перевірити оновлення проектів при запуску. Після перезапуску робочої області, можливо, деякі проекти можуть бути позначені помилково, тоді як хід затемнення завантажується, тоді будь-яка помилка буде видалена. Можливо, ця процедура не така "наукова", але для мене це вдалося.

Я додав конфігурацію pom до плагіна Maven-eclipse для завантаження джерела та javadocs, але я вважаю, що це станеться для нових залежностей, а не для існуючих.

Для існуючих залежностей я переглянув провідник пакунків до "Maven Dependitions" і клацнув правою кнопкою миші на commons-lang-2.5.jar, вибраний Maven | Завантажте джерела і ... нічого, здається, не сталося (жодної смуги прогресу чи вказівки на те, що вона щось робить). Однак це завантажено, оскільки я можу перейти до джерела у commons-lang зараз.

переосмислити запропоновано використовувати налаштування в пам’яті :

<project>
...
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-eclipse-plugin</artifactId>
            <configuration>
                <downloadSources>true</downloadSources>
                <downloadJavadocs>true</downloadJavadocs>
                ... other stuff ...
            </configuration>
        </plugin>
    </plgins>
</build>
...

По-перше, я думав, що це все ще не приєднає javadoc та джерела (як я раніше безуспішно намагався з цим параметром -DdownloadSources).

Але сюрприз - .classpath файл IS отримує свої джерела та javadoc додається під час використання варіанту POM!

Для вищезазначених вище пунктів Indigo (і, мабуть, Helios) знаходяться:

Вікно -> Налаштування -> Maven

У мене була подібна проблема, і рішення, яке найкраще працювало для мене, полягало в тому, щоб включити джерело в ту саму банку, що і компільований код (так що вказаний каталог в банку буде включати в себе і те, Foo.javaі інше Foo.class). Eclipse автоматично пов'язує джерело зі скомпільованим кодом і автоматично надає JavaDoc з джерела. Очевидно, це корисно лише в тому випадку, якщо ви контролюєте артефакт.

Після встановлення властивостей на рівні проекту або на рівні властивостей користувача, будь ласка, зробіть Maven -> Update Project (Force Update). Він завантажує джерела