PDE ビルドは、フィーチャーのビルドを自動化するインフラストラクチャーを備えています。 このようなビルドに必要な セットアップの大半は、PDE ビルドによって用意されているテンプレート build.properties にいくつか変更を加えることで実行できます。 以下のセクションでは、ビルドされているフィーチャーから参照されるすべてのプラグインおよびフィーチャー (to-build および pre-built の両方) がディスクにおいて既にローカルに使用可能であると仮定して、単純なビルドのセットアップに焦点を当てて説明します。
ビルドのセットアップの最初のステップは、ビルド構成ディレクトリーを作成することです。これは、ヘッドレス・ビルドの制御およびカスタマイズに使用されるファイルを保存するディレクトリーです。
ビルドの制御のためのメインファイルは、トップレベルのビルド構成ファイル build.properties です。新規ビルドをセットアップする場合には、そのビルドの実行に使用する Eclipse インストールの org.eclipse.pde.build バンドルからテンプレート・ファイルをコピーします。テンプレート・ファイルは、org.eclipse.pde.build/templates/headless-build/build.properties 以下にあります。
このディレクトリーは builder プロパティーの参照先になります。このプロパティーは、通常は、Ant コマンド行で設定されます。
buildDirectory プロパティーは、PDE ビルドがスクリプトを生成したり、実際のビルドの実行したりする場所となるディレクトリーを指定します。ビルドされるプラグインおよびフィーチャーは、それぞれ、${buildDirectory}/plugins サブディレクトリーと ${buildDirectory}/features サブディレクトリーに配置する必要があります。 バンドルおよびフィーチャーがリポジトリーから取り出される場合 (リポジトリーからの取り出しを参照) にも、同様に配置されます。
このディレクトリーは、ビルド構成ディレクトリーと同じディレクトリーであっても、別のディレクトリーであってもかまいません。ただし、ビルド構成を CVS 形式で保持し、生成されたビルド成果物の影響を受けないようにしたい場合には、別のディレクトリーを使用することをお勧めします。
基本フィーチャー・ビルドをセットアップするには、ビルド構成ファイル build.properties を編集して以下のプロパティーを設定する必要があります。
以前のバージョンの PDE ビルドでは allElements.xml ファイルも必要でしたが、このファイルは 3.4 では不要になりました。allElements.xml はまだ使用できますが、このファイルが必要になるのはビルドの特定の局面をカスタマイズする場合だけです。ヘッドレス・ビルドのカスタマイズを参照してください。
ビルドを実行するには、org.elipse.ant.core.antRunner アプリケーションを使用します。 このアプリケ ーションで Eclipse を呼び出してビルドを実行する場合、コマンド行で次の 2 つの引数を設定する必要があります。
-buildfile=</path/to/build.xml>: これは PDE ビルドによって提供される build.xml へのパスです。
これは、org.eclipse.pde.build/scripts ディレクトリーに配置されています。 これは、ビルド・プロセス全体を駆動するビルド・スクリプトです。-Dbuilder=</path/to/configuration folder>:
ビルド構成フォルダーへのパスです。以下のコマンドを使用して antRunner アプリケーションを実行します。
java -jar
<eclipseInstall>/plugins/org.eclipse.equinox.launcher_<version>.jar
-application org.eclipse.ant.core.antRunner -buildfile
<<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/build.xml>
-Dbuilder=<path to the build configuration folder>ビルドが完了すると、I.TestBuild と名付けられたフォルダーのビルド・ディレクトリーで結果を取得できます (buildLabel プロパティーを設定して、この名前を構成できます)。
リポジトリーからの取り出しなど、ビルドのカスタマイズが更に必要な場合、詳しくは、『拡張 PDE ビルドのトピック』を参照してください。