Om onderdelen aan de universele inleiding te koppelen, moeten ontwikkelaars een op een product gebaseerde Eclipse-toepassing hebben. Dit vereist het gebruik van het extensiepunt org.eclipse.runtime.products
(hierbij wordt ervan uitgegaan dat het product al is gedefinieerd):
<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>
Stel ten behoeve van dit voorbeeld dat de extensie is gedefinieerd in het bestand plugin.xml
in de plugin com.example.intro
. Een al langer bestaande voorziening van Eclipse is de mogelijkheid om producten en inleidingen toe te voegen met behulp van de productintro-binding:
<extension point="org.eclipse.ui.intro"> <introProductBinding introId="org.eclipse.ui.intro.universal" productId="com.example.intro.foo"/> </extension>
De bovenstaande extensie koppelt de implementatie org.eclipse.ui.intro.universal aan uw product-ID.
Bij het aanpassen van de universele inleiding moet onderscheid worden gemaakt tussen eigenschappen van de productgegevens en voorkeuren. Eigenschappen van productgegevens worden bepaald door het product en kunnen niet worden gewijzigd. U moet hierbij denken aan producttitel, brandingimage en brandingimagetext:
<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>
Producteigenschappen waarvan de waarden een bestandsnaam vertegenwoordigen relatief aan de productbundel moeten worden gekwalificeerd met het voorvoegsel 'product:'. De volgende eigenschappen worden ondersteund:
De tweede helft van de variabelen van de universele inleiding is toegankelijk als voorkeuren. Het onderscheid is dat deze variabelen door gebruikers kunnen worden geconfigureerd en worden afgebeeld op de nieuwe voorkeurenpagina Welkom. De beginwaarden voor deze voorkeuren moeten in het bestand 'plugin_customization.ini' worden geplaatst waarnaar wordt verwezen vanuit de productextensie. Het betreft de volgende voorkeuren: