В PDE включен механизм автоматизации компоновки комплектов. Большинство параметров компоновки указывается в шаблоне build.properties. Далее описан простой пример компоновки, в котором предполагается, что на диске уже присутствуют все модули и комплекты (ранее скомпонованные и которые требуется скомпоновать), на которые ссылается компонуемый комплект.
Прежде всего, настраивая компоновку, следует создать каталог конфигурации компоновки. Это каталог, в котором хранятся файлы для настройки консольной компоновки и управления ею.
Главным файлом для управления компоновкой является высокоуровневый файл конфигурации компоновки - build.properties. При настройке новой компоновки нужно скопировать файл шаблона из пакета org.eclipse.pde.build, расположенный в установке eclipse, которая будет использоваться для выполнения компоновки. Путь к файлу шаблона: org.eclipse.pde.build/templates/headless-build/build.properties.
К этому каталогу обращаются свойства компоновщика, которые обычно задаются в командной строке ant.
Свойством buildDirectory определяется каталог, в котором PDE/Build будет генерировать сценарии и фактически осуществлять компоновку. Компонуемые модули и компоненты должны помещаться в подкаталоги ${buildDirectory}/plugins и ${buildDirectory}/features, соответственно. При выборке комплектов и компонентов из хранилища (см.Выборка из хранилищ), они помещаются в это же расположение.
Этот каталог может одновременно быть и каталогом конфигурации компоновки, или это могут быть разные каталоги. Иногда желательно использовать отдельный каталог, особенно если конфигурация компоновки хранится в CVS, и вам не хотелось бы перегружать ее сгенерированными артефактами компоновки.
Для настройки базовой компоновки нужно отредактировать файл build.properties, указав в нем следующие свойства:
В предыдущей версии PDE/Build также требовался файл allElements.xml, который не является необходимым в версии 3.4. Вы можете воспользоваться файлом allElements.xml, но он является необходимым только в том случае, если требуется пользовательская настройка определенных аспектов компоновки. См. Настройка консольной компоновки.
Для запуска компоновки используется приложение org.elipse.ant.core.antRunner. При вызове Eclipse с этим приложением для компоновки в командной строке укажите два аргумента:
-buildfile=</путь/к/build.xml>: Путь к build.xml. Он расположен в каталоге org.eclipse.pde.build/scripts. Это сценарий компоновки, который управляет всем процессом компоновки.-Dbuilder=</путь/к/папка-конфигурации>:
Путь к папке конфигурации компоновки.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.