Tuotteen asennusohjeet

Ympäristössä on vakiotyökalut tuotteiden päivitykseen ja laajennukseen. Jotta paketoitu tuote voi osallistua tuotteiden päivitys- ja laajennusmenetelmiin ympäristössä, sen on noudatettava seuraavia ohjeita. Näin tuote toimii yhdessä muiden Eclipse-perustaisten tuotteiden kanssa ja voi jopa tehosta niitä.

Tarkastellaan jälleen acmeweb-tuotteen hakemistorakenteen mallia:

acmeweb/
	acmeweb.exe
	eclipse/	
		.eclipseproduct	
		eclipse.exe	
		startup.jar	
		install.ini	
		.config/	
			platform.cfg
		jre/
		features/	
			com.example.acme.acmefeature_1.0.0/
				feature.xml
			...
		plugins/
			com.example.acme.acmefeature_1.0.0/
				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/
			...

Mistä nämä tiedostot ovat peräisin? Seuraavassa tarkastellaan tuotteen sisältöä kehitystyöryhmän näkökulmasta. Asennetut tiedostot voi ryhmitellä viiteen pääluokkaan:

Kunnollinen asennuskomentosarja tuottaa oikean hakemistorakenteen seuraavasti:

Usean käyttäjän käyttöön liittyvät seikat

Kun tuote asennetaan ja tarkoitus on käyttää sitä usean käyttäjän kesken, on pidettävä huolta, että yksittäisen käyttäjän tiedot (esimerkiksi workspace-hakemisto) erotetaan yhteiskäytössä olevan tuotteen asennushakemistosta.

Asennuksen poistoon liittyvät seikat

Kun tuotteen asennus poistetaan, seuraavat seikat ovat tärkeitä.

Tuotteen asennus uudelleen

Kun tuote on jo asennettu, asennusohjelman on sallittava palvelun päivitys tai tason nosto, jos sellainen on saatavilla. Tuotteen olemassaolon voi varmistaa hakemalla kohdetta acmeweb/eclipse/.eclipseproduct. Tämän merkintätiedoston tietojen avulla voi varmistaa käyttäjältä, että päivitys kohdistuu oikeaan tuotteeseen. Päivitysten saatavuuden voi varmistaa tuotenimien hauilla. Esimerkiksi kohteen acmeweb/eclipse/plugins/com.example.acmefeature_1.0.1 läsnäolo järjestelmässä osoittaa, että tuote on jo päivitetty versioksi 1.0.1.

Kun uudelleenasennuksen kelpoisuus on varmistettu, asennusohjelman on kopioitava tai korvattava tiedostot tarpeen mukaan. Jos perustana olevan Eclipse-ympäristön versio ei ole muuttunut, on olemassa suuri todennäköisyys, että kokonaisia hakemistoja voi ohittaa. Ympäristön tuoteominaisuuksien ja lisäosien versionumeroiden avulla voi selvittää, ovatko muutokset lisäosan tai tuoteominaisuuden hakemistoon tarpeen. 

Lisätietoja tuotteiden asennuksesta on kohteessa Eclipse-asennusohjelman kirjoitus.