Tilpasse et produkt

Et produkt kan tilpasses på flere måter. Du kan for eksempel tilpasse oppstartsbildet, teksten i Om-dialogboksen, vindusikoner, osv. De fleste tilpasningene defineres i bidraget til utvidelsespunktet org.eclipse.core.runtime.products.

La oss se hvordan noen av de mer vanlige tilpassingselementene defineres.

Om-dialogbokser

Plattformens "Om"-dialogboks vises når brukeren velger Hjelp > Om på arbeidsbenkmenyen.  

Om-dialogboks

Den øverste delen av Om-dialogboksen viser informasjon på produktnivå, mens den nedre delen viser eventuelle funksjoner og plugin-moduler som er installert. Funksjonsopplysningene (eller merkevarene) oppgis ved hjelp av filene about.ini, about.properties og about.html i plugin-modulen som er tilknyttet funksjonen. Denne informasjonen vises når brukeren ber om funksjonsopplysninger og velger en bestemt funksjon.

Produktmerkevarene (øverste del av dialogboksen) angis av utvidelsesegenskapene som beskriver teksten og bildene som vises i denne dialogboksen. Her ser du et eksempel på et utdrag fra produktdeklarasjonen for Eclipse-plattformen.

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

Du finner mer informasjon om disse egenskapene, under IProductConstants.

Vindusbilder

Et fargebilde med 16x16 piksler kan brukes til å merke vinduer som er opprettet av produktet.  Det vises øverst til venstre i produktvinduene. Det oppgis i windowImage-attributtet i produktets utvidelsesdefinisjon. Du kan også bruke windowImages-attributtet til å beskrive en tabell med bilder av ulik størrelse som skal vises øverst til venstre.

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

Egenskapen windowImages erstatter egenskapen windowImage hvis begge er angitt.

Velkomstside

Hvis du har produkter som bruker velkomstsiden i Eclipse 2.1, kan du angi navn på og plassering av velkomstsidefilen i egenskapen welcomePage.

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

Bruk av denne egenskapen frarådes nå. Bruk heller utvidelsespunktet org.eclipse.ui.intro. Du finner mer informasjon om de nye mekanismene for velkomst/introduksjon under Velkommen/Introduksjonsstøtte.

Standardverdier for preferanser

Egenskapen preferenceCustomization kan brukes til å angi en fil som inneholder standard preferanseverdier for produktet.

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

Denne filen er i java.io.Properties-format. Denne filen brukes vanligvis til å definere verdiene for preferanser som er publisert som en del av plugin-modulens felles programmeringsgrensesnitt (API).  Du løper med andre ord en risiko hvis du refererer til preferanser som brukes av plugin-moduler, men som ikke formelt er definert i programmeringsgrensesnittet.  

Oppstartsbilde

Oppstartsbildet for produktet er angitt i config.ini, som ligger under produktets configuration-katalog. Egenskapen osgi.splashPath i denne filen beskriver hvor det skal søkes etter en fil med navnet splash.bmp. Egenskapen osgi.splashLocation identifiserer en komplett og nøyaktig bane til oppstartsbildefilen som skal brukes. Ved å oppgi et oppstartsbilde kan det brukes oppstartsbilder som er spesifikke for bestemte språkmiljøer, ettersom den oppgitte søkebanen kan angi flere plugin-moduler eller fragmenter som det skal søkes, i tillegg til $nl$-stilbaner. Du finner en fullstendig beskrivelse av egenskaper som kan konfigureres i filen, i config.ini-filen for plattform-SDKen. Bildet må oppgis med farger i 24-biters BMP-format (RGB-format) og ha en størrelse på omtrent 500x330 piksler.

Plassering, størrelse og farge for statuslinjen og statusmeldingen som vises i oppstartsbildet, kan konfigureres ved hjelp av egenskapene startupProgressRect, startupMessageRect og startupForegroundColor. Du finner mer informasjon om disse egenskapene, under IProductConstants. Merk at det som standard ikke rapporteres status ved oppstart. Du kan aktivere rapportering av status ved oppstart ved å sette følgende preferanser til true, for eksempel i preferansetilpasningsfilen: IWorkbenchPreferenceConstants.SHOW_PROGRESS_ON_STARTUP