Извлечение из хранилища
В PDE предусмотрены действия по извлечению исходного кода и готовых модулей из хранилища в процессе компоновки (см. задачу eclipse.fetch и свойства, управляющие извлечением).
PDE может делать это автоматически, или исходный код можно получать вручную.
Файл карты связей - первый шаг к автоматизации
По идентификатору компонуемого комплекта или модуля система компоновки может получить из архива все включенные комплекты и модули.
Информация хранится в картах связей. Файл карты связей - это файл свойств Java, в котором ИД модулей и комплектов связаны с расположением и тегом в хранилище. Формат файлов карт связей открыт, но ключевая часть зарезервирована системой компоновки PDE:
<Тип-элемента>@<ИД-элемента>[,<версия-элемента>] = <служебная-информация-хранилища>
где Тип-элемента может принимать значения bundle, feature,
plugin или fragment, а значения ИД-элемента и версия-элемента задают характеристики элемента.
Записи файла карты связей для CVS
Формат записи файла карты связей для извлечения информации из CVS следующий:
<key> = CVS, [,аргументы]
где аргументы - список пар ключ/значение, разделенный запятыми. Аргументы могут быть следующими:
- tag - тег изъятия CVS;
- cvsRoot - строка подключения CVS;
- path - необязательный модуль CVS и путь к папке, содержащей элемент. По умолчанию имя элемента становится именем модуля;
- prebuilt - необязательный Булевский аргумент, указывающий, является ли загруженный элемент уже скомпонованным. Значение по умолчанию равно false;
- cvsPassFile - путь к файлу паролей cvs;
- password - необязательный пароль для подключения к 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, по которому находятся данные, а аргументы - необязательный список пар ключ/значение, разделенный запятыми. Аргументы могут быть следующими:
- unpack - значение true указывает, что загруженный элемент следует распаковать;
- verbose - значение true показывает подробные сведения о ходе загрузки. Значение по умолчанию - false;
- ignoreerrors - значение true позволяет вести протокол ошибок при передаче данных. Значение по умолчанию - false;
- usetimestamp - значение true позволяет загружать файл по условию соответствия системному времени локальной копии (только для URL HTTP). Значение по умолчанию - false;
- username - имя пользователя для "простой" идентификации HTTP;
- password - пароль для загрузки.
Пример:
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
В среду компоновки PDE добавлено новое расширение, позволяющее пользователям загружать
свойства из хранилищ p2. В файл карты связей можно добавить запись для
загрузки артефакта и его применения в ходе компоновки. Запись файла связей должна содержать ИД и версию устанавливаемого модуля IU, а также URI
хранилища, в котором расположен IU. Предполагается, что хранилища метаданных и
артефактов совпадают.
Формат записи файла карты для извлечения содержимого через p2 следующий:
<elementType>@<elementID> = p2IU, id=<id>,
version=<version>, repository=<repository>
- id - идентификатор устанавливаемого блока;
- version - версия устанавливаемого блока
(необязательно). По умолчанию применяется последняя доступная
версия.
- repository - расположение (URI) хранилища, в котором находится устанавливаемый блок (IU).
Выборка компонентов с 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.exe включен в системный путь.
Загрузить CVS можно здесь.
- Создайте папку maps в каталоге компоновки.
- Создайте файл с расширением .map в папке maps.
- Укажите в этом файле все элементы, которые требуется получить из хранилища.
- В файле build.properties в папке конфигурации возьмите в
комментарий строку skipFetch=true. Если это свойство включено, то при компоновке никаких действий по получению кода из хранилища выполняться не будет. Если требуется игнорировать тег, указанный в файлах карты связей, задайте значение fetchTag. Это полезно, например, при ежедневной компоновке из HEAD вместо указанных тегов версий.
Получение файлов карты связей из CVS
Файлы карт связей могут размещаться в хранилище. При компоновке PDE может получать эти файлы из хранилища CVS.
Для этого в файле build.properties необходимо задать следующие параметры:
- skipMaps:
Возьмите в комментарий это свойство. Если это свойство включено, то при компоновке никаких действий по получению файлов карт связей из хранилища выполняться не будет.
- mapsRepo =
:pserver:anonymous@example.com/path/to/repo. Хранилище CVS, из которого извлекаются файлы.
- mapsRoot =
/path/to/maps. Каталог с файлами карты связей в хранилище CVS.
- mapsCheckoutTag =
HEAD. Тег CVS для извлечения файл карт связей.
Извлечение карт связей из CVS выполняется в ходе предварительных действий компоновки. Для извлечения всех требуемых комплектов и модулей будут сгенерированы сценарии, которые будут выполнены для получения файлов.
Автоматизированное получение из других хранилищ
При автоматическом получении файлов карт связей из хранилища требуется скопировать файл customTarget.xml из
org.eclipse.pde.build/templates/headless-build в каталог конфигурации. Цель getMapFiles позволяет извлечь файлы, и именно ее следует настроить для работы с хранилищем.
Получение исходного кода вручную
Для получения модулей и фрагментов можно создать пользовательские цели, которые будут вызываться из целей preSetup или postSetup файла customTargets.xml.
Комплекты и модули необходимо поместить в каталоги ${buildDirectory}/features и ${buildDirectory}/plugins соответственно.