PDE ビルドの p2 パブリッシャーに対する拡張

PDE ビルドは、p2 パブリッシャーを拡張するいくつかの Ant タスクをコントリビュートします。PDE ビルドは、これらのタスクを使用して、メタデータおよび成果物を直接 p2 リポジトリーに公開できます。

生成されるビルド・スクリプトは、クラス・ファイルのコンパイルやバージョンの置換などが行われるフルビルドの際にこれらのタスクを使用します。 ただし、一部のタスクは、特殊なケースでフルビルドを実行せずにメタデータを直接公開するのに役立つ可能性があります。

eclipse.publish.featuresAndBundles

このタスクは、p2 パブリッシャーがコントリビュートする p2.publish.featuresAndBundles タスクと非常によく似ています。このタスクは、ソースからビルドされたものではない、従来のバイナリー・フィーチャーおよびプラグインのメタデータを公開します。このタスクはまた、提供される site.xml ファイルまたは category.xml ファイルに基づいて、カテゴリーを公開します。

このタスクでは、以下の属性がサポートされます。

metadataRepository 公開先のメタデータ・リポジトリーを指定する URI。
artifactRepository 公開先の成果物リポジトリーを指定する URI。
repository metadataRepository と artifactRepository の両方を設定します。
site カテゴリー情報を指定する site.xml の URL。
category カテゴリー情報を指定する category.xml の URL。
siteQualifier 結果として生じるカテゴリー IU を確実に固有の名前にするために使用する限定子。
<features> 公開するバイナリー・フィーチャーのロケーションを指定する、ネストされたファイル・セット要素。
<bundles> 公開するバイナリー・プラグインのロケーションを指定する、ネストされたファイル・セット要素。
例:
 <eclipse.publish.featuresAndBundles repository="file:C:/build/repository" category="file:C:/build/category.xml" >
     <features dir="C:¥eclipse¥features¥" includes="org.eclipse.cvs_1.1.100.v20090514-7E79FEc9BJ99r9XGQ3CICF" />
     <bundles dir="C:¥eclipse¥plugins" includes="org.eclipse.cvs_1.0.300.v20090520.jar" />
     <bundles dir="C:¥eclipse¥plugins" includes="org.eclipse.team.cvs.core_3.3.200.I20090430-0408.jar" />
     <bundles dir="C:¥eclipse¥plugins" includes="org.eclipse.team.cvs.ssh_3.2.100.I20090508-2000.jar" />

     <bundles dir="C:¥eclipse¥plugins" includes="org.eclipse.team.cvs.ssh2_3.2.200.I20090508-2000.jar" />
     <bundles dir="C:¥eclipse¥plugins" includes="org.eclipse.team.cvs.ui_3.3.200.I20090521-1750.jar" />
 </eclipse.publish.featuresAndBundles>

eclipse.gatherBundle

ソースから直接プラグインを公開します。バンドルの .class ファイルが一度コンパイルされると、このタスクはバイナリーの結果を構成するすべてのファイルを収集し、それらをメタデータによる p2 成果物として公開します。このタスクは、プラグインの生成済み build.xml 内の publish.bin.parts タスクで使用され、p2 パブリッシャーによるビルド時にはこのタスクが gather.bin.parts タスクを置き換えます。

このタスクでは、以下の属性がサポートされます。

metadataRepository 公開先のメタデータ・リポジトリーの URI。
artifactRepository 公開先の成果物リポジトリーの URI。
buildResultFolder ビルドの .class ファイル、マニフェスト、および潜在 .api_description ファイルを収容するフォルダー。
targetFolder customBuildCallbacks で実行している場合のコンテンツ。
baseDirectory customBuildCallbacks を使用していない場合の、コンテンツ収集先プロジェクトのロケーション。
unpack インストール時に、プラグインをフォルダー形式でアンパックするかどうか。
gatheredSource ソース・バンドル用の、ソース収集先ロケーション。
<outputFolder> .class ファイル入手先の代替ロケーションを指定するネストされた要素。ワークスペースから .class ファイルを再利用する場合に使用します。これは、クラス・ファイルの属するライブラリーを指定する追加の "library" 属性を持つ Ant FileSet です。
例:
 <eclipse.gatherBundle metadataRepository="file:/build/repo" artifactRepository="file:/build/repo"
                       buildResultFolder="${basedir}" baseDirectory="${basedir}" unpack="true" >
     <outputFolder library="lib/pdebuild-ant.jar" dir="${basedir}" includes="bin_ant/**" />

     <outputFolder library="pdebuild.jar" dir="${basedir}" includes="bin/**" />
 </eclipse.gatherBundle>

eclipse.gatherFeature

ソースから直接フィーチャーを公開します。このタスクは、フィーチャーの jar を構成するすべてのファイルを収集し、それらをメタデータによる p2 成果物として公開します。このタスクはまた、このフィーチャーがコントリビュートするいずれかのルート・ファイルを含んでいる成果物も公開します。bin.includes プロパティーを指定しないフィーチャーの場合、フィーチャー jar は生成されませんが、ルート・ファイル成果物とフィーチャー・グループ・メタデータは存在します。

このタスクでは、以下の属性がサポートされます。

metadataRepository 公開先のメタデータ・リポジトリーの URI。
artifactRepository 公開先の成果物リポジトリーの URI。
buildResultFolder 置換されたバージョンにより変更された feature.xml を収容するフォルダー。
targetFolder customBuildCallbacks で実行している場合のコンテンツ。
baseDirectory フィーチャー・プロジェクトのロケーション
例:
 <eclipse.gatherFeature
     metadataRepository="file:/build/repo"
     artifactRepository="file:/build/repo"
     buildResultFolder="${basedir}"
     baseDirectory="${basedir}"
 />


eclipse.brand.p2.artifacts

製品のブランド・ランチャー成果物。これらを指定の製品に組み込むため新しい名前で再公開します。

このタスクでは、以下の属性がサポートされます。

metadataRepository 公開先のメタデータ・リポジトリーの URI。
artifactRepository 公開先の成果物リポジトリーの URI。
config ランチャーを使用する構成。(例 "gtk.linux.x86")
iconsList 実行可能プログラムにブランド付けするアイコンの検索ロケーション。
tempDirectory 使用可能な一時ディレクトリーのロケーション。
productId 公開する製品の ID。
productVersion 公開する製品のバージョン。
launcherName 新規ランチャーに指定する名前。
launcherProvider オリジナルのランチャー成果物を提供する IU の名前。デフォルトでは「org.eclipse.equinox.executable」になり、タスクは <launcherProvider>_root.<config> という名前の成果物を検索します。