リポジトリーからの取り出し

PDE ビルドが提供するインフラストラクチャーには、ビルド・プロセスの一部として、リポジトリーから作成するソース・コードおよび事前ビルドされたプラグインを取り出すためのステップが用意されています (eclipse.fetch タスクおよび取り出しを制御するプロパティーを参照してください)。 次の 2 つの方法が使用できます。すなわち、PDE ビルドが自動的にソースを取り出すようにする方法と、 ソース・コードを手動で取り出す方法です。

自動化への最初のステップ、マップ・ファイル

ビルドが必要なフィーチャーまたはプラグインの ID の場合、ビルド・インフラストラクチャーは、 組み込まれたすべてのフィーチャーおよびプラグインをリポジトリーから取り出すことができます。

どこから取得するかを知るために、PDE はマップ・ファイルを使用します。 マップ・ファイルは Java プロパティー・ファイルで、フィーチャーおよびプラグインの ID を リポジトリー内のロケーションとタグにマップします。 マップ・ファイルのフォーマットはオープンですが、key 部分は PDE ビルドによって固定されます。

<elementType>@<elementID>[,<elementVersion>] = <repo specific content>

ここで、elementType は、bundle、feature、 plugin または fragment のいずれかです。また、elementId および elementVersion は要素の特性を示します。

CVS 用のマップ・ファイル・エントリー

CVS からコンテンツを取り出す際のマップ・ファイル・エントリーの形式は、次のとおりです。
<key> = CVS, [,args]
ここで、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 用のマップ・ファイル・エントリー

Ant GET がサポートする任意の URL からコンテンツを取り出すマップ・ファイル・エントリーの形式は、次のとおりです。

<key> = GET, <url> [,args]
ここで、url はデータの取得先となる 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

p2 取り出し用のマップ・ファイル・エントリー

PDE/ビルドに新規拡張が追加されて、p2 リポジトリーから成果物を取り出せるようになりました。ビルド入力用のマップ・ファイルに項目を追加すると、PDE/ビルドが成果物を取り出して、ビルドに組み込みます。 マップ・ファイルの項目には、ID およびインストール可能単位 (IU) のバージョン、および IU の検索先リポジトリーの URI を含める必要があります。メタデータと成果物のリポジトリーは、同一場所に配置されていると想定されます。

p2 を介してコンテンツを取り出す際のマップ・ファイル・エントリーの形式は、次のとおりです。

<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
p2 の取り出しフィーチャー

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 のインストールに、 異なるタイプのリポジトリー用のスクリプト生成プログラム拡張を提供する バンドルが含まれている場合は、マップ・ファイル・エントリーでそのリポジトリーを指定し、拡張プロバイダーによって指定された形式に準拠することにより、それを使用することができます。

CVS ソース取り出しのセットアップ

CVS からのソースの取り出しをセットアップするには、以下の手順に従います。

マップ・ファイルの CVS からの取得

マップ・ファイルは通常はリポジトリーに保管されます。 PDE ビルドのデフォルト・インフラストラクチャーでは、CVS リポジトリーからマップ・ファイルを取得します。 この機能を使用可能にするには、configuration ディレクトリーの構成の build.properties で、 以下のプロパティーを変更します。 マップ・ファイルの CVS からの取り出しは、ビルドの事前ビルド・フェーズで行われます。  ビルドするフィーチャーと、 そのフィーチャーに含まれるプラグインをすべて取り出すためのスクリプトは、 ビルドの取り出しフェーズ中に生成され、実行されます。  

その他のリポジトリーからの自動取り出し

 リポジトリーからマップ・ファイルを 自動的に取り出す場合は、customTarget.xml ファイルを、 org.eclipse.pde.build/templates/headless-build から configuration ディレクトリーにコピーする必要があります。  ターゲット getMapFiles はマップ・ファイルの取り出しに 使用されます。これを、リポジトリーから取り出すように変更してください。

ソース・コードの手動取得

カスタムの取り出しターゲットを作成して、 customTargets.xml ファイルの preSetup または postSetup ターゲットから 呼び出せるプラグインとフィーチャーを取得することができます。   フィーチャーとプラグインは、 それぞれ ${buildDirectory}/features と ${buildDirectory}/plugins に 取り出されます。