Universelle Einführung ergänzen

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: