Работа со спецификаторами версий

Комплекты Eclipse имеют следующий формат версий: главная.второстепенная.уточнение.спецификатор.  Спецификатор версии часто указывает на компоновку.  Если спецификатор версии модуля или комплекта задан как "qualifier" (то есть, например, 1.0.0.qualifier), то при компоновке PDE автоматически подставит вместо "qualifier" нужное значение.

Настройка сгенерированного спецификатора

Комплект или модуль может контролировать свой спецификатор, если свойство qualifier" в файле build.properties задано. Два разных случая задания значения этого свойства следующие:

qualifier = noneЗадает пустой спецификатор (то есть "1.2.3.qualifier" дает "1.2.3")
qualifier = contextЗадает спецификатор context. Дополнительная информация о спецификаторе context приведена ниже.
not setЕсли значением свойства "qualifier" является not set, то это эквивалентно заданию qualifier = context.
qualifier = v12345Любое другое значение задает спецификатор с этим значением.

Спецификатор context

Значение созданного спецификатора context определяется первым из следующих применимых элементов:
  1. Если свойство forceContextQualifier задано в файле build.properties, , то значение этого свойства применяется как спецификатор.  Это свойство можно также задать в командной строке с -D при вызове ant.
  2. Если для извлечения комплектов из хранилища используются файлы карты связей, то спецификатором будет тег, использованный при получении комплекта.
  3. В противном случае спецификатор задается как системное время в формате YYYYMMDDHHMM (например, 200605121600)

Суффиксы версий комплектов

Свойство generateFeatureVersionSuffix=true в файле build.properties позволяет включить генерацию суффиксов для спецификаторов.

Версия будет увеличиваться с каждым изменением, если это будет отражаться в спецификаторе.  Комплекты меняются реже, но входящие в них модули могут изменяться часто.  Суффиксы позволяют указывать версию комплекта в формате главная.второстепенная.уточнение.спецификатор-суффикс.   Суффикс фактически является суммой спецификаторов всех комплектов и их модулей.  Таким образом, при увеличении версии модуля автоматически увеличится также версия комплекта.  Это особенно полезно при распространении комплекта через сайт обновления.

Окончательные версии

Иногда при компоновке может потребоваться окончательная версия комплекта.  Если свойство generateVersionsLists задано, то PDE/Build создает файлы свойств, содержащие версии скомпонованных комплектов и модулей.  Эти файлы можно загрузить с помощью задачи свойств ant.

Имена файлов: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties, and  finalFeaturesVersions.<config>.properties.  Файлы finalPluginsVersions.properties и finalFeaturesVersions.properties содержат версии всех комплектов и модулей, задействованных в компоновке. Файлы <config> содержат версии для отдельных конфигураций.

Свойства в этих файлах указываются в следующем формате:

    <bundleSymbolicName> = <версия>
    <bundleSymbolicName>_<первые 3 сегмента версии> = <версия>
Если версий какого-либо модуля или комплекта несколько, то в свойстве <bundleSymbolicName>=<версия> подразумевается последняя версия. Пример:
    org.eclipse.pde.build = 3.3.0.v20070524
    org.eclipse.pde.build_3.3.0=3.3.0.v20070524
    org.eclipse.pde.build_3.2.1=3.2.1.r321_v20060823