Существует несколько способов настройки консольной компоновки:
Точный формат содержимого каждого из этих файлов зависит от других файлов. Таким образом, при использовании настроек из файла customTargets, allElements или customAssembly рекомендуется проследить за тем, чтобы шаблоны, используемые в этих файлах, были созданы в одной и той же версии PDE/Build. Новые версии PDE/Build совместимы с прежними версиями этих сценариев настройки.
Версии шаблонов этих сценариев доступны в модуле org.eclipse.pde.build в папке templates/headless-build. Для того, чтобы использовать настройку, нужно просто скопировать шаблон в каталог конфигурации компоновки и изменить соответствующие целевые объекты.
Сценарий customTargets.xml является высокоуровневой пользовательской настройкой процесса компоновки. Он задает целевые объекты ant, вызов которых выполняется между основными этапами компоновки. В начале и в конце каждого из перечисленных ниже этапов компоновки существуют целевые объекты pre и post, соответственно:
Для использования сценария customTargets.xml нужно просто скопировать его из каталога шаблонов PDE/Build в каталог конфигурации компоновки и изменить соответствующие целевые объекты ant. Сценарий будет автоматически обнаружен и применен консольной компоновкой.
Сценарий customTargets.xml также обеспечивает делегирование в сценарий allElements.xml для каждого этапа компоновки.
Сценарий allElements.xml является одним из видов сценария делегирования, который служит для запуска различных этапов компоновки для данного элемента (как правило, это комплект). Как и в случае с customTargets.xml, для выполнения этих этапов настройки скопируйте шаблон из PDE/Build в каталог конфигурации компоновки. В Eclipse 3.4 целевой элемент компоновки может быть определен в высокоуровневом файле конфигурации компоновки - build.properties, в свойствах topLevelElementType и topLevelElementId. Для свойства elementType следует задать значение feature, а значением свойства elementId должен быть идентификатор комплекта, который будет скомпонован.
<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="${topLevelElementType}" />
<property name="id" value="${topLevelElementId}" />
</ant>
</target>
В allElements.xml также указываются целевые объекты, используемые в процессе компоновки - на этапах сборки и упаковки. Для сборки архивов для всех платформ выполняется вызов целевого объекта defaultAssemble. По желанию, для отдельных платформ можно определить пользовательские целевые объекты.
Для использования пользовательского целевого объекта для определенной платформы, необходимо определить свойство "assemble.<element-id>[.<config>] и соответствующий целевой объект. Этим свойством назначается использование в PDE/Build данного пользовательского целевого объекта вместо целевого объекта по умолчанию. Впоследствии этот пользовательский целевой объект может использоваться для присвоения архиву пользовательского имени или для выполнения предварительной или последующей обработки архива.
Пример:
<property name="assemble.org.foo.feature.id.linux.gtk.x86" value="true" />
<target name="assemble.org.foo.feature.id.linux.gtk.x86">
<property name="archiveName" value="acme-RCP-${buildId}-linux.gtk.x86.tar.gz" />
<-- custom pre assemble steps for linux.gtk.x86-->
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
<-- custom post assemble steps for linux.gtk.x86-->
</target>
Сценарий customAssembly.xml является новым для версии 3.4. Он предоставляет точки пользовательской настройки, вызов которых будет выполняться на этапах компоновки, связанных со сборкой и составлением пакетов. Как и в случае с customTargets.xml и allElements.xml, для того чтобы воспользоваться этими возможностями настройки, нужно скопировать шаблон из PDE/Build в каталог конфигурации компоновки.
Сценариями сборки и составления пакетов, сгенерированными PDE/Build, выполняются следующие действия:
Сценарии сборки выполняют сбор комплектов и модулей, скомпилированных в ходе компоновки, а сценарии пакетов предназначены для сбора всех предварительно скомпилированных двоичных комплектов и модулей. В сценарии customAssembly.xml предоставляются следующие целевые объекты до или после каждого из описанных выше этапов: