プラグイン・クラス

これまで、README ツールによって提供されるさまざまな拡張を見てきました。ここでは、README ツール・プラグインの一般的な定義について説明します。

プラグイン定義

README ツール・プラグインは、MANIFEST.MF ファイルに定義されています。

Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: %Plugin.name
Bundle-SymbolicName: org.eclipse.ui.examples.readmetool; singleton:=true
Bundle-Version: 3.2.0.qualifier
Bundle-ClassPath: readmetool.jar
Bundle-Activator: org.eclipse.ui.examples.readmetool.ReadmePlugin
Bundle-Vendor: %Plugin.providerName
Bundle-Localization: plugin
Require-Bundle: org.eclipse.ui、
 org.eclipse.core.resources、
 org.eclipse.core.runtime、
 org.eclipse.ui.views、
 org.eclipse.ui.ide、
 org.eclipse.jface.text、
 org.eclipse.text、
 org.eclipse.ui.workbench.texteditor、
org.eclipse.ui.editorsEclipse-AutoStart: true
Eclipse-AutoStart-comment: Use Eclipse-AutoStart instead of Eclipse-LazyStart because the readme example should run against 3.1 as well as 3.2.

プラグイン定義には、プラグインの Bundle-NameBundle-SymbolicName (プラグイン ID)、 Bundle-Version、および Bundle-Vendor が含まれています。これらのパラメーターのほとんどは、以前の章の hello world プラグインで見たとおりです。 README ツールは、特殊プラグイン・クラス ReadmePlugin も定義します。

JAR ファイルの名前も提供されます。 Bundle-ClassPath に指定されたファイル名は、プラグインのディレクトリーに対して相対的なファイル名です。このため、README ツールの JAR ファイルは、プラグイン・ディレクトリーに直接配置する必要があります。

Require-Bundle 要素は、プラットフォームに README ツールの依存関係を通知します。ワークベンチ UI プラグインは、各種コア、JFace、およびテキスト・プラグインとともに必須プラグインとしてリストされます。

AbstractUIPlugin

ReadmePlugin クラスは、README ツール・プラグインを表示し、プラグインのライフ・サイクルを管理します。 Hello World の例で見たように、プラグイン・クラスを指定しなくても構いません。 プラットフォームが、そのクラスを 1 つ用意します。  この場合、プラグインは、開始時に UI 関連データを初期化する必要があります。  プラットフォーム・クラス AbstractUIPlugin は、 UI リソースを管理する構造を提供し、ReadmePlugin によって拡張されます。

AbstractUIPlugin は、プラグインの存続時間中に、イメージ、ダイアログ設定、および設定ストアを管理するために、一般的な始動および終了のメソッドを使用します。  ダイアログおよび設定を扱うときに、 ReadmePlugin クラスの詳細について説明します。