ヘッドレス・ビルドのカスタマイズ

以下のように、ヘッドレス・ビルドをカスタマイズする方法はいくつかあります。

これらのファイルの内容の正確なフォーマットは、相互に依存します。したがって、customTargets、allElements、customAssembly のいずれかのカスタマイズ・スクリプトを使用する場合には、それらのファイルのテンプレートが、すべて、同じバージョンの PDE ビルドのものであることを確認することをお勧めします。新しいバージョンの PDE ビルドは、古いバージョンのこれらのカスタマイズ・スクリプトと後方互換性があります。

これらのスクリプトのテンプレートのバージョンは、templates/headless-build フォルダーの下の org.eclipse.pde.build プラグインで確認することができます。カスタマイズを使用するには、テンプレートをビルド構成ディレクトリーにコピーして、該当する箇所を編集するだけです。

customTargets.xml

customTargets.xml は、ビルド・プロセスのトップレベル・カスタマイズ用のスクリプトです。ビルドの主要フェーズ間で呼び出される Ant ターゲットを提供します。以下のそれぞれのビルド・ステップの前後で使用できるプリターゲットおよびポストターゲットがあります。

customTargets.xml スクリプトを使用するには、それを PDE ビルドのテンプレート・ディレクトリーからビルド構成ディレクトリーにコピーして、該当する箇所を編集するだけです。スクリプトが自動的に検出され、ヘッドレス・ビルドで使用されます。

また、customTargets.xml スクリプトを使用して、各ビルド・フェーズへの委譲を実現することもできます。

allElements.xml

allElements.xml スクリプトは、一種の委譲スクリプトであり、特定のエレメント (通常は、フィーチャー) のさまざまなビルド・ステップを実行するために使用されます。customTargets.xml と同様、これらのカスタマイズ・ステップを使用するには、テンプレートを PDE ビルドからビルド構成ディレクトリーにコピーします。Eclipse 3.4 では、ビルドされるターゲット・エレメントを、トップレベルのビルド構成ファイル build.properties で topLevelElementType プロパティーおよび topLevelElementId プロパティーを使用して指定することができます。elementType は feature に設定します。elementId は、ビルドするフィーチャーの ID に設定します。

 	<target name="allElementsDelegator">
 		<ant antfile="${genericTargets}" target="${target}">
	 		<property name="type" value="${topLevelElementType}" />
	 		<property name="id" value="${topLevelElementId}" />
 		</ant>
	</target>

また、allElements.xml は、ビルドのアセンブリーおよびパッケージ化のフェーズで使用されるターゲットも提供します。defaultAssemble ターゲットが、すべてのプラットフォームのアーカイブをアセンブルするために呼び出されます。必要な場合は、プラットフォームごとにカスタム・ターゲットを定義することができます。

特定のプラットフォームについてカスタム・ターゲットを使用するには、"assemble.<element-id>[.<config>] プロパティーと当該のターゲットを定義します。このプロパティーによって、デフォルト・ターゲットではなくこのカスタム・ターゲットを使用するよう、PDE ビルドに認識させます。その結果、このカスタム・ターゲットを使用して、アーカイブにカスタム名を付けたり、アーカイブでプリプロセッシングまたはポストプロセッシングを実行したりできるようになります。

例:

	<property name="assemble.org.foo.feature.id.linux.gtk.x86" value="true" />
 	<target name="assemble.org.foo.feature.id.linux.gtk.x86">
 		<property name="archiveName" value="acme-RCP-${buildId}-linux.gtk.x86.tar.gz" />
 		<-- custom pre assemble steps for linux.gtk.x86-->
 		<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
 		<-- custom post assemble steps for linux.gtk.x86-->
	</target>

customAssembly.xml

customAssembly.xml スクリプトは 3.4 で新たに導入されました。ビルドのアセンブリー・フェーズおよびパッケージ化フェーズで呼び出されるカスタマイズ・ポイントを提供します。customTargets.xml および allElements.xml と同様、これらのカスタマイズ・ポイントを使用するには、テンプレートを PDE ビルドからビルド構成ディレクトリーにコピーします。

PDE ビルドで生成されるアセンブル・スクリプトおよびパッケージ化スクリプトは、以下のアクションを実行します。

アセンブル・スクリプトでは、ビルド中にコンパイルされたフィーチャーおよびプラグインが収集されます。パッケージ化スクリプトでは、プリコンパイルされたバイナリーのフィーチャーおよびプラグインが収集されます。customAssembly.xml スクリプトは、上記のそれぞれのステップの前後で以下のターゲットを提供します。