フィーチャーのエクスポート

PDE は、「フィーチャーのエクスポート (Feature Export)」ウィザードで、フィーチャーとそれを構成するプラグインおよびフラグメントをデプロイメントに適した形式にエクスポートします。 このウィザードを使用すると、Ant スクリプトからのシールドが行われ、ビルド操作で生成されたリソースによってワークスペースが汚されることがありません。 ウィザードは、フィーチャーのエクスポート用ウィザードを開く「ファイル」>「エクスポート...」>「プラグイン開発」>「デプロイ可能なフィーチャー」と選択することによって使用できます。

フィーチャー選択

このウィザードでは、ワークスペースにある非バイナリーのフィーチャーがすべて表示されます。

フィーチャーの選択

エクスポートするフィーチャーを選択します。 同じフィーチャー・セットを繰り返しエクスポートする場合は、「ワーキング・セット...」を押してワーキング・セット を定義することができます。

フィーチャーは再帰的にビルドされるため、1 つのフィーチャーに別のフィーチャーが組み込まれている場合は、最上位のフィーチャーだけを選択すれば、どちらのフィーチャーもエクスポートされます。

宛先

フィーチャーとそれを構成するプラグインは、ディレクトリーにエクスポートすることも ZIP アーカイブにエクスポートすることもできます。 フィーチャーの実行可能なフォーマットでのエクスポートを選択して、現在実行中の Eclipse ホストにインストールすることもできます。

宛先

ディレクトリーへのエクスポート (デフォルト) を選択すると、フィーチャーは features/ サブディレクトリーに、プラグインは選択したディレクトリーの plugins/ サブディレクトリーに置かれます。

アーカイブ・ファイルへエクスポートする場合は、すべてのフィーチャーおよびプラグインが単一の ZIP アーカイブにパッケージ化されます。 また、ZIP 内部のルート・ディレクトリー構造は、features/ と plugins/ で始まります。

エクスポートおよびインストールを選択すると、フィーチャーは実行可能なフォーマットでエクスポートされ、p2 リポジトリーが生成されます。エクスポートが完了すると、インストール操作が実行されてフィーチャーがインストールされます。インストールが完了すると、Eclipse を再始動するようプロンプトが表示されます。「製品情報」ダイアログ (「ヘルプ」>「Eclipse SDK について」を選択すると表示される) の「インストール詳細」ボタンを使用すると、フィーチャーをアンインストールできます。詳しくは、「ホストに対するエクスポートおよびインストール」を参照してください。

オプション

オプション

「ソースのエクスポート (Export source)」オプションを選択すると、 バイナリーだけではなくソース・コードもエクスポートされます。 エクスポートされたフィーチャーでソースをパッケージする方法は、2 とおりあります。「生成されたソース・バンドル (Generated Source Bundles)」オプションを使用すると、エクスポートに Ant コマンドが追加され、エクスポートされた各プラグインに個別のソース・バンドルが作成されます。ソース・バンドルについて詳しくは、『個々のソース・バンドル』の PDE ビルドのエントリーを参照してください。もう 1 つのオプションは、エクスポートしたプラグインにソースを含める方法です。このオプションでは、JAR のルートにある src/ フォルダーにソース・ファイルがパッケージされます (JAR フォーマットでエクスポートしている場合)。プラグインがフラット・ディレクトリーとしてパッケージされると、 ソース・コードはプラグイン・ディレクトリー内のソース ZIP にライブラリー JAR の兄弟として格納されます。

「個々の JAR アーカイブとしてパッケージ」オプションは、フィーチャーとそれを構成するプラグインを JAR としてパッケージします。 このオプションを選択しなかった場合、フィーチャーはフラット・ディレクトリーとしてエクスポートされますが、それを構成するプラグインは、feature.xml マークアップで指定したようにパッケージされます。 feature.xml で unpack="false" のマークを付けたプラグイン・エントリーは JAR としてエクスポートされますが、そうでない場合はディレクトリーとしてエクスポートされます。

個別の JAR としてパッケージする場合には、2 つの追加のオプションを使用できます。「メタデータ・リポジトリーの生成」オプションを使用すると、エクスポートされるフィーチャーと共に p2 メタデータも生成できます。 これにより、エクスポート先のディレクトリーまたはアーカイブを、p2 のインストールおよび更新元となるリポジトリーとして使用できます。このオプションは、実行中のホストにエクスポートしてインストールするときはオンにする必要があります。「リポジトリーの分類」では、生成されたメタデータ・リポジトリーをカテゴリー別に編成できます。エクスポート中のフィーチャーのデータを含む有効なカテゴリーの XML ファイルは、カテゴリーが正常に作成されるように指定する必要があります。

「限定子の置換」オプションによって、プラグインのバージョンまたはフィーチャーのバージョンの限定子要素の値を置換できます。バージョンは、形式 <major>.<minor>.<micro>.qualifier でなければなりません。例えば、3.3.0.qualifier です。通常は、限定子はビルドの日付または ID を表します。

「Ant スクリプトとして保存」オプションを選択すると、エクスポートを後で再実行する際に再度ウィザードを利用しなくてもよいように、エクスポート操作の設定を保存することができます。 エクスポート操作と同様に、Ant タスクは非同期ジョブとして実行されます。 したがって、Ant タスクをより大きな Ant スクリプトの一部として組み込むことは適切ではありません。

「ターゲット・プラットフォームでバイナリー・サイクルを許可 (Allow binary cycles in target platform)」は、エクスポート操作でプラグインの依存関係グラフのサイクルがどのように処理されるかを制御するオプションです。PDE ビルドは、サイクルが検出された場合はコンパイルできません。ただし、サイクルにターゲット・プラットフォームからのバイナリー・プラグインのみが含まれる場合、このオプションをオンにすると、PDE ビルドを続行できます。

「ワークスペースでコンパイルされたクラス・ファイルを使用」オプションをオンにすると、ファイルをエクスポート操作の一部としてコンパイルするのではなく、Eclipse によってコンパイルされたワークスペースのバイナリー・ファイルが使用されます。これによりコンパイル・フェーズがスキップされるためパフォーマンスが改善されますが、ワークスペースを正常にコンパイルしておく必要があります。

JAR 署名

「JAR 署名」タブは、「オプション」タブで「個々の JAR アーカイブとしてパッケージ」オプションを選択した場合にのみ表示されます。

JAR 署名

JAR に署名するには、JRE のみでなく、完全な JDK を備えた Eclipse を実行している必要があります。

「鍵ストアのロケーション」、「鍵パス」、「別名」および「パスワード」は、いずれも署名操作に必要なフィールドです。

Java Web Start

「Java Web Start」タブは、「宛先」タブで「ディレクトリー」オプションを選択し、「オプション」タブで「個々の JAR アーカイブとしてパッケージ」オプションを選択した場合にのみ、選択できます。

Java Web Start

「サイト URL」フィールドと「JRE バージョン」フィールドはどちらも必須です。

関連リファレンス

エクスポート・ウィザード
プラグインのエクスポート・ウィザード

関連タスク

実行中のホストに対するエクスポートおよびインストール