Přizpůsobení primární funkce

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.

Dialogová okna O produktu

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.

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 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

Uvítací stránka

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í obrazovky

Ú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.

Výchozí nastavení předvoleb

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.