Een primaire feature aanpassen

Het aanpassen van het product gebeurt op een andere manier wanneer de primaire feature wordt gebruikt. De productgegevens van de feature bevinden zich in een plugin die wordt geïdentificeerd door de primaire feature (of in de plugin met dezelfde naam als de naam van de primaire feature als er geen is opgegeven). De bestanden die productgegevens aanwijzen en definiëren voor onze hypothetische acmeweb-toepassing, worden geaccentueerd weergegeven in de onderstaande voorbeeld-directorystructuur:

acmeweb/
	acmeweb.exe	(uitvoerbare bestand van het product - roept eclipse.exe op en geeft de primaire feature op)
	eclipse/
		.eclipseproduct
		eclipse.exe
		startup.jar
		install.ini
		.config/
		platform.cfg
		jre/
		features/
			com.example.acme.acmefeature_1.0.0/    (primaire feature)
				feature.xml
		plugins/
			com.example.acme.acmefeature_1.0.0/    (plugin voor primaire feature. Bevat productgegevens.)
				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/
			...

De plugin die gekoppeld is aan de primaire feature bevat de productgegevens.   Vele aspecten van het product kunnen worden aangepast.  De aanpassingen op productniveau worden gedefinieerd met behulp van het bestand about.ini en andere bestanden die zich hierin bevinden.  Producten kunnen ook de standaardvoorkeurswaarden van andere plugins beheren.  Dit wordt uitgevoerd met het plugin_customization.ini- bestand.

Laten we, met betrekking tot de primaire-featureplugin van ons voorbeeldproduct, eens kijken hoe het product wordt aangepast.

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

U kunt dezelfde aanpassingen bekijken die u hebt gezien voor het extensiepunt van het product, waarbij de nadruk wordt gelegd op hoe de specificatie verschilt wanneer de primaire feature wordt gebruikt.

Info-dialoogvensters

Zoals eerder werd besproken voor de aanpassingen op productniveau, moeten alle features en plugins een about.html-bestand bijdragen dat gegevens levert over de betreffende plugin.

De primaire feature levert ook informatie en grafische voorstellingen over het totale product.  Voor het opgeven van deze gegevens worden extra bestanden gebruikt.

Vensterafbeeldingen

Een 16x16-pixels-kleurenafbeelding kan worden gebruikt om de vensters te markeren die door het product zijn gemaakt.  Deze verschijnt in de linkerbovenhoek van de productvensters.  Dit wordt opgegeven in het windowImage-kenmerk in het bestand about.ini.  Het pad moet worden opgegeven als relatief aan de plugin.  Een correcte invoer voor de directorystructuur hierboven:

windowImage=acme.png

Welkomstpagina

In Plugins die gebruikmaken van Eclipse 2.1-welkomstmechanismen, moet het welkomstpaginabestand worden opgegeven in het welcomePage-kenmerk van het about.ini-bestand. Het pad moet worden opgegeven als plugin-relatief pad.  Een correcte invoer voor de directorystructuur hierboven:

welcomePage=welcome.xml

U kunt ook voor het bestand een taalzoekopdracht opgeven.  (voor meer details hierover kunt u Locale specific files raadplegen).

welcomePage=$nl$/welcome.xml

Beginschermen

Het beginscherm van het product wordt geleverd met een splash.bmp-bestand dat zich bevindt in de plugindirectory van de primaire feature.  De afbeelding moet worden geleverd in 24-bit-kleuren in BMP-indeling (RGB-indeling) en moet een grootte hebben van ongeveer 500x330 pixels.  Als de beginschermen moeten worden aangepast voor verschillende locales, moeten deze worden geplaatst in een fragment van de primaire-featureplugin.

Standaardinstellingen voorkeuren

Het bestand plugin_customization.ini wordt gebruikt om de standaardwaarden van de voorkeuren in te stellen voor de voorkeuren die zijn gedefinieerd door andere plugins.  Dit is een bestand met de indeling java.io.Properties. Dit bestand wordt gebruikt om de waarden in te stellen van de voorkeuren die zijn gepubliceerd als onderdeel van de openbare API van een plugin.  Dit betekent dat u een risico neemt als u naar voorkeuren verwijst die door plugins worden gebruikt en niet formeel zijn gedefinieerd in de API.   

Een algemene aanpassing is het instellen van het standaardperspectief van de workbench. Deze voorkeur wordt gedefinieerd in de plugin org.eclipse.ui. In het volgende voorbeeld wordt aangenomen dat het product moet worden geopend met het resource perspectief als standaardperspectief.

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

Als u erachter komt dat u de standaardwaarde van een van de andere pluginvoorkeuren moet wijzigen, kunt u de API-documentatie over deze plugin raadplegen om te controleren of deze voorkeur wordt beschouwd als een openbare.

Het bestand plugin_customization.properties bevat vertaalde tekenreeksen van het bestand plugin_customization.ini.