Эта страница описывает устаревший способ интеграции с p2. На странице "Компоновка продуктов и хранилищ p2" приведены рекомендованные методы компоновки с помощью. Описанные ниже свойства работают на уровне обратной совместимости и не поддерживают новых компонентов, которые могли быть добавлены в сервер публикации p2.
Подробная информация о генерации метаданных p2 содержится в разделе Генерация метаданных p2 Руководства разработчика модулей платформы. Одного только генерирования метаданных недостаточно для создания продукта с поддержкой p2. Необходимо еще выполнить фактическую установку p2 на основе сгенерированных метаданных. Подробные сведения о том, как выполнить такую установку, можно найти в документации к приложению направления p2.
Можно генерировать метаданные p2 с помощью вызовов вручную, адресованных генератору метаданных p2 в любой из пользовательских задач PDE/Build (см. Настройка консольной компоновки). Тем не менее, PDE/Build на самом деле обеспечивает интеграцию с p2 через следующие свойства:
generate.p2.metadata |
(Устарело, используйте вместо него
p2.gathering) Установите значение
true для включения генерации метаданных p2. Сценарии ant основываются на наличии этого свойства, а не назначении. Для выключения генерирования метаданных это свойство должно быть удалено, а не задано как false. В сценариях компоновки вызовы, адресованные целевым объектам p2, генерируются, если комплект p2 org.eclipse.equinox.p2.metadata.generator и его зависимости присутствуют в Eclipse, в котором запущена компоновка. Эти целевые объекты p2 зависят от свойства generate.p2.metadata. |
p2.metadata.repo |
Укажите в параметре file: URI, соответствующий расположению хранилищ метаданных p2 и
артефактов для размещения публикации. Как правило, но не всегда, расположение хранилища артефактов
совпадает с расположением хранилища метаданных. Пример:
p2.metadata.repo=file:${buildDirectory}/repository
p2.artifact.repo=file:${buildDirectory}/repository
|
p2.metadata.repo.name |
Необязательный атрибут. Укажите имена хранилищ генератора p2. При использовании уже существующего хранилища, существующее имя хранилища не меняется. Если этот атрибут не указан, p2 присвоит хранилищам имена в соответствии с их расположением. |
p2.flavor |
Задайте разновидность метаданных p2. При генерации метаданных для Eclipse SDK, используется разновидность "tooling" (инструментарий). |
p2.publish.artifacts |
Значение true позволяет публиковать файлы jar в хранилище артефактов. Значение false означает, что метаданные артефактов генерируются, но файлы jar не копируются в хранилище артефактов. ПРЕДУПРЕЖДЕНИЕ: Если задано значение true, убедитесь в том, что расположение p2.artifact.repo не совпадает с расположением каталогов сборки, используемых PDE/Build, иначе в конце концов файлы jar могут быть удалены! |
p2.root.name |
Укажите имя и версию корневого устанавливаемого блока (IU), в котором будут содержаться все результаты компоновки. Если в компоновке указан файл .product, то эти свойства будут игнорироваться. Вместо них, при наличии файла .product, именем и версией корневого объекта будут идентификатор продукта и его версия, взятые из файла .product. Дополнительную информацию см. ниже. |
При выполнении компоновки с файлом продукта, находящимся в файле build.properties высшего уровня компоновки (при компоновке с помощью файла productBuild.xml или обычного файла build.xml), PDE/Build автоматически генерирует метаданные для этого продукта.
В дополнение к созданию Устанавливаемых блоков для всех компонентов и комплектов, также создаются следующие Устанавливаемые блоки продукта:
Если имеются все эти сгенерированные Устанавливаемые блоки, тогда можно использовать p2 для полной установки продукта из хранилища.
PDE/Build, по сути, вызывает задачу генерирования метаданных, предоставляемую p2 в определенные моменты в процессе компоновки. Скорее всего, во время компоновки не бывает ни одного момента времени, когда все артефакты компоновки существовали бы на диске в одном и том же месте. Следовательно, необходимо либо вызывать генератор метаданных p2 в окончательных архивах, либо, в целях оптимизации процесса, вызывать его несколько раз на протяжении компоновки.
Генерация метаданных выполняется на всех этапах сборки и составления пакетов. Это касается как обычных компоновок, так и компоновок упаковщика. Например, для компоновки продукта с помощью productBuild.xml будут сгенерированы следующие сценарии (допустим, configs=win32,win32,x86 & linux,gtk,ppc):
Сценарии сборки выполняют сбор компонентов и модулей, которые были скомпонованы, вместе с соответствующими корневыми файлами. Сценарии пакетов собирают предварительно скомпонованные двоичные компоненты и модули. Специальные сценарии платформ собирают элементы для определенных конфигураций, а сценарии "all" (всё) выполняют делегирование в каждый из специальных сценариев платформ.
Вызовы генерирования p2 осуществляются следующим образом:
Задача генератора метаданных p2 поддерживает генерацию с приращением, каждый вызов генерированных метаданных p2 выполняется с параметромmode=incremental, а последний вызов для генерирования корневого устанавливаемого блока выполняется с параметром mode="final"