Um eine Integration in die universelle Einführung zu erstellen, sollten Entwickler eine produktbasierte Eclipse-Anwendung besitzen. Dies macht die Verwendung des Erweiterungspunktes
org.eclipse.runtime.products
erforderlich (es wird davon ausgegangen, dass das Produkt bereits definiert wurde):
<extension id="foo" point="org.eclipse.core.runtime.products"> <product application="org.eclipse.ui.ide.workbench" description="Product Foo to use for testing the universal intro" name="Product Foo"> </product> </extension>
Dieses Beispiel geht von der Annahme aus, dass die Erweiterung in der Datei plugin.xml
des Plug-ins com.example.intro
definiert ist. Ein ständiges Merkmal der Eclipse-Einführungsunterstützung ist die Fähigkeit, Produkte und Einführungen unter Verwendung des Bindings für Produkteinführungen mit Hooks zu integrieren:
<extension point="org.eclipse.ui.intro"> <introProductBinding introId="org.eclipse.ui.intro.universal" productId="com.example.intro.foo"/> </extension>
Die oben dargestellte Erweiterung bindet die Implementierung der universellen Einführung (org.eclipse.ui.intro.universal) an die Produkt-ID.
Die Anpassung der universellen Einführung erfolgt zum einen über die Eigenschaften des Produktbrandings und zum anderen über Benutzervorgaben. Die Eigenschaften des Produktbrandings werden durch das Produkt festgelegt und können nicht geändert werden. Hierzu gehören der Produkttitel, das Branding-Image und der Text für das Branding-Image:
<product application="org.eclipse.ui.ide.workbench" description="Product Foo to use for testing the universal intro" name="Product Foo"> <property name="introTitle" value="Welcome to Product Bar"/> <property name="introBrandingImage" value="product:eclipse.png"/> <property name="introBrandingImageText" value="XYZ Company"/> </product>
Produkteigenschaften, deren Werte aus einem Dateinamen bestehen, der in Bezug auf das Produktpaket relativ ist, müssen mit dem Präfix "product:" qualifiziert werden. Die folgenden Eigenschaften werden unterstützt:
Auf die anderen Variablen der universellen Einführung kann über Benutzervorgaben zugegriffen werden. Die Aufteilung ergibt sich aus der Tatsache, dass diese Variablen von Benutzern konfiguriert werden können und auf der Benutzervorgabenseite für die neue Startseite zugänglich sind. Die Anfangswerte für diese Benutzervorgaben sollten in die Datei "plugin_customization.ini" gestellt werden, auf die durch die Produkterweiterung verwiesen wird. Es handelt sich um die folgenden Benutzervorgaben: