フィーチャーおよびプラグインのカスタム・ビルドの手順

3.2 には、カスタム Ant ターゲットをそれ自体のビルドに提供するフィーチャーまたはプラグインのための新しい機能があります。   これらのカスタム・ステップは、コンパイル後のバイトコードの計測、文書のヘルプ・ファイルの索引付け、または追加ファイルのバンドルへのコピーなどに使用することができます。  

カスタム・ターゲットを使用するには、フィーチャーまたはプラグインが build.properties ファイルでプロパティー customBuildCallbacks を定義する必要があります。このプロパティーの値は、フィーチャー/プラグインのルートに対して相対的な、カスタム・ターゲットが含まれている xml ファイルのロケーションです。 xml ファイルが他のロケーションにある場合、プロパティー customBuildCallbacks.buildpath を使用して、使用するディレクトリーを設定します。

サポートされるカスタム・ターゲットが含まれている customBuildCallbacks.xml という名のテンプレートが、org.eclipse.pde.build/templates/plugins と  org.eclipse.pde.build/templates/features に提供されています。 これらのテンプレートをフィーチャー/プラグインにコピーして、必要に応じて変更することができます。

カスタム・ターゲットは subant タスクを使用して起動されます。デフォルトでは、failonerror が false に設定されています。これを変更するには、 プロパティー customBuildCallbacks.failonerror を true に設定します。同様に、inheritall パラメーターのデフォルトも false に設定されています。これを変更するには、プロパティー customBuildCallbacks.inheritall を設定します。

プラグイン

特定のタスクを実行する複数のターゲットを含む、プラグインをビルドする生成済み build.xml。   PDE ビルドにより、プラグインは、特定のタスクの前後に呼び出されるカスタムのプリターゲットおよびポストターゲットを提供できます。   また、既に定義された Ant プロパティーに加えて、それぞれのカスタム・ターゲットがいくつかの特定のプロパティーに渡される場合があります。   以下のターゲットはカスタム・コールバックをサポートします。

フィーチャー

フィーチャーの生成済み build.xml は、gather.bin.parts ターゲットのカスタム・ビルド・コールバックのみをサポートします。   このターゲットは、すべての組み込まれたフィーチャーおよびプラグインの gather.bin.parts ターゲットを呼び出します。  これは、pre.gather.bin.parts および post.gather.bin.parts をサポートします。 これらの両方のターゲットには、以下のプロパティーが備わっています。