Přizpůsobení produktu funguje jinak, pokud je použit mechanizmus primární funkce. Informace o značení pro danou funkci se nachází v modulu plug-in identifikovaném primární funkcí (nebo v modulu plug-in nazvaném stejně jako primární funkce, pokud není žádný určen). Soubory, které určují a definují informace o značení pro naši hypotetickou aplikaci acmeweb, jsou v níže uvedené ukázkové adresářové struktuře zvýrazněny:
acmeweb/ acmeweb.exe (spustitelná komponenta produktu - spouští eclipse.exe a určuje primární funkci) eclipse/ .eclipseproduct eclipse.exe startup.jar install.ini .config/ platform.cfg jre/ features/ com.example.acme.acmefeature_1.0.0/ (primární funkce) feature.xml plugins/ com.example.acme.acmefeature_1.0.0/ (modul plug-in primární funkce. Obsahuje informace o značení.) plugin.xml about.ini about.html about.mappings about.properties acme.png plugin_customization.ini splash.jpg welcome.xml com.example.acme.acmewebsupport_1.0.0/ ... links/ ...
Modul plug-in přidružený k primární funkci je místem, kde jsou specifikované informace o značení produktu. Existuje mnoho přizpůsobitelných aspektů produktu. Vlastní nastavení na úrovni produktu se definují pomocí souboru about.ini a dalších souborů popsaných v tomto dokumentu. Produkty mohou také ovládat výchozí hodnoty předvoleb ostatních modulů plug-in. To se dělá pomocí souboru plugin_customization.ini.
Podívejme se ještě jednou na plug-in primární funkce našeho ukázkového produktu a tentokrát se zaměřme na to, jak se tento produkt přizpůsobuje.
com.example.acme.acmefeature_1.0.0/ plugin.xml about.ini about.html about.mappings about.properties acme.png plugin_customization.ini plugin_customization.properties splash.bmp welcome.xml
Podíváme se na stejná vlastní nastavení, která jsme prohlíželi u bodu rozšíření produktů, a nyní se zaměříme na to, jak se liší specifikace při použití mechanizmu primární funkce.
Jak již bylo řečeno u přizpůsobení na úrovni produktu, všechny funkce a moduly plug-in by měly mít soubor about.html, který nabízí informace o daném modulu plug-in.
Primární funkce poskytuje také informace a grafiku pro celý produkt. K určení těchto informací se používají další soubory.
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 souboru about.ini. Cesta by měla být uvedena jako relativní vzhledem k modulu plug-in. Náležitý záznam pro výše uvedenou adresářovou strukturu by byl následující:
windowImage=acme.png
Moduly plug-in, které používají mechanizmy Eclipse 2.1 Welcome, by měly určovat soubor uvítací stránky v atributu welcomePage v souboru about.ini. Cesta by měla být uvedena jako relativní vzhledem k modulu plug-in. Náležitý záznam pro výše uvedenou adresářovou strukturu by byl následující:
welcomePage=welcome.xml
Můžete také zadat vyhledání národního jazyka pro daný soubor. (Další podrobnosti viz téma Soubory v místním jazyce.)
welcomePage=$nl$/welcome.xml
Úvodní obrazovka produktu se nachází v souboru splash.bmp umístěném v adresáři modulu plug-in primární funkce. 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ě 500 x 330 pixelů. Pokud je třeba úvodní obrazovky upravit pro různá národní prostředí, mohou být umístěny ve fragmentu modulu plug-in primární funkce.
Soubor plugin_customization.ini se používá k nastavení výchozích hodnot předvoleb pro předvolby definované ostatními moduly plug-in. Tento soubor je ve 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.
Jednou z běžných úprav je nastavení výchozí perspektivy pro pracovní plochu. Tato předvolba je definována v modulu plug-in org.eclipse.ui . Následující příklad předpokládá, že by měl být produkt spuštěn s perspektivou prostředku jako s výchozí perspektivou.
org.eclipse.ui/defaultPerspectiveId=org.eclipse.ui.resourcePerspective
Pokud zjistíte, že potřebujete změnit výchozí hodnotu některé předvolby jiného modulu plug-in, podívejte se do dokumentace API pro daný modul plug-in, abyste zjistili, zda je tato předvolba považována za veřejnou.
Soubor plugin_customization.properties obsahuje přeložené řetězce pro soubor plugin_customization.ini.