Retningslinjer for produktinstallering
Plattformen inneholder standardverktøy for oppdatering og utvidelse av
produkter. For inngå i plattformmekanismene for oppdatering og utvidelse av
produkter, bør det pakkede produktet bruke følgende retningslinjer. På denne måten kan
produktet fungere sammen med, og til og med forbedre andre Eclipse-baserte produkter.
Se på eksempelkatalogstrukturen for Acmeweb-produktet:
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/
...
Hvor kommer disse filene fra? La oss se på produktinnholdet fra
utviklingsgruppens perspektiv. De installerte filene kan grupperes
i fem hovedkategorier:
- Produktfiler på toppnivå (for eksempel acmeweb.exe)
- Produktfunksjoner og plugin-moduler
- Selve Eclipse-plattformen
- Java-kjøretidsmiljøet (JRE)
- Filer som genereres av selve installeringsprosessen
Et riktig installeringsskript oppretter en hensiktsmessig katalogstruktur
gjennom å gjøre følgende:
- Tillate at brukeren angir en toppnivåkatalog for installasjonen (for eksempel c:\acmeweb.
Vi refererer til katalogen som acmeweb i de gjenstående trinnene.)
- Forsikre seg om at det ikke allerede er installert et produkt med denne plasseringen
- Kopiere filene på følgende måte:
- Produktfiler på toppnivå kopieres til acmeweb
- Eclipse-filer kopieres til acmeweb/eclipse ved hjelp av forventet
katalogstruktur for funksjoner og plugin-moduler
- JRE-filer kopieres til acmeweb/eclipse/jre. Hvis en JRE allerede
er
plassert et annet sted, bør applikasjonssnarveien konfigureres for å starte
Eclipse med -vm-kommandolinjeargumentet slik at plattformen kjenner plasseringen av JRE
- Produktfunksjoner og plugin-moduler kopieres til acmeweb/eclipse/features
og acmeweb/eclipse/plugins
- Opprette marker-filen .eclipseproduct i acmeweb/eclipse.
Dette er en java.io.Properties-formatfil som angir navnet, IDen og versjonen
for produktet.
- Lagre all nødvendig installeringsinformasjon (bruker, lisens, dato) som skal vises i
Om-dialogboksen i acmeweb/eclipse/plugins/com.example.acmefeature_1.0.0/about.mappings
- Hvis mekanismen for den primære funksjonen (før R3.0) brukes til å definere
produktet, erstatter du
acmeweb/eclipse/install.ini med en funksjon som definerer egenskapen
feature.default.id
som produktets primære funksjon
- Start det kjørbare produktet med alternativet -initialize.
Plattformen utfører da all tidkrevende førstegangsbehandling og bufrer
resultatene slik at når brukeren starter produktet, vises det med en gang i
aktivert tilstand.
Flerbrukerspørsmål
Når det installeres et produkt som skal deles på flere brukere, må
brukernes data holdes atskilt (for eksempel katalogen workspace) fra felleskatalogen
for produktinstallering.
Avinstalleringsspørsmål
Når et produkt avinstalleres, er følgende begreper viktige.
- alle filer i katalogene eclipse/features og eclipse/plugins
bør fjernes, selv om de ikke opprinnelig er installert av installeringsprogrammet.
Dette sørger for at
filer som er lagt til av plattformens oppdateringsstyrer, fjernes når produktet
fjernes.
- Bortsett fra punktet ovenfor, er det bare filer som er installert av
installeringsprogrammet i andre kataloger som skal fjernes. Det er viktig å
ta vare på alle viktige data, for eksempel i katalogen workspace, slik at
du kan installere produktet etter en avinstallering med forventet resultat.
Installere produktet på nytt
Hvis produktet allerede er installert, skal installeringsprogrammet tillate oppdatering eller
oppgradering av en eventuell tilgjengelig tjeneste. Du finner produktet
ved å søke etter acmeweb/eclipse/.eclipseproduct. Informasjonen i denne
marker-filen kan brukes til å bekrefte overfor brukeren at det er korrekt produkt som
oppdateres. Du finner ut hvilke oppdateringer som er tilgjengelig, ved å samsvare mønster med
funksjonsnavn. For eksempel angir
acmeweb/eclipse/plugins/com.example.acmefeature_1.0.1 at oppdateringen av versjon av
1.0.1 allerede er utført i dette produktet.
Når det er på det rene at den nye installeringen er gyldig, skal installeringsprogrammet
kopiere eller erstatte filer etter behov. Hvis versjonen av den underliggende
Eclipse-plattformen ikke er endret, kan det hende at hele kataloger ignoreres. Versjonsnumrene
som er tilføyd i plattformens funksjoner og plugin-moduler kan brukes til å finne ut om det er nødvendig med endringer under en plugin-modul eller funksjonskatalog.
Du finner mer informasjon om installering av produkter, i
Slik skriver du et Eclipse-installeringsprogram.