Tilpas primær funktion

Produkttilpasning fungerer anderledes, når den primære funktionsmekanisme benyttes. Varemærkeoplysningerne til en funktion er placeret i en plugin, der identificeres af den primære funktion (eller den plugin med samme navn som den primære funktion, hvis ingen er angivet). Filerne, som udvælges og definerer varemærkeoplysningerne til det hypotetiske acmeweb-program, er fremhævet i nedenstående biblioteksstruktureksempel:

acmeweb/
	acmeweb.exe	(produkteksekvérbar - starter eclipse.exe og angiver den primære funktion)
	eclipse/
		.eclipseproduct
		eclipse.exe
		startup.jar
		install.ini
		.config/
		platform.cfg 		jre/
		features/
			com.example.acme.acmefeature_1.0.0/    (primary feature)
				feature.xml
		plugins/
			com.example.acme.acmefeature_1.0.0/    (plugin for primær funktion. Indeholder varemærkeoplysninger.)
				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/
			...

Den plugin, der er knyttet til en primær funktion, findes på samme placering, som hvor varemærkeoplysningerne for et produkt angives. Der er mange aspekter af et produkt, der kan tilpasses. Tilpasning på produktniveau defineres vha. filen about.ini og andre filer, der er beskrevet i denne fil. Produkter kan også styre værdierne for standardindstillingerne til andre plugins. Dette gøres vha. filen plugin_customization.ini.

Ved igen at benytte produkteksemplet med en primærfunktions-plugin kan vi se nærmere på, hvordan produktet tilpasses.

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

De samme tilpasninger gennemgås som for produktets udvidelsespunkt med fokus på, hvordan specifikationen er anderledes, når den primære funktionsmekanisme benyttes.

Om-dialogbokse

Som det blev gennemgået med tilpasning på produktniveau skal alle funktioner og plugins levere en about.html-fil, som stiller oplysninger til rådighed om den pågældende plugin.

Den primære funktion stiller også oplysninger og grafik til rådighed for det overordnede produkt. Yderligere filer benyttes til at angive disse oplysninger.

Vinduesbilleder

Et farvebillede på 16 x 16 pixel kan bruges til at varemærke de vinduer, der er oprettet af produktet. Det vises i øverste venstre hjørne af produktvinduer. Det er angivet i windowImage-attributten i filen about.ini. Stien angives som en relativ sti til en plugin. En korrekt indgang for ovenstående biblioteksstruktur vil være:

windowImage=acme.png

Velkomstside

Plugins, der bruger Eclipse 2.1-velkomstmekanismer, angiver velkomstsidefilen i welcomePage-attributten i filen about.ini. Stien skal angives som en relativ sti til en plugin.  En korrekt indgang for ovenstående biblioteksstruktur vil være:

welcomePage=welcome.xml

Du kan også angive et nationalt sprogopslag for filen. I Specifikke sprogfiler finder du flere oplysninger.

welcomePage=$nl$/welcome.xml

Åbningsskærmbilleder

Produktets åbningsskærmbillede leveres i en splash.bmp-fil, der er placeret i plugin-biblioteket for den primære funktion. Billedet leveres i 24-bit BMP-farveformat (RGB-format) og er ca. 500 x 330 pixel i størrelse. Hvis åbningsskærmbilleder skal tilpasses for forskellige sprog, kan de placeres i et fragment af den primære funktions plugin.

Standardværdier for indstillinger

Filen plugin_customization.ini bruges til at angive standardværdier for de indstillinger, der defineres af andre plugins. Denne fil har formatet java.io.Properties. Typisk benyttes denne fil til at angive værdier for indstillinger, der publiceres som en del af en plugins offentlige API. Dvs. det udgør en risiko, hvis du refererer til indstillinger, der bruges af plugins, men som ikke er defineret formelt i API'et.  

En fælles tilpasning er at angive standardperspektivet for arbejdsbænken. Denne indstilling defineres i org.eclipse.ui-plugin'en.  I følgende eksempel antages det, at produktet skal startes med ressourceperspektivet som standardperspektivet.

org.eclipse.ui/defaultPerspectiveId=org.eclipse.ui.resourcePerspective

Hvis du opdager, at du har behov for at ændre standardværdien for en anden af plugin'ens indstillinger, kan du i API-dokumentationen for den pågældende plugin se, om indstillingen betragtes som offentlig.

Filen plugin_customization.properties indeholder oversatte strenge for filen plugin_customization.ini.