これまで、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-Name、 Bundle-SymbolicName (プラグイン ID)、 Bundle-Version、および Bundle-Vendor が含まれています。これらのパラメーターのほとんどは、以前の章の hello world プラグインで見たとおりです。 README ツールは、特殊プラグイン・クラス ReadmePlugin も定義します。
JAR ファイルの名前も提供されます。 Bundle-ClassPath に指定されたファイル名は、プラグインのディレクトリーに対して相対的なファイル名です。このため、README ツールの JAR ファイルは、プラグイン・ディレクトリーに直接配置する必要があります。
Require-Bundle 要素は、プラットフォームに README ツールの依存関係を通知します。ワークベンチ UI プラグインは、各種コア、JFace、およびテキスト・プラグインとともに必須プラグインとしてリストされます。
ReadmePlugin クラスは、README ツール・プラグインを表示し、プラグインのライフ・サイクルを管理します。 Hello World の例で見たように、プラグイン・クラスを指定しなくても構いません。 プラットフォームが、そのクラスを 1 つ用意します。 この場合、プラグインは、開始時に UI 関連データを初期化する必要があります。 プラットフォーム・クラス AbstractUIPlugin は、 UI リソースを管理する構造を提供し、ReadmePlugin によって拡張されます。
AbstractUIPlugin は、プラグインの存続時間中に、イメージ、ダイアログ設定、および設定ストアを管理するために、一般的な始動および終了のメソッドを使用します。 ダイアログおよび設定を扱うときに、 ReadmePlugin クラスの詳細について説明します。