p2 使用時の製品ビルド

次の新規プロパティー

p2.gathering = true

を定義すると、製品ビルドにいくつかの変更が加えられます。 特に、ビルドにより、適切にインストールされた完全に使用可能な製品が生成されます。

関連するプロパティー (以前のものと新しいもの) のリストを以下に示します。

p2.gatheringp2 パブリッシャー・ベースのビルドをオンにするには、true に設定します。
p2.build.repoローカル・ビルド時 p2 リポジトリーの URI。 デフォルトは file:${buildDirectory}/buildRepo です。 結果はここから最終的なアーカイブ・ロケーションにミラーリングされます。
generate.p2.metadataこれは、以前のメタデータ生成プログラムの統合のためのプロパティーです。 p2.gathering=true である場合、効果はありません。
p2.metadata.repo
p2.artifact.repo
これらのプロパティーは URI です。 製品ビルドの場合、デフォルトでは、インストール済みの製品が最終アーカイブとなり、メタデータおよび成果物は ${p2.build.repo} 内に残されます。p2.metadata.repo と p2.artifact.repo が定義されている場合は、製品の成果物とメタデータがビルド・リポジトリーからミラーリングされます。
p2.metadata.repo.name
p2.artifact.repo.name
オプション。これらのプロパティーは、p2.metadata.repo と p2.artifact.repo が定義されている場合に、最終的なリポジトリーに名前を付けるために使用されます。
p2.compress最終的なリポジトリー xml を jar に圧縮するには、true に設定します。
p2.flavor製品の構成メタデータで限定子として使用される、製品のフレーバー。 以下を参照してください。
p2.product.qualifier製品のバージョンで「1.0.0.qualifier」を置換する際に使用する限定子。 設定しない場合、限定子は forceContextQualifier またはタイム・スタンプに基づいて決定されます。
p2.publish.artifactsp2.gathering=true である場合は影響しません (以前のプロパティー)。
p2.root.name
p2.root.version
p2.gathering=true である場合は影響しません (以前のプロパティー)。
p2.context.reposコンテキスト・リポジトリーを定義します。 メタデータの再利用を参照してください。
repoBaseLocation<p2.repo2runnable> を使用して変換するリポジトリーが含まれるフォルダー。 メタデータの再利用も参照してください。
transformedRepoLocation<p2.repo2runnable> の出力が含まれるフォルダー。 メタデータの再利用も参照してください。
p2.category.siteカテゴリーを定義するために使用される site.xml ファイルへの URL。
p2.category.definitionカテゴリーを定義するために使用される category.xml ファイルへの URL。
p2.category.prefix固有の名前を使用しない site/category ファイルから生成されるカテゴリー IU の ID が固有であることを保証するための接頭部を定義します。
skipMirroring${p2.build.repo} から ${p2.metadata.repo} への最終的なミラーリングをスキップします。
skipDirectorディレクターの呼び出しをスキップします。 インストール済みの製品は生成されません。 p2.metadata.repo と p2.artifact.repo が定義されている場合、製品のメタデータと成果物はこれらのリポジトリーに含まれます。 それ以外の場合は、${p2.build.repo} に結果が含まれます。
p2.director.logディレクターの呼び出しの結果が記録されるログ・ファイルのロケーション。
p2.director.profileディレクターによって作成された p2 プロファイルに使用する名前。 一般には、製品に関連した名前を付けることをお勧めします。 デフォルトは「profile」です。
p2.director.extraArgsディレクトリーに渡される追加の引数。 デフォルトは「-profileProperties org.eclipse.update.install.features=true」です。
ミラーリング・プロパティー製品またはフィーチャーをビルドする際、PDE/ビルドは、ビルドにインクルードするためにコンテキスト・リポジトリーの依存関係をミラーリングします。これらのプロパティーは、この操作にどの依存関係がインクルードされるかを制御します。詳しくは、p2.mirror Ant タスクを参照してください。
p2.mirror.rawデフォルト値は false です。true に設定すると、ソース・リポジトリーの成果物記述子が再利用されます。
p2.mirror.slicing.filterデフォルトは、フィルターなしです。インクルードされる IU が満たす必要がある追加のフィルター・プロパティーを設定してください。
p2.mirror.slicing.followOnlyFilteredRequirementsデフォルトは false です。 true に設定すると、フィルター操作を反転させ、一致しない IU だけをインクルードします。
p2.mirror.slicing.followStrictデフォルトは false です。 true に設定すると、バージョンが正確に指定された依存関係だけをインクルードします。
p2.mirror.slicing.includeFeaturesデフォルトは true です。 フィーチャーを含めるかどうか。
p2.mirror.slicing.includeNonGreedyデフォルトは false です。 最短一致依存関係をインクルードするかどうか。
p2.mirror.slicing.includeOptionalデフォルトは true です。オプションの依存関係をインクルードするかどうか。
p2.mirror.slicing.latestVersionOnlyデフォルトは false です。要件が範囲であり複数のバージョンが利用可能な場合に、依存関係の最新バージョンだけをインクルードするかどうか。
p2.mirror.slicing.platformFilterデフォルトはフィルターなしです。IU LDAP フィルターを突き合わせるプラットフォームとして設定する「os,ws,arch」のトリプレット。 このフィルターに一致しない IU は、ミラーリングされません。

製品のフレーバー

製品ビルドの一部として、PDE/ビルドは開始レベルと config.ini プロパティーを設定するデフォルトの構成メタデータを自動的に生成します。 このメタデータは一般に、構成単位 (CU) と呼ばれます。 特に、開始レベルは、開始されるバンドルの IU にある CU フラグメントを使用して設定されます。 フレーバーは、IU に基づいて CU の名前を生成する際の限定子として使用されます。

例えば、「p2.flavor = tooling」である場合、Windows で org.eclipse.core.runtime バンドルを構成する CU の名前は 'toolingwin32.win32.x86org.eclipse.core.runtime' となります。 他のメタデータとの競合を避けるため、特に開始レベルに関連した特定のニーズが製品に存在する場合は、製品 ID に基づくフレーバーを使用することをお勧めします。

製品の構成のページも参照してください。

ディレクターの呼び出し

PDE/ビルドには、製品ビルドの際にインストールを実行するために呼び出される runDirector ターゲットが含まれています。 現時点では、これは、ディレクター・アプリケーションを新しいプロセスに fork するものです。 より高度な releng シナリオでは、このタスクを再利用して追加インストールを行うことができます。 このタスクでは、ビルダー用の Equinox Launcher のロケーションが定義されている必要があります。 呼び出しは、以下のようになります。
	<property name="equinoxLauncherJar" value="/builder/eclipse/plugins/org.eclipse.equinox.launcher_1.0.200.v20090520.jar"/>
	<ant antfile="${eclipse.pdebuild.scripts}/genericTargets.xml" target="runDirector" inheritAll="true">
		<property name="ws" value="gtk"/>
		<property name="os" value="linux"/>
		<property name="arch" value="x86"/>
		<property name="p2.director.installPath" value="${installFolder}"/>
		<property name="p2.repo" value="${p2.build.repo}"/>
		<property name="p2.director.iu" value="my.rcp.product"/>
		<property name="p2.director.version" value="1.0.0"/>
	</ant>