Aby podczepić się do uniwersalnego wprowadzenia, programiści powinni użyć aplikacji Eclipse opartej na produkcie. Wymaga to użycia punktu rozszerzenia
org.eclipse.runtime.products
(zakłada się, że produkt został już określony):
<extension id="foo" point="org.eclipse.core.runtime.products"> <product application="org.eclipse.ui.ide.workbench" description="Produkt Foo do testowania uniwersalnego wprowadzenia" name="Produkt Foo"> </product> </extension>
Na potrzeby tego przykładu załóżmy, że rozszerzenie jest zdefiniowane w pliku plugin.xml
we wtyczce
com.example.intro
. Znaną od dawna cechą obsługi wprowadzeń w środowisku Eclipse jest możliwość podczepienia produktów i wprowadzeń przy użyciu powiązania produkt-wprowadzenie:
<extension point="org.eclipse.ui.intro"> <introProductBinding introId="org.eclipse.ui.intro.universal" productId="com.example.intro.foo"/> </extension>
Przedstawione powyżej rozszerzenie wiąże implementację uniwersalnego wprowadzenia (org.eclipse.ui.intro.universal) i identyfikator naszego produktu.
Dostosowanie uniwersalnego wprowadzenia dzieli się na właściwości oznakowania marką produktu oraz preferencje. Właściwości oznakowania marką produktu są ustawiane przez produkt i nie można ich modyfikować. Należą do nich tytuł produku, oznakowanie marką w postaci obrazu oraz podpis pod obrazem marki:
<product application="org.eclipse.ui.ide.workbench" description="Produkt Foo do testowania uniwersalnego wprowadzenia" name="Produkt Foo"> <property name="introTitle" value="Witamy w produkcie Bar"/> <property name="introBrandingImage" value="product:eclipse.png"/> <property name="introBrandingImageText" value="Firma XYZ"/> </product>
Właściwości produktu, których wartości reprezentują nazwę pliku względną wobec pakunku produktu, muszą mieć przedrostek 'product:'. Obsługiwane są następujące właściwości:
Druga część zmiennych uniwersalnego wprowadzenia jest dostępna jako preferencje. Podział wprowadzono, ponieważ te zmienne mogą być konfigurowane przez użytkowników i są udostępnione na nowej stronie preferencji strony powitania. Początkowe wartości tych preferencji powinny zostać umieszczone w pliku 'plugin_customization.ini', do którego odwołuje się rozszerzenie produktu. Preferencje te są następujące: