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:
- ylätason tuotetiedostot (esimerkiksi acmeweb.exe)
- tuoteominaisuudet ja lisäosat
- Eclipse-ympäristö itsessään
- JRE (Java runtime environment)
- asennuksen muodostamat tiedostot.
Kunnollinen asennuskomentosarja tuottaa oikean hakemistorakenteen
seuraavasti:
- sallii käyttäjän määrittää asennuksen ylätason hakemiston (Esimerkiksi c:\acmeweb.
Siihen viitataan seuraavissa vaiheissa nimellä acmeweb.)
- varmistaa, ettei tuote ole jo asennettuna kyseiseen sijaintiin
- kopioi tiedostot seuraavasti:
- ylätason tuotetiedostot kopioidaan acmeweb-hakemistoon
- Eclipse-tiedostot kopioidaan acmeweb/eclipse-hakemistoon
odotettujen tuoteominaisuus- ja lisäosahakemistorakenteiden avulla
- JRE-tiedostot kopioidaan acmeweb/eclipse/jre-hakemistoon. Jos JRE
sijaitsee jo muualla, sovelluksen pikakuvake tulee määrittää kutsumaan
Eclipse komentoriviargumentin -vm kanssa, jotta ympäristö tietää,
missä JRE sijaitsee
- tuoteominaisuudet ja lisäosat kopioidaan acmeweb/eclipse/features-hakemistoon
ja acmeweb/eclipse/plugins-hakemistoon.
- luo merkintätiedoston .eclipseproduct acmeweb/eclipse-hakemistoon.
Merkintätiedosto on java.io.Properties-muodossa oleva tiedosto, joka ilmaisee
tuotteen nimen, tunnuksen ja version.
- tallentaa kaikki tarvittavat asennustiedot (käyttäjä, lisenssi, päivämäärä), jotka näytetään
Tietoja-valintaikkunassa, tiedoston acmeweb/eclipse/plugins/com.example.acmefeature_1.0.0/about.mappings
- jos tuote on määritetty ensisijaisen tuoteominaisuuden avulla (ennen versiota 3.0), korvaa
acmeweb/eclipse/install.ini-tiedoston sellaisella tiedostolla, joka määrittää
ominaisuuden feature.default.id tuotteen ensisijaiseen tuoteominaisuuteen
- kutsuu tuotteen ohjelmatiedoston valinnan -initialize avulla.
Tällöin ympäristö toteuttaa kaikki aikaavievät ensi kertaa tehtävät käsittelyt ja
tallentaa tulokset välimuistiin, jotta käyttäjä voi tuotteen aloittaessaan
aloittaa käytön heti.
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ä.
- Kaikki tiedostot eclipse/features- ja eclipse/plugins-hakemistoista
on poistettava, vaikka asennusohjelma ei olisi alun perin asentanut
niitä. Tämä varmistaa, että ympäristön päivitystenhallinnan lisäämät
tiedostot poistetaan, kun tuote poistetaan.
- Edellä mainittua lukuun ottamatta vain ne tiedostot, jotka
asennusohjelma on asentanut muihin hakemistoihin, on poistettava. On tärkeää
säilyttää tärkeät tiedot, esimerkiksi workspace-hakemisto, jotta
tuotteen asennus uudelleen asennuksen poiston jälkeen tuottaa odotetut tulokset.
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.