p2 メタデータの再利用

特定のフィーチャーまたはバンドルのメタデータは、生成方法に応じて異なることがあります。 特に、メタデータのカスタマイズを行う際や、 フィーチャーがルート・ファイルをコントリビュートする場合がこれに当たります。

このため、自身が所有していない可能性のあるバイナリーのフィーチャーやバンドルに基づいてメタデータを再生成する代わりに、可能な場合は常にメタデータを再利用することをお勧めします。

repo2runnable タスク

Ant タスク <p2.repo2runnable> は、フィーチャーやバンドルの成果物をインストール済みの形式に変換します。 一般に、プラグインに対するコンパイルを行うには、そのプラグインがこの形状になっている必要があります。 このタスクにより、他のプロジェクトのリポジトリーを独自のビルドで再利用することが容易になります。 PDE/ビルドには、以下のプロパティーを介して、このタスクの統合が組み込まれています。

repoBaseLocation変換するリポジトリーが含まれるフォルダー。 このフォルダーには、zip 化されたリポジトリーや、リポジトリーであるサブフォルダーを含めることができます。
transformedRepoLocation変換された成果物が配置されるフォルダー。 このフォルダーは、それ自体が p2 リポジトリーになります。

3.5 の新機能は、PDE/ビルドが <p2.repo2runnable> を呼び出した後で発生するカスタム・ターゲットである preProcessRepos と postProcessRepos です。 これにより、zip 化されたリポジトリーの自動的なミラーリングまたはダウンロードが可能になります。
build.properties:
	repoBaseLocation=${buildDirectory}/inputRepositories
	transformedRepoLocation=${buildDirectory}/transformedRepo
	
customTargets.xml:
<target name="preProcessRepos">
   <p2.mirror source="http://download.eclipse.org/releases/galileo" destination="file:${repoBaseLocation}/mirrored">
      <iu id="org.eclipse.equinox.p2.user.ui.feature.group" />
      <iu id="org.eclipse.cdt.feature.group"/>
   </p2.mirror>
   <property name="RCP.Repo-3.5RC3" value="http://download.eclipse.org/eclipse/downloads/drops/S-3.5RC3-200905282000/org.eclipse.rcp-p2repo-3.5RC3.zip" />
   <property name="Equinox.Repo-3.5RC3" value="http://download.eclipse.org/equinox/drops/S-3.5RC3-200905282000/equinox-SDK-3.5RC3.zip" />
   <get src="${RCP.Repo-3.5RC3" dest="${repoBaseLocation}/org.eclipse.rcp-p2repo-3.5RC3.zip" />
   <get src="${Equinox.Repo-3.5RC3" dest=""${repoBaseLocation}/eclipse-equinox-3.5RC3.zip" />
</target>
(本資料の作成時点で、3.5 の最終 zip のロケーションは不明であるため、ここで使用されている URL は単なる例であり、将来の任意の時点で存在するとは限りません。)

PDE/ビルドは、最初に preProcessRepos カスタム・ターゲットを呼び出した後、Ant タスク repo2runnable を呼び出して、ダウンロードされたこれらのリポジトリーをビルドで再利用可能な形式に変換します。

この変換の出力のロケーションを定義する transformedRepoLocation プロパティーは、コンテキスト・リポジトリーとしても機能します。

コンテキスト・リポジトリー

プロパティー p2.context.repos は、ビルドに対してコンテキスト として機能するリポジトリーのコンマ区切りリストです。

メタデータを生成する際、ビルドは最初にコンテキスト・リポジトリーを参照して、そのフィーチャーまたはプラグイン用のメタデータがすでに存在していないかどうかを確認します。 メタデータがすでに存在している場合は、新規のメタデータが生成される代わりに、そのメタデータがビルドのローカル・リポジトリー (${p2.build.repo}) にコピーされます。

同様に、フィーチャー、バンドル、または製品のメタデータが、ビルドに組み込まれていない何らかのものに依存するようにカスタマイズされている場合、PDE/ビルドは、コンテキスト・リポジトリーからミラーリングを実行します。 このミラーリング操作により、フィーチャーまたはプラグインのメタデータに追加された IU が組み込まれます。