Извлечение из хранилища

В PDE предусмотрены действия по извлечению исходного кода и готовых модулей из хранилища в процессе компоновки (см. задачу eclipse.fetch и свойства, управляющие извлечением). PDE может делать это автоматически, или исходный код можно получать вручную.

Файл карты связей - первый шаг к автоматизации

По идентификатору компонуемого комплекта или модуля система компоновки может получить из архива все включенные комплекты и модули.

Информация хранится в картах связей. Файл карты связей - это файл свойств Java, в котором ИД модулей и комплектов связаны с расположением и тегом в хранилище. Формат файлов карт связей открыт, но ключевая часть зарезервирована системой компоновки PDE:

<Тип-элемента>@<ИД-элемента>[,<версия-элемента>] = <служебная-информация-хранилища>

где Тип-элемента может принимать значения bundle, feature, plugin или fragment, а значения ИД-элемента и версия-элемента задают характеристики элемента.

Записи файла карты связей для CVS

Формат записи файла карты связей для извлечения информации из CVS следующий:
<key> = CVS, [,аргументы]
где аргументы - список пар ключ/значение, разделенный запятыми. Аргументы могут быть следующими: Пример:
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true

Устаревшие записи карты связей
В Eclipse 3.2 и более ранних версий для CVS применялся следующий формат файла карты связей:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Если необязательные аргументы не указаны, то запятые все равно должны разделять следующие аргументы. Данный формат следует считать устаревшим; предпочитаемый формат: ключ/значение.

Записи файла карты связей для Ant GET

В файле карты связей для извлечения данных по любому URL, поддерживаемому Ant GET, записи задаются в следующем формате:

<key> = GET, <url> [,аргументы]
где url - URL, по которому находятся данные, а аргументы - необязательный список пар ключ/значение, разделенный запятыми. Аргументы могут быть следующими: Пример:
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true

Запись файла карты для извлечения p2

В среду компоновки PDE добавлено новое расширение, позволяющее пользователям загружать свойства из хранилищ p2. В файл карты связей можно добавить запись для загрузки артефакта и его применения в ходе компоновки. Запись файла связей должна содержать ИД и версию устанавливаемого модуля IU, а также URI хранилища, в котором расположен IU. Предполагается, что хранилища метаданных и артефактов совпадают.

Формат записи файла карты для извлечения содержимого через p2 следующий:

<elementType>@<elementID> = p2IU, id=<id>,
version=<version>, repository=<repository>
Выборка компонентов с p2

В выпуске Helios поддерживается выборка компонентов с p2 путем указания устанавливаемого блока, представляющего jar компонента. Сведения о структуре метаданных p2 для компонентов приведены на странице метаданных компонентов.

Примеры:
plugin@my.bundle.id,1.0.0=p2IU,id=my.bundle.id,version=1.0.0,repository=http://example.eclipse.org/repo
feature@my.feature.id = p2IU,id=my.feature.id.feature.jar, version=1.0.0,repository=http://example.eclipse.org/repo

Записи файла карты связей для других хранилищ

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

Настройка параметров для получения исходного кода из CVS

Для того чтобы настроить получение исходного кода из CVS, выполните следующее:

Получение файлов карты связей из CVS

Файлы карт связей могут размещаться в хранилище. При компоновке PDE может получать эти файлы из хранилища CVS. Для этого в файле build.properties необходимо задать следующие параметры: Извлечение карт связей из CVS выполняется в ходе предварительных действий компоновки.  Для извлечения всех требуемых комплектов и модулей будут сгенерированы сценарии, которые будут выполнены для получения файлов. 

Автоматизированное получение из других хранилищ

При  автоматическом получении файлов карт связей из хранилища требуется скопировать файл customTarget.xml из org.eclipse.pde.build/templates/headless-build в каталог конфигурации.  Цель  getMapFiles позволяет извлечь файлы, и именно ее следует настроить для работы с хранилищем.

Получение исходного кода вручную

Для получения модулей и фрагментов можно создать пользовательские цели, которые будут вызываться из целей preSetup или postSetup файла customTargets.xml.  Комплекты и модули необходимо поместить в каталоги ${buildDirectory}/features и ${buildDirectory}/plugins соответственно.