既存の JAR アーカイブのプラグイン

「既存の JAR アーカイブのプラグイン」ウィザードは、トップレベル・メニューの 「ライブラリー・プラグイン・プロジェクト (Library Plug-in Project)」ウィザードを開く「ファイル」>「新規」>「プロジェクト...」>「プラグイン開発」>「既存の JAR アーカイブのプラグイン」から使用できます。

既存の JAR アーカイブのプラグイン・プロジェクトの作成は、以下の 2 段階のプロセスで行われます。

  1. JAR アーカイブの選択
  2. プラグインのプロパティーの指定

JAR の選択

「JAR の選択」ウィザード・ページは、プラグインに組み込まれる JAR アーカイブをリストします。

JAR の選択

「追加...」ボタンは、JAR アーカイブのワークスペースを参照できるようにするダイアログを開きます。

「外部ファイルの追加...」ボタンは、JAR アーカイブのファイル・システムを参照できるようにするファイル・ダイアログを開きます。

プラグインのプロパティー

「プラグインのプロパティー」ウィザード・ページを使用すると、プラグイン・プロジェクト設定、プラグインのプロパティーおよびターゲット・プラットフォームを指定できます。

プラグイン・コンテンツ

「プロジェクト名」に対しては、逆方向のドメイン命名規則 (com.example.bundle など) を使用することが推奨されています。

「ロケーション」フィールドは、ワークスペース・ロケーションの内側にネストされたサブディレクトリーをデフォルトのプロジェクトのロケーションとして指定します。 プロジェクトのロケーションは、「デフォルト・ロケーションの使用」チェック・ボックスのチェックを外し、任意のロケーションを入力することで、任意の書き込み可能なロケーションに変更できます。

「プラグイン ID」は必須であり、plugin.dtd に準拠する必要があります。 プラグイン ID がプロジェクト名と一致することが推奨されていますが、必須ではありません。

「プラグイン・バージョン」は必須であり、major.minor.service (1.3.0 など) という形式である必要があります。

「プラグイン名」は、プラグインの翻訳可能なプレゼンテーション名です。 このフィールドは必須です。

「プラグイン・ベンダー (Plug-in Vendor)」は、プラグイン・ベンダーの翻訳可能な名前です。このフィールドはオプションです。

オプションで PDE を使用することにより、ライブラリー・コンテンツの分析および依存関係の追加が可能になります。PDE は、「JAR の選択」ページに指定されたライブラリーのコンテンツを分析し、プラグイン・プロジェクトに必要な依存関係を検索します。これらの依存関係は自動的にマニフェストに追加されます。

ターゲット・プラットフォーム

ターゲット・プラットフォーム・オプションは、新規プラグイン・プロジェクトの作成時に表示されるマニフェスト・エディターのページを決定する事前フィルターとして意図されています。

例えば、「拡張」ページと「拡張ポイント」ページは、「Eclipse バージョン」オプションが選択されると表示され、「OSGi フレームワーク」が選択されると非表示になります。

また、マニフェスト・エディターの「ランタイム」ページの「パッケージの可視性」セクションは、標準 OSGi フレームワーク・オプションが選択されると非表示になります。これは、このセクションが Equinox 固有のツールを提供するためです。

JAR の解凍

JAR を ZIP 形式で圧縮または解凍する必要があるかどうかは、プラグインのパッケージ方法によって異なります。 プラグインが単一の JAR として出荷される (Eclipse 3.1 で推奨される形式です) 場合、個々の JAR アーカイブを解凍する必要があります。 プラグインがフラット・ディレクトリーとして出荷される場合は、個々の JAR アーカイブはそのままにする必要があります。