Bislang wurden die unterschiedlichen Erweiterungen beschrieben, die durch das Tool für Readme-Dateien bereitgestellt werden. An dieser Stellen soll nun die allgemeine Definition des Plug-ins für das Tool für Readme-Dateien untersucht werden.
Das Plug-in des Tools für Readme-Dateien ist in der Datei MANIFEST.MF definiert.
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.editors Eclipse-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.
Die Plug-in-Definition enthält die Elemente Bundle-Name (Name des Produktpakets), Bundle-SymbolicName (symbolischer Name des Produktpakets, also Plug-in-ID), Bundle-Version (Version des Produktpakets) und Bundle-Vendor (Hersteller des Produktpakets) für das Plug-in. Diese Parameter kennen Sie bereits aus dem Plug-in "Hello World". Das Tool für Readme-Dateien definiert außerdem eine spezielle Plug-in-Klasse namens ReadmePlugin.
Der Name der JAR-Datei ist auch angegeben. Dateinamen, die in einem Element Bundle-ClassPath angegeben sind, beziehen sich auf das Verzeichnis des Plug-ins. Daher sollte sich die JAR-Datei des Tools für Readme-Dateien direkt im Verzeichnis des Plug-ins befinden.
Das Element Require-Bundle informiert die Plattform über Abhängigkeiten des Tools für Readme-Dateien. Die Plug-ins der Workbench-Benutzerschnittstelle werden als erforderliche Plug-ins aufgelistet, zusammen mit den diversen Kern-, JFace- und Text-Plug-ins.
Die Klasse ReadmePlugin stellt das Plug-in für das Tool für Readme-Dateien dar und verwaltet den Lebenszyklus des Plug-ins. Wie im Beispiel von "Hello World" bereits dargestellt, muss keine Plug-in-Klasse angegeben werden. Diese wird von der Plattform bereitgestellt. In diesem Fall muss das Plug-in beim Start Daten initialisieren, die sich auf die Benutzerschnittstelle beziehen. Die Plattformklasse AbstractUIPlugin liefert eine Struktur, über die Benutzerschnittstellenressourcen verwaltet werden können, und die durch ReadmePlugin erweitert wird.
AbstractUIPlugin verwendet die generischen Start- und Beendigungsmethoden, um die Images, die Dialogeinstellungen und einen Benutzervorgabenspeicher während der Lebensdauer des Plug-ins zu verwalten. Im Folgenden sollen die spezifischen Aspekte der Klasse ReadmePlugin beim Arbeiten mit Dialogen und Benutzervorgaben verdeutlicht werden.