Ein Produkt anpassen

Das Plug-in, dem eine Hauptkomponente zugeordnet ist, ist die Stelle, in der sich das Branding (Markenkennzeichnung) für ein Produkt befinden.   Viele Aspekte eines Produkts können angepasst werden.  Anpassungen auf Produktebene werden mit Hilfe der Datei about.ini und anderen hierin beschriebenen Dateien definiert.   Produkte können außerdem die Standardwerte für Benutzervorgaben von anderen Plug-ins steuern.  Dies erfolgt über die Datei plugin_customization.ini.

Unter Bezugnahme auf das Hauptkomponenten-Plug-in des bereits vorgestellten Beispielprodukts soll an dieser Stelle die Anpassung des Produkts genauer untersucht werden.

com.example.acme.acmefeature_1.0.0/
		plugin.xml
		about.ini
		about.html
		about.mappings
		about.properties
		acme.gif
		plugin_customization.ini
		plugin_customization.properties
		splash.bmp
		welcome.xml

Dialoge "Info über"

Der Plattformdialg Info über wird immer dann aufgerufen, wenn der Benutzer im Workbenchmenü die Optionen Hilfe > Info auswählt.  

Im Dialog "Info über" werden Informationen kombiniert, die durch Komponenten und Plug-ins zur Verfügung gestellt werden.   Alle Komponenten und Plug-ins sollten eine Datei about.html ergänzen, die Informationen zu diesem bestimmten Plug-in enthält.  Diese Informationen werden angezeigt, wenn der Benutzer Details zur Komponente bzw. zum Plug-in anfordert und eine bestimmte Komponente/ein bestimmtes Plug-in auswählt.

Die Hauptkomponente liefert außerdem die Informationen und Grafikobjekte für das Gesamtprodukt.   Zur Angabe dieser Informationen werden zusätzliche Dateien eingesetzt.

Fensterimages

Mit einem Farbimage im Format 16x16 Pixel können durch das Produkt erstellte Fenster mit einem Branding (Markenkennzeichnung) versehen werden.   Das Image wird in der linken oberen Ecke von Produktfenstern angezeigt.   Es wird im Attribut windowImage der Datei about.ini definiert.   Der Pfad sollte als relativer Pfad angegeben werden, der sich auf das Plug-in bezieht.  Für die oben dargestellte Verzeichnisstruktur wäre beispielsweise die folgende Pfadangabe korrekt:

windowImage=acme.gif

Startseite

Die Beschreibung für die Startseite eines Produkts ("Willkommen" o. ä.) sollte in einer XML-Datei in dem Format definiert werden, das unter Plattformkonfiguration für Startseite beschrieben ist.  Sie wird im Attribut welcomePage der Datei about.ini angegeben. Der Pfad sollte als relativer Pfad angegeben werden, der sich auf das Plug-in bezieht.  Für die oben dargestellte Verzeichnisstruktur wäre beispielsweise die folgende Pfadangabe korrekt:

welcomePage=welcome.xml

Sie können auch eine Landessprachensuche für die Datei angeben.   (Näheres können Sie im Abschnitt Spezifische Dateien für Ländereinstellungen nachlesen.)

welcomePage=$nl$/welcome.xml

Eingangsanzeigen

Die Eingangsanzeige eines Produkts wird in einer Datei splash.bmp bereitgestellt, die sich im Verzeichnis des Hauptkomponenten-Plugs-in befindet.   Das Image sollte im 24-Bit-BMP-Farbformat (RGB-Format) vorliegen und ca. 500 x 330 Pixel groß sein.   Wenn Eingangsanzeigen für unterschiedliche Ländereinstellungen angepasst werden müssen, können sie in ein Fragment des Plug-ins für die Hauptkomponente gestellt werden.

Standardwerte für Benutzervorgaben

Mit der Datei plugin_customization.ini werden die Standardwerte für Benutervorgaben festgelegt, die durch andere Plug-ins definiert sind.   Diese Datei ist eine Formatdatei des Typs java.io.Properties. Normalerweise werden in dieser Datei Werte für Benutzervorgaben definiert, die als Teil der öffentlichen API eines Plug-ins publiziert werden.   Dies bedeutet als, dass es riskant ist, auf Benutzervorgaben zu verweisen, die durch Plug-ins verwendet werden, jedoch nicht in der API formal definiert sind.   

Eine häufig vorgenommene Anpassung ist die Festlegung der Standardperspektive für die Workbench.  Diese Benutzervorgabe ist im Plug-in org.eclipse.ui definiert.   Das folgende Beispiel geht davon aus, dass beim Starten des Produkts die Perspektive "Ressourcen" als Standardperspektive verwendet werden soll.

org.eclipse.ui/defaultPerspectiveId=org.eclipse.ui.resourcePerspective

Sollten Sie feststellen, dass Sie den Standardwert für die Benutzervorgaben eines anderen Plug-ins ändern müssen, sehen Sie in der API-Dokumentation für dieses Plug-in nach, ob die Benutzervorgabe als öffentlich (public) eingestuft ist.

Die Datei plugin_customization.properties enthält übersetzte Zeichenfolgen für die Datei plugin_customization.ini.

Copyright IBM Corporation und Andere 2000, 2003.