Интеграция компоновки PDE с p2

Эта страница описывает устаревший способ интеграции с 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
p2.artifact.repo
Укажите в параметре file: URI, соответствующий расположению хранилищ метаданных p2 и артефактов для размещения публикации. Как правило, но не всегда, расположение хранилища артефактов совпадает с расположением хранилища метаданных.
Пример:
			p2.metadata.repo=file:${buildDirectory}/repository
			p2.artifact.repo=file:${buildDirectory}/repository
			
p2.metadata.repo.name
p2.artifact.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
p2.root.version
Укажите имя и версию корневого устанавливаемого блока (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 осуществляются следующим образом:

  1. assemble win32.win32.x86 : Генерировать метаданные для собранных компонентов и модулей для windows.
  2. assemble win32.win32.x86 : Второй вызов, адресованный генерированным метаданным для собранных корневых файлов в windows.
  3. assemble linux.gtk.ppc : Генерировать метаданные для собранных компонентов и модулей для linux.
  4. assemble linux.gtk.ppc : Второй вызов, адресованный генерированным метаданным для собранных корневых файлов в linux.
  5. assemble all : Если не запущен упаковщик: Генерировать метаданные для корневого устанавливаемого блока, включающего в себя все расположенные выше элементы.
  6. package win32.win32.x86 : Генерировать метаданные для собранных в пакеты компонентов и модулей для windows.
  7. package win32.win32.x86 : Второй вызов, адресованный генерированным метаданным в корневых файлах из пакетов для windows.
  8. package linux.gtk.ppc : Генерировать метаданные для собранных в пакеты компонентов и модулей для linux.
  9. package linux.gtk.ppc : Второй вызов, адресованный генерированным метаданным в корневых файлах из пакетов для linux..
  10. package all : Генерировать метаданные для корневого устанавливаемого блока, включающего в себя все расположенные выше элементы.

Задача генератора метаданных p2 поддерживает генерацию с приращением, каждый вызов генерированных метаданных p2 выполняется с параметромmode=incremental, а последний вызов для генерирования корневого устанавливаемого блока выполняется с параметром mode="final"