Egy elsődleges szolgáltatás testreszabása

A terméktestreszabás másképp működik az elsődleges szolgáltatás mechanizmus alkalmazásakor. A szolgáltatás márkanév-információit az elsődleges szolgáltatás által azonosított bedolgozó tartalmazza (vagy ha nincs másként megadva, akkor az elsődleges szolgáltatással egyező nevű bedolgozó). Az elképzelt acmeweb alkalmazás márkanév-információt megadó és kijelölő fájlok ki vannak emelve az alábbi látható példa könyvtárstruktúrában:

acmeweb/
	acmeweb.exe	(termék végrehajtható fájl - meghívja az
eclipse.exe fájlt és megadja az elsődleges szolgáltatást)
	eclipse/
		.eclipseproduct
		eclipse.exe
		startup.jar
		install.ini
		.config/
		platform.cfg
		jre/
		features/
			com.example.acme.acmefeature_1.0.0/   
(elsődleges szolgáltatás)
				feature.xml
		plugins/
			com.example.acme.acmefeature_1.0.0/    (az
elsődleges szolgáltatáshoz tartozó bedolgozó. Márkainformációkat
tartalmaz.)
				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/
			...

Az elsődleges szolgáltatáshoz rendelt bedolgozó az, amelyben a termék márkanév-információi meg vannak adva.  A terméknek számos testreszabható része van. A termékszintű testreszabásokat az about.ini fájl és az itt leírt egyéb fájlok adják meg. A termékek a többi bedolgozó alapértelmezett beállítás-értékeit is szabályozhatják. Ez a plugin_customization.ini fájl segítségével kerül megvalósításra.

Vegyük elő ismét a termék elsődleges példaszolgáltatásait, és nézzük meg közelebbről a termék testreszabását.

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

Áttekintjük ugyanazokat a testreszabásokat, mint amelyet a termék kiterjesztési pontnál áttekintettünk, a specifikáció különbségeire koncentrálva az elsődleges szolgáltatás mechanizmus alkalmazása esetén.

Párbeszédablakok névjegy

Ahogy a termékszintű testreszabásban tárgyaltuk, az összes szolgáltatásnak és bedolgozónak egy about.html fájlt kell létrehoznia, amely az adott bedolgozóval kapcsolatos információkat biztosít.

Az elsődleges szolgáltatás a teljes termék információit és grafikáit is szolgáltatja. Ezeket az információkat további fájlok adják meg.

Ablakképek

A 16x16 pixeles színes kép segítségével a termék által létrehozott ablakok elláthatók márkanévvel. Ez a termékablakok bal felső sarkában fog megjelenni. Ez az about.ini fájl windowImage attribútumában van megadva. Az elérési utat a bedolgozóhoz viszonyítva kell megadni.  A fent bemutatott könyvtárstruktúra megfelelő bejegyzése az alábbi lehet:

windowImage=acme.png

Üdvözlőoldal

Az Eclipse 2.1 üdvözlőoldal mechanizmusokat használó bedolgozóknak az üdvözlőoldal-fájlt az about.ini fájl welcomePage attribútumában kell megadni. Az elérési utat a bedolgozóhoz viszonyítva kell megadni.  A fent bemutatott könyvtárstruktúra megfelelő bejegyzése az alábbi lehet:

welcomePage=welcome.xml

Egy nemzeti nyelvű keresést is megadhat ehhez a fájlhoz.  (Részletes információkat a Területi beállítás specifikus fájlok tartalmaznak.)

welcomePage=$nl$/welcome.xml

Nyitóképernyők

A nyitóképernyőt az elsődleges szolgáltatás bedolgozókönyvtárban lévő splash.bmp fájl biztosítja.  A képet 24 bit színű BMP formátumban kell biztosítani (RGB formátum) és megközelítőleg 500x330 pixel méretűnek kell lennie. Ha a nyitóképernyőket testre kell szabni különböző területi beállításokhoz, akkor ezek elhelyezhetők az elsődleges szolgáltatás bedolgozójának töredékében.

Beállítások alapértelmezett értékei

A plugin_customization.ini fájl beállítja a más bedolgozók által megadott beállítások alapértelmezett értékeit.  Ez egy java.io.Properties formátumú fájl. A fájl jellemzően azon beállítások értékét adja meg, amelyek a bedolgozó nyilvános alkalmazás programozási felületének részeként kerülnek közzétételre.  Azaz kockázatos olyan bedolgozók által használt beállításokra hivatkozni, amelyek nincsenek formálisan megadva az alkalmazás programozási felületen.  

Egy általános testeszabás a munkaterület alapértelmezett perspektívájának beállítása. Ez a beállítás az org.eclipse.ui bedolgozóban van megadva.   Az alábbi példa feltételezi, hogy a terméket az erőforrás-perspektíva alapértelmezett értékkel kell elindítani.

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

Ha meg kell változtatnia az egyik bedolgozó beállításainak alapértelmezett értékeit, akkor az API dokumentációban tekintse meg a bedolgozót annak meghatározása érdekében, hogy a beállítás nyilvános-e.

A plugin_customization.properties fájl lefordított karaktersorozatokat tartalmaz a plugin_customization.ini fájlhoz.