Компоновки продуктов с помощью p2

Определение нового свойства:

p2.gathering = true

вносит несколько изменений в компоновки продуктов. В частности, компоновка будет создавать правильно установленные полнофункциональные разрешенные p2.

Далее приведен список связанных свойств (старых и новых):

p2.gatheringПри значении true включает компоновки на основе издателя p2.
p2.build.repoURI локального хранилища p2 во время компоновки, значение по умолчанию - file:${buildDirectory}/buildRepo. Отсюда результаты будут зеркально скопированы в расположение конечного архива.
generate.p2.metadataЭто свойство для старой интеграции генератора метаданных. Оно не действует, когда p2.gathering=true.
p2.metadata.repo
p2.artifact.repo
Эти свойства задают URI. По умолчанию для компоновок продуктов конечными архивами являются установленные продукты, а метаданные и артефакты остаются в ${p2.build.repo}. Если p2.metadata.repo и p2.artifact.repo заданы, то артефакты и метаданные для продукта будут зеркально копироваться из хранилища компоновки.
p2.metadata.repo.name
p2.artifact.repo.name
Эти свойства необязательны и будут использоваться для присвоения имени конечному хранилищу, если p2.metadata.repo и p2.artifact.repo заданы.
p2.compressПри задании значения true конечное хранилище xml сжимается в jar.
p2.flavorРазновидность продукта, используемая как спецификатор метаданных конфигурации для этого продукта. Дополнительная информация приведена далее.
p2.product.qualifierСпецификатор, используемый при замене "1.0.0.квалификатора" в версии продукта. Если не задано, спецификатор будет основываться на forceContextQualifier или системном времени.
p2.publish.artifactsНе оказывает влияния, когда p2.gathering=true (устаревшее свойство)
p2.root.name
p2.root.version
Не оказывает влияния, когда p2.gathering=true (устаревшее свойство)
p2.context.reposОпределяет хранилища контекстов. Дополнительная информация приведена в разделе о повторном использовании метаданных.
repoBaseLocationПапка, содержащая хранилища для преобразования с помощью <p2.repo2runnable>. Дополнительная информация приведена в разделе о повторном использовании метаданных.
transformedRepoLocationПапка, содержащая результат <p2.repo2runnable>. Дополнительная информация приведена в разделе о повторном использовании метаданных.
p2.category.siteURL файла site.xml, используемого для определения категорий.
p2.category.definitionURL файла category.xml, используемого для определения категорий.
p2.category.prefixОпределяет префикс для обеспечения уникальных ИД для устанавливаемых блоков (IU) категорий, создаваемых из файлов сайта/категорий, не имеющих уникальных имен.
skipMirroringПропускает конечное зеркальное копирование из ${p2.build.repo} в ${p2.metadata.repo}.
skipDirectorПропускает вызов контроллера. Установленные продукты не создаются. Если p2.metadata.repo и p2.artifact.repo заданы, то эти хранилища будут содержать метаданные и артефакты продукта; в противном случае ${p2.build.repo} будет содержать результаты.
p2.director.logРасположение файла протокола для протоколирования результатов вызова контроллера.
p2.director.profileИмя профайла p2, созданного контроллером. Обычно рекомендуется использовать имя, как-то связанное с продуктом. По умолчанию используется имя "profile".
p2.director.extraArgsДополнительные аргументы для передачи в каталог. По умолчанию -profileProperties org.eclipse.update.install.features=true".
Свойства зеркальной защитыПри компоновке продуктов или компонентов в компоновку должны быть включены зависимости зеркал PDE/Build из хранилищ контекстов. Эти параметры управляют тем, какие зависимости включены в этой операции. Более подробная информация содержится в разделе Задача ant p2.mirror.
p2.mirror.rawЗначение по умолчанию: false. Установите значение true для повторного использования файлов описаний артефактов из исходных хранилищ.
p2.mirror.slicing.filterПо умолчанию фильтр не используется. Установите дополнительные свойства фильтра, которыми должны обладать элементы IU для включения.
p2.mirror.slicing.followOnlyFilteredRequirementsЗначение по умолчанию - false. Установите значение true для инверсии фильтров и включения только тех элементов IU, которые не удовлетворяют критериям.
p2.mirror.slicing.followStrictЗначение по умолчанию - false. Установите значение true для включения только тех зависимостей, версии которых точно указаны.
p2.mirror.slicing.includeFeaturesЗначение по умолчанию - true. Нужно ли включать компоненты.
p2.mirror.slicing.includeNonGreedyЗначение по умолчанию - false. Нужно ли включать не-жадные зависимости.
p2.mirror.slicing.includeOptionalНужно ли включать необязательные зависимости. По умолчанию используется значение true.
p2.mirror.slicing.latestVersionOnlyПо умолчанию используется значение false. Нужно ли включать только последнюю версию зависимости, когда требованием является диапазон и доступно несколько версий.
p2.mirror.slicing.platformFilterПо умолчанию фильтр не используется. Тройка "os,ws,arch" для установки фильтров LDAP IU для платформы. Для IU, которые не соответствуют фильтру, зеркальные копии не будут создаваться.

Разновидность продукта

Как часть компоновки продукта, PDE/Build автоматически создает метаданные конфигурации по умолчанию для задания уровней запуска и свойства config.ini. Эти метаданные обычно называются блоками конфигурации (CU). В частности, уровни запуска задаются с помощью фрагментов CU на устанавливаемом блоке (IU) для запускаемого пакета. Разновидность используется как спецификатор при создании имени CU на основе IU.

Например, в случае p2.flavor = tooling" 'toolingwin32.win32.x86org.eclipse.core.runtime' будет именем CU, который настраивает пакет org.eclipse.core.runtime под Windows. Рекомендуется использовать разновидность, основанную на ИД продукта, чтобы избежать конфликтов с другими метаданными, особенно если продукт требует задания уровней запуска.

Дополнительная информация приведена на странице о настройке продуктов configuring products.

Вызов контроллера

PDE/Build включает целевой объект runDirector, который вызывается для выполнения установок во время компоновки продукта. В настоящее время это ветвь приложения-контроллера в новом процессе. В более совершенных сценариях releng можно повторно использовать эту задачу для выполнения дополнительных установок. Эта задача требует, чтобы расположение программы запуска equinox для компоновщика было определено. Например, вызов может выглядеть следующим образом:
	<property name="equinoxLauncherJar" value="/builder/eclipse/plugins/org.eclipse.equinox.launcher_1.0.200.v20090520.jar"/>
	<ant antfile="${eclipse.pdebuild.scripts}/genericTargets.xml" target="runDirector" inheritAll="true">
		<property name="ws" value="gtk"/>
		<property name="os" value="linux"/>
		<property name="arch" value="x86"/>
		<property name="p2.director.installPath" value="${installFolder}"/>
		<property name="p2.repo" value="${p2.build.repo}"/>
		<property name="p2.director.iu" value="my.rcp.product"/>
		<property name="p2.director.version" value="1.0.0"/>
	</ant>