バージョン修飾子の使用

Eclipse のバンドルおよびフィーチャーには、major.minor.micro.qualifier という形式のバージョン番号が付いています。   バージョンの qualifier (修飾子) セグメントは、特定のビルドを表すために使用されるのが普通です。  フィーチャーまたはプラグインのバージョン修飾子を 「qualifier」(例えばバージョン 1.0.0.qualifier) に 設定すると、PDE ビルドは自動的に、「qualifier」という語を生成された修飾子で置き換えます。

生成済み修飾子の制御

フィーチャーやプラグインは、build.properties ファイルでプロパティー「qualifier」を設定することによって、自身の修飾子を制御できます。 このプロパティーの値は、以下のように複数の種類があります。

qualifier = none修飾子を空に設定します。 (例えば、「1.2.3.qualifier」は「1.2.3」になります)
qualifier = context修飾子をコンテキスト 修飾子に設定します。 コンテキスト修飾子の値については、以下を参照してください。
未設定「qualifier」プロパティーが設定されていない場合は、qualifier = context を設定した場合と同じになります。
qualifier = v12345他の任意の値を設定した場合、修飾子はその値になります。

コンテキスト修飾子

生成されるコンテキスト修飾子の値は、以下の項目のうち、最初に該当するものによって決まります。
  1. プロパティー forceContextQualifier がビルダーの構成ファイル build.properties で 設定されている場合は、 このプロパティーの値が修飾子として使用されます。  このプロパティーは、Ant を呼び出す際にコマンド行で -D を指定することによっても設定できます。
  2. マップ・ファイルを使用してリポジトリーからバンドルを取り出す場合は、バンドルの取り出しに使用したタグが修飾子として使用されます。
  3. forceContextQualifier もマップ・ファイルも使用しない場合は、 YYYYMMDDHHMM という形式のタイム・スタンプ (例えば 200605121600) が修飾子になります。

フィーチャー・バージョンの接尾部

ビルドの構成ファイル build.properties でプロパティー generateFeatureVersionSuffix=true を設定することで、フィーチャーの修飾子接尾部の生成を有効にすることができます。

バージョンの考え方は、何か変更があるたびに増分するということです。 バージョン修飾子が増分することにより、ビルドからビルドへの変更が捕そくされます。  フィーチャーはめったに変更されませんが、フィーチャーに含まれるプラグインは変更されることがよくあります。  バージョンの接尾部が有効になっている場合、フィーチャー・バージョンの形式は、major.minor.micro.qualifier-suffix のようになります。    suffix (接尾部) は、実際は、そのフィーチャーに組み込まれているすべてのフィーチャーとプラグインのバージョン修飾子の合計です。  つまり、組み込みプラグインのいずれか 1 つのバージョンが上がったら、 フィーチャーのバージョンも自動的に増加します。  この仕組みは、フィーチャーが更新サイト経由でデプロイされる場合に特に有用です。

最終バージョン

場合によっては、ビルドで実際の最終バージョンを使用しなければならないカスタム・ビルド・ステップがあります。 generateVersionsLists プロパティーが設定されている場合、PDE ビルドは、ビルドされたフィーチャーおよびプラグインのバージョンを含むプロパティー・ファイルを 生成します。 これらのプロパティー・ファイルは Ant プロパティー・タスクを使用してロードできます。

ファイルの名前は次のとおりです。 finalPluginsVersions.properties、 finalPluginsVersions.<config>.properties、 finalFeaturesVersions.properties、および  finalFeaturesVersions.<config>.properties。  finalPluginsVersions.properties および finalFeaturesVersions.properties には、ビルドされたすべてのプラグインおよびフィーチャーのバージョンが含まれています。 <config> プロパティー・ファイルには、特定のビルド構成用のプラグインおよびフィーチャーのバージョンが含まれています。

これらのファイルのプロパティーの形式は、次のようになっています。

    <bundleSymbolicName> = <version>
    <bundleSymbolicName>_<first 3 segments of version> = <version>
複数のバージョンのプラグインまたはフィーチャーが存在する場合、<bundleSymbolicName>=<version> は最も新しいバージョンのプラグインまたはフィーチャーを参照します。 例:
    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