PDE ビルドの p2 との統合

このページでは、非推奨の古い方法である p2 との統合について説明します。推奨される p2 とのビルドの方法については、『p2 リポジトリーおよび製品のビルド』ページを参照してください。 以下に記述されているプロパティーは、下位互換性レイヤーを使用して動作し、p2 パブリッシャーに追加される新規フィーチャーはサポートしません。

p2 メタデータ生成について詳しくは、「プラットフォーム・プラグイン・デベロッパー・ガイド (Platform Plugin-in Developer Guide)」の p2 メタデータの生成に関するページを参照してください。p2 対応の製品を作成するには、 メタデータを生成しただけでは十分ではありません。製品を作成するには、 生成されたメタデータから実際に p2 のインストールを実行する必要があります。ヘッドレス・スクリプトからこのインストールを実行する方法について詳しくは、 「p2 ディレクター」資料を参照してください。

PDE/ビルドのカスタム・タスクのいずれかで、p2 メタデータ生成プログラムに対する手動呼び出しを行うことで、p2 メタデータを生成できます (『ヘッドレス・ビルドのカスタマイズ』を参照してください)。 また、PDE/ビルドは、以下のプロパティーを使用して p2 との統合も行います。

generate.p2.metadata
(非推奨、p2.gathering を代わりに使用してください) p2 メタデータ生成をオンにする場合、true に設定します。Ant スクリプトはこのプロパティーの値ではなく有無に基づいています。 メタデータの生成をオフにするには、このプロパティーを単に false に設定するのではなく、削除する必要があります。
ビルド・スクリプトで、ビルドを実行している Eclipse 内に p2 バンドル org.eclipse.equinox.p2.metadata.generator およびその依存関係が存在している場合、p2 ターゲットへの呼び出しが生成されます。 これらの p2 ターゲットは、generate.p2.metadata プロパティーを条件とします。
p2.metadata.repo
p2.artifact.repo
公開先となる p2 のメタデータ・リポジトリーおよび成果物リポジトリーの場所を示す file: URI を指定します。 一般に、成果物リポジトリーはメタデータ・ リポジトリーと同じロケーションを使用しますが、必ずしも同じである必要はありません。
例:
			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
成果物リポジトリーに JAR を公開する場合は、true に設定します。false に設定した場合、成果物メタデータは生成されますが、その JAR は成果物リポジトリーにコピーされません。警告: true に設定した場合は 、p2.artifact.repo のロケーションと、PDE/ビルドで使用されるアセンブリー・ディレクトリーのロケーションが、別の場所になるようにしてください。同じロケーションにすると、JAR が削除されてしまう恐れがあります。
p2.root.name
p2.root.version
ビルドされたものすべてを含むルート IU の名前およびバージョンを指定します。
ビルドで .product ファイルが指定されている場合、これらのプロパティーは無視されます。.product ファイルが選択可能になっていて、選択されていない場合、 ルート名およびバージョンは、.product ファイルの製品 ID および製品バージョンになります。詳しくは以下を参照してください。

製品のメタデータ生成

最上位レベルのビルド構成 build.properties ファイルで設定された製品ファイルを使用してビルドを実行する場合 (productBuild.xml を使用するビルドおよび通常の build.xml を使用するビルドの両方の場合)、PDE/ビルドは自動的にその製品のメタデータを生成します。

すべてのフィーチャーおよびバンドルのインストール可能単位の作成に加え、このビルドは、以下のような製品のインストール可能単位も作成します。

これらの生成されたインストール可能単位すべてによって、p2 を使用して、完全な製品をリポジトリーからインストールすることができます。

詳細

基本的に PDE/ビルドは、ビルド中のあるポイントで 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 用に収集されたルート・ファイルの生成済み メタデータに関して、2 回目の呼び出しを行います。
  3. assemble linux.gtk.ppc: Linux 用に収集されたフィーチャーおよびプラグインのメタデータを生成します。
  4. assemble linux.gtk.ppc: Linux 用に収集されたルート・ファイルの生成済みメタデータに関して、2 回目の呼び出しを行います。
  5. assemble all: パッケージャーを実行していない場合、上に記載したすべてを含むルートのインストール可能単位についてメタデータを生成します。
  6. package win32.win32.x86: Windows 用にパッケージされたフィーチャーおよびプラグインのメタデータを生成します。
  7. package win32.win32.x86: Windows 用のパッケージ化で生成されたルート・ファイルのメタデータに対して、2 回目の呼び出しを行います。
  8. package linux.gtk.ppc: Linux 用にパッケージ化されたフィーチャーおよびプラグインのメタデータを生成します。
  9. package linux.gtk.ppc: Linux 用のパッケージ化で生成されたルート・ファイルのメタデータに対して、2 回目の呼び出しを行います。
  10. package all: 上に記載したものすべてを含むルートのインストール可能単位についてメタデータを生成します。

p2 メタデータ生成プログラム・タスクは、インクリメンタル生成をサポートします。生成された p2 メタデータに対する各呼び出しは、mode=incremental によって行われ、ルートのインストール可能単位を生成するための最終呼び出しは、mode="final" によって実行されます。