Компоновка комплектов

В PDE включен механизм автоматизации компоновки комплектов. Большинство параметров компоновки указывается в шаблоне build.properties. Далее описан простой пример компоновки, в котором предполагается, что на диске уже присутствуют все модули и комплекты (ранее скомпонованные и которые требуется скомпоновать), на которые ссылается компонуемый комплект.

Подготовка

Каталог конфигурации компоновки

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

Главным файлом для управления компоновкой является высокоуровневый файл конфигурации компоновки - build.properties. При настройке новой компоновки нужно скопировать файл шаблона из пакета org.eclipse.pde.build, расположенный в установке eclipse, которая будет использоваться для выполнения компоновки. Путь к файлу шаблона: org.eclipse.pde.build/templates/headless-build/build.properties.

К этому каталогу обращаются свойства компоновщика, которые обычно задаются в командной строке ant.

buildDirectory

Свойством buildDirectory определяется каталог, в котором PDE/Build будет генерировать сценарии и фактически осуществлять компоновку. Компонуемые модули и компоненты должны помещаться в подкаталоги ${buildDirectory}/plugins и ${buildDirectory}/features, соответственно. При выборке комплектов и компонентов из хранилища (см.Выборка из хранилищ), они помещаются в это же расположение.

Этот каталог может одновременно быть и каталогом конфигурации компоновки, или это могут быть разные каталоги. Иногда желательно использовать отдельный каталог, особенно если конфигурация компоновки хранится в CVS, и вам не хотелось бы перегружать ее сгенерированными артефактами компоновки.

Исходные свойства

Для настройки базовой компоновки нужно отредактировать файл build.properties, указав в нем следующие свойства:

В предыдущей версии PDE/Build также требовался файл allElements.xml, который не является необходимым в версии 3.4. Вы можете воспользоваться файлом allElements.xml, но он является необходимым только в том случае, если требуется пользовательская настройка определенных аспектов компоновки. См. Настройка консольной компоновки.

Запуск компоновки

Для запуска компоновки используется приложение org.elipse.ant.core.antRunner. При вызове Eclipse с этим приложением для компоновки в командной строке укажите два аргумента:

antRunner запускается следующим образом:


java -jar <eclipseInstall>/plugins/org.eclipse.equinox.launcher_<версия>.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/build.xml> -Dbuilder=<путь-к-папке-с-конфигурацией-компоновки>

По завершении компоновки результаты будут помещены в папку I.TestBuild (это имя задается в свойстве buildLabel).

Расширенные сценарии

Если требуется дополнительная настройка компоновки, например, извлечение из хранилища, обратитесь к разделам о расширенной компоновке PDE.