Přizpůsobení produktu

Existuje mnoho přizpůsobitelných aspektů produktu, např. jeho úvodní obrazovka, text dialogového okna O produktu, ikony oken apod. Většina těchto vlastních nastavení je definována v doplňku k bodu rozšíření org.eclipse.core.runtime.products.

Podívejme se, jak jsou definované některé z obvyklejších přizpůsobitelných prvků.

Dialogová okna O produktu

Dialogové okno platformy "O produktu" se zobrazí, kdykoli uživatel zvolí v nabídce pracovní plochy Nápověda> O produktu.  

Dialogové okno O produktu

Horní část dialogového okna O produktu zobrazuje informace na úrovni produktu, zatímco spodní část se zabývá případnými instalovanými funkcemi a moduly plug-in.  Podrobnosti o funkci (či chcete-li značení) jsou získány s použitím souborů about.ini, about.properties a about.html v modulu plug-in přidruženém k dané funkci.  Tyto informace se zobrazí, když uživatel požaduje podrobnosti o funkci a vybere konkrétní funkci.

Značení produktu (horní polovina dialogového okna) je určeno rozšiřujícími vlastnostmi, které popisují text a obrázky zobrazené v tomto dialogovém okně. Například následující výtah z deklarace produktu Eclipse.

	<property
		name="aboutText"
		value="%aboutText"/>
	<property
		name="aboutImage"
		value="icons/eclipse_lg.png"/>
	</product>

Další informace o těchto vlastnostech viz IProductConstants.

Obrázky do oken

Pro značení oken vytvořených produktem je možné použít barevný obrázek 16 x 16 pixelů.  Zobrazí se v levém horním rohu okna produktu.  Je uvedený v atributu windowImage v definici rozšíření produktů. Případně může být atribut windowImages použit k popisu pole obrázků různých velikostí, které se mají použít v levém horním rohu.

	<property
		name="windowImages"
		value="icons/eclipse.png,icons/eclipse32.png"/>

Pokud jsou specifikované obě, je vlastnost windowImage nahrazena vlastností windowImages.

Uvítací stránka

Produkty, které používají mechanizmus uvítací stránky Eclipse 2.1, mohou určit název a umístění svého souboru uvítací stránky ve vlastnosti welcomePage.

	<property
		name="welcomePage"
		value="$nl$/welcome.xml"/>

V Eclipse 3.0 není použití této vlastnosti vhodné a doporučuje se použít bod rozšíření org.eclipse.ui.intro. Další podrobnosti o nových mechanizmech uvítání/úvodů najdete v části Podpora části Intro.

Výchozí nastavení předvoleb

K určení souboru obsahujícího výchozí hodnoty předvoleb produktu je možné použít vlastnost preferenceCustomization.

	<property
		name="preferenceCustomization"
		value="plugin_customization.ini"/>

Jedná se o soubor formátu java.io.Properties. Tento soubor se zpravidla používá k nastavení hodnot předvoleb publikovaných jako součást veřejného rozhraní API modulu plug-in.  To znamená, že pokud odkazujete na předvolby, které jsou použity v modulech plug-in, ale nejsou formálně definované v tomto rozhraní API, vystavujete se jistému riziku.  

Úvodní obrazovky

Úvodní obrazovka produktu je uvedena v souboru config.ini, který se nachází pod konfiguračním adresářem produktu. Vlastnost osgi.splashPath v tomto souboru popisuje místa, kde hledat soubor nazvaný splash.bmp. Vlastnost osgi.splashLocation určuje přesnou a úplnou cestu k souboru úvodní obrazovky, který se má použít. Určení cesty k úvodní obrazovce umožňuje použít úvodní obrazovky v místním jazyce, protože daná cesta pro vyhledávání může udávat několik modulů plug-in nebo fragmentů, které se mají prohledat, i cesty ke stylům $nl$. Úplný popis vlastností, které lze v tomto souboru konfigurovat, naleznete v souboru config.ini SDK platformy. Obrázek by měl být poskytnut ve 24bitovém barevném formátu BMP (formát RGB) o rozměrech přibližně 500x330 pixelů.