Tuotteen mukautus

Tuotteissa on useita mukautettavia osia, kuten aloitusruutu, Tietoja-valintaikkunan teksti ja ikkunakuvakkeet. Suurin osa mukautuksista määritetään laajennuspisteenorg.eclipse.core.runtime.products lisäyksessä.

Seuraavassa tarkastellaan muutamien yleisten mukautettavien elementtien määritystä.

Tietoja-valintaikkunat

Ympäristön "Tietoja"-valintaikkuna tulee näkyviin aina, kun käyttäjä valitsee työympäristön valikosta vaihtoehdot Ohje > Tietoja.  

Tietoja-valintaikkuna

Tietoja-valintaikkunan yläosa näyttää tuotetason tietoja, kun taas alaosa asennettujen tuoteominaisuuksien ja lisäosien tietoja. Tuoteominaisuuden tiedot (tuotteistus) toimitetaan about.ini-, about.properties- ja about.html-tiedostojen avulla tuoteominaisuuteen liittyvässä lisäosassa. Nämä tiedot näytetään, kun käyttäjä pyytää tuoteominaisuuden tietoja ja valitsee tietyn tuoteominaisuuden.

Tuotteen tuotteistus (valintaikkunan yläosa) määritetään laajennusominaisuuksien avulla, jotka kuvaavat valintaikkunassa näkyvän tekstin ja kuvat. Esimerkkinä on seuraava ote Eclipse-ympäristön tuotteen esittelystä.

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

Kohdassa IProductConstants on lisätietoja näistä ominaisuuksista.

Ikkunakuvat

16x16 pikselin värikuvaa voi käyttää tuotteen luomien ikkunoiden tuotteistamiseen. Se tulee näkyviin tuoteikkunoiden vasemmassa yläkulmassa. Se määritetään tuotteen laajennusmäärityksen windowImage-määritteessä. Vaihtoehtoisesti windowImages-määritteen avulla voi kuvata erikokoisten kuvien joukkoa, jota tulee käyttää vasemmassa yläkulmassa.

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

windowImages-ominaisuus ohittaa windowImage-ominaisuuden, jos kummatkin määritetään.

Esittelysivu

Tuotteet, jotka käyttävät Eclipse-ympäristön version 2.1 esittelysivumekanismia, voivat määrittää esittelysivutiedostonsa nimen ja sijainnin welcomePage-ominaisuudessa.

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

Tämän ominaisuuden käyttöä ei suositella, vaan on suositeltavaa käyttää laajennuspistettä org.eclipse.ui.intro. Kohdassa Esittelyn tuki on lisätietoja uusista esittelymekanismeista.

Oletusasetusten oletusarvot

preferenceCustomization-ominaisuuden avulla voit määrittää tiedoston, joka sisältää tuotteen oletusasetusten oletusarvot.

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

Tämä tiedosto on java.io.Properties-muodossa oleva tiedosto. Yleensä tämän tiedoston avulla määritetään arvot oletusasetuksille, jotka julkaistaan osana lisäosan julkista ohjelmointirajapintaa. Toisin sanoen otat riskin, jos viittaat oletusasetuksiin, joita lisäosat käyttävät, mutta joita ei ole määritetty muodollisesti ohjelmointirajapinnassa.  

Aloitusruudut

Tuotteen aloitusruutu määritetään config.ini-tiedostossa, joka on tuotteen configuration-hakemiston alla. Tämän tiedoston osgi.splashPath-ominaisuus kuvaa sijainteja, joista haetaan tiedostoa nimeltä splash.bmp. osgi.splashLocation-ominaisuus yksilöi tarkan ja täydellisen polun käytettävään aloitusruututiedostoon. Aloitusruutupolun määritys mahdollistaa paikallistunnuskohtaisten aloitusruutujen käytön, koska sama hakupolku voi osoittaa useita lisäosia ja fragmentteja sekä $nl$-tyylipolkuja. Ympäristön SDK:n config.ini-tiedostossa on lisätietoja ominaisuuksista, jotka voi määrittää tähän tiedostoon. Toimitettavan kuvan tulisi olla 24-bittinen värikuva BMP-muodossa (RGB-muoto), ja sen koon pitäisi olla noin 500x330 pikseliä.

Aloituksen aikana aloitusruudussa näkyvän tilasanoman ja tilanilmaisimen sijainti, koko ja väri voidaan määrittää ominaisuuksien startupProgressRect, startupMessageRect ja startupForegroundColor avulla. Kohdassa IProductConstants on lisätietoja näistä ominaisuuksista. Huomaa, että oletusarvon mukaan aloituksen yhteydessä ei raportoida tilaa. Voit ottaa käyttöön aloituksen tilannetietojen raportoinnin määrittämällä seuraavan oletusasetuksen arvoksi true esimerkiksi oletusasetusten mukautustiedostossa: IWorkbenchPreferenceConstants.SHOW_PROGRESS_ON_STARTUP