p2 リポジトリーおよび製品のビルド

PDE/ビルドには、新しい p2 パブリッシャーによる p2 メタデータの公開に関するサポートが組み込まれています。 以前のメタデータ・生成プログラムを使用した 3.4 スタイルの統合も引き続き機能しますが、 メタデータのカスタマイズといった新機能はサポートされません。

新しいパブリッシャーによる統合では、フィーチャーとバンドルがソースから収集され、p2 リポジトリーに直接公開されます。 この新機能を使用するには、ビルダーで次のプロパティーを定義する必要があります。

p2.gathering = true

このプロパティーを設定すると、ビルドの方法が次のように大幅に変化します。

これらのタイプのビルドの詳細については、個々のフィーチャー・ビルドおよび製品ビルドのヘルプ・ページを参照してください。

変更内容の概要

ビルドのローカル・リポジトリー

ビルドの際、すべてのメタデータと成果物は、プロパティー p2.build.repo によって定義されたビルド・リポジトリーに公開されます。 このプロパティーは URI を指定する必要があります。デフォルト値は file:${buildDirectory}/buildRepo です。

すべてのメタデータと成果物がこのリポジトリーに公開されると、最終的なアセンブルおよびパッケージ化スクリプトでは、このリポジトリーから、ビルドによって生成されるアーカイブになるロケーションに対してミラーリングやインストールが行われます。 この最終的なミラーリングおよびインストールは、skipMirroring および skipDirector プロパティーを使用してスキップすることができます。この場合、ビルドのすべての結果はビルド・リポジトリーに入ります。

生成される build.xml : 収集の場合と公開の場合の違い

フィーチャーおよびプラグイン用に生成される build.xml には、 フィーチャー/プラグインの内容を収集し、jar 化されて (されない場合もある) ビルド結果に含まれるように最終ディレクトリーにコピーした、 ターゲット gather.bin.parts が含まれています。 p2.gathering=true を使用した場合、フィーチャー/プラグインは代わりに p2 リポジトリーに直接公開されます。 つまり、p2 により、バイナリー成果物がソース (プロパティーの名前はこの場所から取られます) から直接収集されます。

これは、PDE/ビルドによってコントリビュートされる新しい Ant タスクを使用する、 publish.bin.parts という名前の新しいターゲットを使用して行われます。 以前のスタイルのビルドでは、フィーチャー構造を介した委譲によって gather.bin.parts の呼び出しが行われていました。 publish.bin.parts の呼び出しは、その代わりに、生成される新しいアセンブル p2 スクリプトから直接行われます。

フィーチャーによってコントリビュートされるルート・ファイル

以前のスタイルの統合では、ビルド内のすべてのフィーチャーによってコントリビュートされるすべてのルート・ファイルが、単一のルート・ファイル・インストール可能単位および成果物にグループ化されていました (これには、製品用の名前が付けられている可能性があります)。 新しく公開がサポートされたことに伴い、これに代わって、ルート・ファイルはそれをコントリビュートしたフィーチャーに関連付けられます。 詳しくは、フィーチャー・メタデータのレイアウトのページを参照してください。

アセンブル・スクリプト

以前のスタイルの統合は、アセンブリーおよびパッケージ化プロセスの際にバイナリーの結果に対してメタデータ生成プログラムを呼び出すことによって行われていました。 p2.gathering=true を使用する場合は、新しい assemble.<feature>.p2.xml スクリプトを使用できます。

このスクリプトは、ビルド中のすべてのフィーチャーとバンドルに対して publish.bin.parts を呼び出します。 また、既存のすべてのバイナリーのフィーチャーおよびプラグイン用のメタデータを公開するとともに、製品用のメタデータを公開します。

p2 アセンブル・スクリプトが終了した後、残りのアセンブルおよびパッケージ・スクリプトが呼び出される前の時点で、ビルドの全結果を含む完全なリポジトリーが存在しています。 残りのアセンブルおよびパッケージ・スクリプトは、リポジトリーのスライス化や p2 ディレクターによるインストールを行って、ビルドの結果である最終的なアーカイブを作成するだけです。