Anpassa en produkt

Det finns många anpassningsbara aspekter av en produkt, t.ex. välkomstskärmen, texten i om-dialogrutan, fönsterikoner osv. De flesta av dessa anpassningar definieras i bidraget till utökningspunkten org.eclipse.core.runtime.products.

Låt oss titta på hur vissa av de mer vanliga anpassningsbara elementen definieras.

Om-dialogrutor

Plattformens "om"-dialogruta visas när användaren väljer Hjälp > Om på menyn i arbetsmiljön.   

Om-dialogruta

Den övre delen av om-dialogrutan innehåller information om produktnivå medan den nedre delen visar installerade funktioner och insticksprogram. Funktionsdetaljerna (t.ex. varumärken) anges med hjälp av filerna about.ini, about.properties och about.html i funktionens insticksprogram. Informationen visas när användaren markerar en viss funktion och begär detaljerad information.

Produktens varumärke (översta halvan av dialogrutan) anges med utökningsegenskaper som beskriver texten och bilderna i dialogrutan. T.ex. är följande ett extrakt från Eclipse-plattformens produktdeklaration.

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

I IProductConstants finns mer information om dessa egenskaper.

Fönsterbilder

En färgbild med 16x16 bildpunkter kan användas till att varumärka fönster som skapats av produkten. Den visas i övre vänstra hörnet i produktfönstren. Den anges i attributet windowImage i produktens utökningsdefinition. Alternativt kan attributet windowImages användas till att beskriva en matris med bilder i olika storlekar som kan användas i övre vänstra hörnet.

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

Egenskapen windowImages gäller före egenskapen windowImage om båda anges.

Välkomstsida

Produkter som använder välkomstsidsmekanismen från Eclipse 2.1 kan ange namn och plats för sin välkomstsidfil i egenskapen welcomePage.

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

Användning av den här egenskapen uppmuntras inte längre. Använd hellre utökningspunkten org.eclipse.ui.intro. I Välkommen/Introduktionsfunktioner finns mer detaljerad information om de nya välkomst/introduktionsmekanismerna.

Inställningsstandard

Egenskapen preferenceCustomization kan användas till att ange en fil som innehåller standardvärden för produktens inställningar.

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

Den här filen är en java.io.Properties-formatfil. Vanligen används den här filen för att ange värden för inställningar som publicerats som del av insticksprogrammets allmänna API.  Dvs. att du tar en risk om du hänvisar till inställningar som används av insticksprogram men som inte definierats formellt i APIn.  

Välkomstskärmar

Produktens välkomstskärm anges i filen config.ini, vilken finns under produktens configuration-katalog. Egenskapen osgi.splashPath i den här filen beskriver var du kan söka efter en fil med namnet splash.bmp. Egenskapen osgi.splashLocation identifierar en fullständig och exakt sökväg till den välkomstskärmsfil som ska användas. Om du anger sökväg till en välkomstskärm kan språkmiljöspecifika välkomstskärmar användas eftersom given sökväg kan indikera flera insticksprogram eller fragment att genomsöka lika väl som $nl$-stilsökvägar. På plattformens SDK-fil med namnet config.ini finns en fullständig beskrivning av egenskaperna som kan konfigureras i den här filen. Bilden ska finnas i 24-bitars färg-BMP-format (RGB-format) och ha en storlek på cirka 500x330 bildpunkter.

Placering, storlek och färg för statusfältet och statusmeddelandet som visas på välkomstskärmen när plattformen startas kan konfigureras med hjälp av egenskaperna startupProgressRect, startupMessageRect och startupForegroundColor. I IProductConstants finns mer information om dessa egenskaper. Observera att som standard rapporteras inte status vid start. Om du vill aktivera rapport av status vid start anger du true för följande inställning, till exempel i filen för inställningsanpassning: IWorkbenchPreferenceConstants.SHOW_PROGRESS_ON_STARTUP