Eclipse: присоединить источник / javadoc к библиотеке через локальное свойство

У меня есть сторонняя библиотека в моем репозитории SVN, и я хотел бы связать source / javadoc с ним локально в Eclipse. То есть, должна быть какая-то локальная настройка (например, запись в файле local.properties ), которая связывает источник / javadoc с JAR-файлом, но который не вводит локальные зависимости в repository через .classpath . В идеале я бы

 lib_src_dir = /my/path/to/lib/src 

в local.properties а затем

  

в .classpath . Это можно сделать?

[EDIT] @ Ответ VonC полезен … Есть ли способ загрузить переменные пути из текстового файла (например, local.properties ) вместо перехода через Window -> Preferences -> General -> Workspace -> Linked Resources?

Я считаю, что это было бы лучше достигнуто посредством:

  • создание связанной папки в сочетании с
  • объявление связанного ресурса

Связанный ресурс определяет переменную пути, которая будет равна /my/path/to/lib/src

Связанные ресурсы Eclipse

Связанная папка будет ссылаться на ваш связанный ресурс

Связанные ресурсы

(вы можете использовать переменную, а не фиксированный путь, с кнопкой «Переменная»)

Переменная на самом деле всегда локальна (в рабочую область) и будет изменена с помощью экрана настроек Linked Resources .

Связанная папка также может быть … связанным файлом , что позволяет ссылаться на архив через относительный путь (относительно переменной).
Затем этот связанный файл (здесь связанный архив) может быть связан с вашим classpathentry в атрибуте « source ».


Проблема с Linked Resources заключается в том, что они локальны для рабочей области в настройках.
Вы можете экспортировать настройки в файле [myPrefs.epf] , а затем обрезать экспортированный файл, чтобы оставить только строки, содержащие pathvariable :

 /instance/org.eclipse.core.resources/pathvariable.MY_DIRECTORY=/my/path/to/lib/src 

Затем любой пользователь может импортировать этот файл специальных предпочтений, который затронет только часть « Linked Resources ».

Это решение не очень удовлетворительно, так как .epf настроек .epf не может быть загружен автоматически в проекте .
Когда я настраиваю проект со связанными ресурсами, определяющими путь, я всегда оставляю большой README.txt в корне моего проекта, чтобы побудить пользователя указанного проекта определить те же связанные ресурсы с его / ее собственным фиксированным локальным дорожка.

Выполняется несколько ошибок для улучшения этой ситуации или вокруг темы Связанные ресурсы .

Особенно:

  • Экспорт проекта со связанными ресурсами
  • Относительные пути без переменных
  • Связать ресурсы по отношению к путям рабочей области
  • Хотелось бы использовать путь относительно корня рабочей области

DevByStarlight упоминает в комментариях проект (не очень активный с октября 2011 года) workmemechanic .

Механизм Workspace Mechanic автоматизирует обслуживание среды Eclipse, настраивая настройки, добавляя местоположения расширений и т. Д. Вы можете использовать его для:

  • Создавайте согласованную среду среди групп, таких как целая компания, ваша местная команда или даже ваши собственные рабочие места
  • Экономия времени при настройке новых рабочих областей
  • Создавайте задачи, которые гарантируют, что ваши любимые новые предпочтения применяются ко всем текущим и будущим рабочим пространствам. (Это одна из наших любимых функций!)

Ключом к поведению Механизма рабочего места является Task .
Задача описывает простой тест и действие, которое при запуске изменяет среду, чтобы затем тест проходил.
Tasks могут иметь разные формы: файлы предпочтений, classы Java, скрипты Groovy и расширения Eclipse. Вы можете легко определить свои собственные задачи.

Он поставляется с набором скриптов:

  • Рабочее пространство-механик
  • workspacemechanic-настройки

Я просто вычислил простой ответ на этот вопрос (в Indigo) после работы над ним на заднем плане и свободных моментов в течение нескольких дней. Самый простой способ, который я нашел, – это расширить ваш проект в Project Explorer, зайти в ваши ссылочные библиотеки, щелкнуть правой кнопкой мыши соответствующий ссылочный JAR и нажать «Свойства». Там вы можете указать местоположение JavaDocs. Введите местоположение папки, содержащей index.html и список пакетов, файлы, которые являются частью Javadocs. Кусок пирога!

Единственная проблема, которую я вижу до сих пор, заключается в том, что я готов поспорить, что вам нужно сделать это в каждом проекте, который ссылается на эту библиотеку.

Вы можете сделать это с помощью переменных classа.

Каждый разработчик создает пару новых переменных в Window -> Preferences -> Java -> Build Path -> Varipath Variables.

Определите переменную (скажем, JAVA_LIB_DIR), которая указывает на каталог, содержащий сторонний JAR (или JARS). Определите другую переменную, указывающую на каталог, содержащий сторонний исходный код (JAVA_SRC_DIR). Вы можете настроить это как хотите, но у нас есть такая структура:

 common/ lib/ java/ <-- JAVA_LIB_DIR variable points to this directory axis/ bitronix/ 1.0/bitronix.jar "extension" is "bitronix/1.0/bitronix.jar" ... 

В пути создания проекта используйте параметр «Добавить переменную ...», чтобы добавить библиотеку. Тогда вы, когда «приложите источник», вам будет предложено ввести переменную и расширение в исходный код.

Таким образом, может быть проверен один общий файл .classpath, позволяя каждому разработчику находить свою собственную библиотеку и исходные каталоги там, где они захотят.

  • Javadoc в Eclipse не распознает пакеты
  • Как подключить источник или JavaDoc в eclipse для любого файла jar, например JavaFX?
  • Как подключить javadoc или источники к банкам в папке libs?
  • Давайте будем гением компьютера.