PDE ビルドが提供するインフラストラクチャーには、ビルド・プロセスの一部として、リポジトリーから作成するソース・コードおよび事前ビルドされたプラグインを取り出すためのステップが用意されています (eclipse.fetch タスクおよび取り出しを制御するプロパティーを参照してください)。 次の 2 つの方法が使用できます。すなわち、PDE ビルドが自動的にソースを取り出すようにする方法と、 ソース・コードを手動で取り出す方法です。
ビルドが必要なフィーチャーまたはプラグインの ID の場合、ビルド・インフラストラクチャーは、 組み込まれたすべてのフィーチャーおよびプラグインをリポジトリーから取り出すことができます。
どこから取得するかを知るために、PDE はマップ・ファイルを使用します。 マップ・ファイルは Java プロパティー・ファイルで、フィーチャーおよびプラグインの ID を リポジトリー内のロケーションとタグにマップします。 マップ・ファイルのフォーマットはオープンですが、key 部分は PDE ビルドによって固定されます。
<elementType>@<elementID>[,<elementVersion>] = <repo specific content>
ここで、elementType は、bundle、feature、 plugin または fragment のいずれかです。また、elementId および elementVersion は要素の特性を示します。
<key> = CVS, [,args]
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true
| 旧スタイルのマップ・エントリー |
Eclipse 3.2 以前の CVS のマップ・ファイル・フォーマットは次のようなものでした。
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]] |
Ant GET がサポートする任意の URL からコンテンツを取り出すマップ・ファイル・エントリーの形式は、次のとおりです。
<key> = GET, <url> [,args]
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true
PDE/ビルドに新規拡張が追加されて、p2 リポジトリーから成果物を取り出せるようになりました。ビルド入力用のマップ・ファイルに項目を追加すると、PDE/ビルドが成果物を取り出して、ビルドに組み込みます。 マップ・ファイルの項目には、ID およびインストール可能単位 (IU) のバージョン、および IU の検索先リポジトリーの URI を含める必要があります。メタデータと成果物のリポジトリーは、同一場所に配置されていると想定されます。
p2 を介してコンテンツを取り出す際のマップ・ファイル・エントリーの形式は、次のとおりです。
<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
Helios リリースでは、フィーチャー jar を表わすインストール可能ユニットを指定することにより、p2 でフィーチャーを取り出せます。フィーチャーの p2 メタデータの構造の詳細については、フィーチャー・メタデータのページを参照してください。
例:plugin@my.bundle.id,1.0.0=p2IU,id=my.bundle.id,version=1.0.0,repository=http://example.eclipse.org/repo feature@my.feature.id = p2IU,id=my.feature.id.feature.jar, version=1.0.0,repository=http://example.eclipse.org/repo
PDE ビルドは、さまざまなリポジトリーの取り出しスクリプト生成プログラムをプラグインすることができる拡張ポイントを提供します。Eclipse のインストールに、 異なるタイプのリポジトリー用のスクリプト生成プログラム拡張を提供する バンドルが含まれている場合は、マップ・ファイル・エントリーでそのリポジトリーを指定し、拡張プロバイダーによって指定された形式に準拠することにより、それを使用することができます。
リポジトリーからマップ・ファイルを 自動的に取り出す場合は、customTarget.xml ファイルを、 org.eclipse.pde.build/templates/headless-build から configuration ディレクトリーにコピーする必要があります。 ターゲット getMapFiles はマップ・ファイルの取り出しに 使用されます。これを、リポジトリーから取り出すように変更してください。