Kjøretidsalternativene for Eclipse
Versjon 3.2 - Sist endret 8. mai 2006
Eclipse-plattformen er svært konfigurerbar. Konfigurasjonsinndataene er i form av kommandolinjeargumenter og
innstillinger for systemegenskaper. I mange tilfeller er kommandolinjeargumentene bare en snarvei for å definere
den beslektede systemegenskapen. Det er i virkeligheten mange flere innstillinger for systemegenskaper enn
kommandolinjeargumenter.
Kommandolinjeargumenter
Listen nedenfor viser kommandolinjeargumentene som behandles av forskjellige deler av Eclipse-kjøretiden. Mange
av disse verdiene kan også oppgis ved hjelp av systemegenskapene, enten på kommandolinjen med -D VM-argumenter, ved
å oppgi verdiene i en config.ini-fil eller ved å bruke en <launcher>.ini-fil. Med de to siste
metodene er det mulig å tilpasse Eclipse uten å bruke kommandolinjeargumenter i det hele tatt.
For hvert argument på listen er den tilsvarende systemegenskapsnøkkelen vist (i {}). Eclipse-kjøretidslaget der
kommandolinjeargumentet blir behandlet, er også vist (i ()). Dette er nyttig hvis du skal erstatte deler av
kjøretiden for å tilpasse den spesielle behov.
- -application <id> (Kjøretid)
- tilsvarer å sette eclipse.application til <id>
- -arch <arkitektur> (OSGi)
- tilsvarer å sette osgi.arch til <arkitektur>
- -clean (OSGi)
- tilsvarer å sette osgi.clean til "true"
- -configuration <plassering> (Hoved)
- tilsvarer å sette osgi.configuration.area til <plassering>
- -console [port] (OSGi)
- tilsvarer å sette osgi.console til [port] eller den tomme strengen hvis
standardporten skal brukes (det vil si når porten ikke er oppgitt)
- -consoleLog (Kjøretid)
- tilsvarer å sette eclipse.consoleLog til "true"
- -data <plassering> (OSGi)
- tilsvarer å sette osgi.instance.area til <plassering>
- -debug [alternativfil] (OSGi)
- tilsvarer å sette osgi.debug til [alternativfil] eller den tomme strengen for
bare å aktivere feilsøking (det vil si hvis plasseringen av alternativfilen ikke er oppgitt)
- -dev [oppføringer] (OSGi)
- tilsvarer å sette osgi.dev til [oppføringer] eller den tomme strengen for bare å
aktivere dev-modus (det vil si hvis oppføringer ikke er oppgitt)
- -endSplash <kommando> (Hoved)
- angir kommandoen som skal brukes for å avslutte oppstartsbildet. Leveres vanligvis av den utførbare
Eclipse-filen.
- -feature <funksjon> (Kjøretid)
- tilsvarer å sette eclipse.product til <funksjons-ID>
- -framework <plassering> (Hoved)
- tilsvarer å sette osgi.framework til <plassering>
- -initialize (Hoved)
- initialiserer konfigurasjonen som kjøres. Alle kjøretidsrelaterte datastrukturer og hurtigbufre blir
oppdatert. Eventuelle bruker-/plugin-definerte konfigurasjonsdata blir ikke slettet. Ingen applikasjon blir kjørt,
alle produktspesifikasjoner blir ignorert, og ingen UI blir vist (det vil si oppstartsbildet blir ikke
tegnet)
- -install <plassering> (Hoved)
- tilsvarer å sette osgi.install.area til <plassering>
- -keyring <plassering> (Kjøretid)
- plasseringen til den autoriserte databasen på disken. Dette argumentet må brukes sammen med argumentet
-password.
- -name <streng> NEW
- navnet som skal vises på oppgavelinjen når applikasjonen startes. Når den ikke er oppgitt, er navnet det
samme som navnet på den utførbare filen.
- -nl <språkmiljø> (OSGi)
- tilsvarer å sette osgi.nl til <språkmiljø>
- -noExit (OSGi)
- tilsvarer å sette osgi.noShutdown til "true"
- -noLazyRegistryCacheLoading (Kjøretid)
- tilsvarer å sette eclipse.noLazyRegistryCacheLoading til
"true"
- -noRegistryCache (Kjøretid)
- tilsvarer å sette eclipse.noRegistryCache til "true"
- -noSplash (Utførbar, Hoved)
- styrer om oppstartsbildet blir vist eller ikke
- -os <operativsystem> (OSGi)
- tilsvarer å sette osgi.os til <operativsystem>
- -password <passord> (Kjøretid)
- passordet til autorisasjonsdatabasen
- -pluginCustomization <plassering> (Kjøretid)
- tilsvarer å sette eclipse.pluginCustomization til
<plassering>
- -product <id> (OSGi)
- tilsvarer å sette eclipse.product til <id>
- -showSplash <kommando> (Hoved)
- oppgir kommandoen som skal brukes for å vise oppstartsbildet. Leveres vanligvis av den utførbare
Eclipse-filen.
- -startup <plassering> (Utførbar) NEW
- plasseringen til JAR-filen som brukes til å starte Eclipse. Hovedklasseattributtet må være definert for JAR-filen
det refereres til. Hvis denne parameteren ikke er definert, blir startup.jar som ligger i samme mappe som den
utførbare filen, brukt.
- -user <plassering> (OSGi)
- tilsvarer å sette osgi.user.area til <plassering>
- -vm <bane til utførbar Java-fil> (Utførbar, Hoved)
- når dette alternativet sendes til den utførbare Eclipse-filen, blir det brukt til å finne
Java VM som skal brukes for å kjøre Eclipse. Det må være den fullstendige filsystembanen til en passende utførbar Java-fil. Hvis den
ikke er oppgitt, bruker den utførbare Eclipse-filen en søkealgoritme for å finne en passende VM. Den utførbare
filen sender ved hendelser banen til den faktiske VM som brukes for Java-hovedprogrammet, ved hjelp av argumentet
-vm. Java-hovedprogrammet lagrer da denne verdien i eclipse.vm.
- -vmargs [vmargs*] (Utførbar, Hoved)
- når dette alternativet sendes til Eclipse, tilpasses operasjonen av Java VM som skal brukes til å kjøre
Eclipse. Når dette alternativet brukes, må det stå til sist på en kommandolinje. Selv om den utførbare filen ikke er
oppgitt på den utførbare kommandolinjen, vil den automatisk legge til de relevante argumentene (inkludert klassen
som blir startet) på kommandolinjen som sendes til Java ved hjelp av argumentet -vmargs.
Java-hovedprogrammet
lagrer da denne verdien i eclipse.vmargs.
- -ws <vindussystem> (OSGi)
- tilsvarer å sette osgi.ws til <vindussystem>
Foreldede kommandolinjeargumenter
Følgende kommandolinjeargumenter er ikke lenger relevante eller er erstattet og blir brukt av kjøretiden og
ikke sendt videre til applikasjonen som kjøres for å vedlikeholde tilbakekompatibilitet .
- -boot
- se -configuration
- -classLoaderProperties
- ikke relevant lenger
- -firstUse
- ikke relevant lenger
- -newUpdates
- ikke relevant lenger
- -noPackagePrefixes
- ikke relevant lenger
- -noUpdate
- ikke relevant lenger
- -plugins
- ikke relevant lenger
- -update
- ikke relevant lenger
Andre
Følgende kommandolinjeargumenter er definert av forskjellige plugin-moduler for Eclipse og støttes bare hvis den
definerende plugin-modulen blir installert, behandlet og aktivert.
- -noVersionCheck (arbeidsbenk)
- <description>
- -perspective (arbeidsbenk)
- <description>
- -refresh (org.eclipse.core.resources)
- <description>
- -showLocation (org.eclipse.ui.ide.workbench)
- <description>
- -allowDeadlock
- <description>
Systemegenskaper
Følgende systemegenskaper blir brukt av Eclipse-kjøretiden. Legg merke til at de som begynner på
"osgi", er spesifikke for OSGi-rammeverkimplementeringen, mens de som begynner på "eclipse",
gjelder spesielt for Eclipse-kjøretidslaget over OSGi-rammeverket.
Mange av disse egenskapene har ekvivalenter på kommandolinjen (se seksjonen
kommandolinjeargumenter og verdien i klammeparentes {}). Brukere kan velge om de vil
bruke kommandolinjen eller egenskapsinnstillinger når de skal oppgi verdier. Egenskaper kan defineres på
følgende måter:
- bruk -DpropName=propValue som et VM-argument for Java VM
- definer ønsket egenskap i config.ini-filen i riktig konfigurasjonsområde
- eclipse.activateRuntimePlugins
- styrer aktiveringen av kjøretids-plugin-moduler. RCP-applikasjoner som ikke
trenger tjenester som leveres av kjøretids-plugin-moduler, kan definere denne egenskapen til
"false" for å unngå aktivering av kjøretids-plugin-moduler ved Eclipse-oppstart
- eclipse.application {-application}
- IDen for applikasjonen som skal kjøres. Verdien du oppgir her, overstyrer alle applikasjoner som er definert
av produktet (se eclipse.product) som kjøres
- eclipse.commands
- en liste skilt av nye linjer over alle kommandolinjeargumentene som sendes når Eclipse startes
- eclipse.consoleLog
- hvis "true", blir alle loggutdata også sendt til Javas System.out (vanligvis tilbake til
et eventuelt kommandoskall). Nyttig i kombinasjon med -debug
- eclipse.debug.startupTime
- tiden i millisekunder når Java VM for denne sesjonen ble startet
- eclipse.ee.install.verify
- hvis denne er satt til "true", vil rammen sjekke nødvendig utføringsmiljø ved buntinstallering.
Standardverdien er "false" (usann).
- eclipse.log.backup.max
- maksimalt tillatte antall reservekopiloggfiler. Den eldste reservekopiloggfilen blir slettet når maksimalt
antall reservekopiloggfiler blir nådd som et resultat av at loggfilen roteres.
Standardverdien er "10". En
negativ verdi eller null gjør at standardverdien blir brukt.
- eclipse.log.size.max
- maksimumsstørrelsen i kB som det er tillatt at loggfilen vokser til. Loggfilen blir rotert når
filstørrelsen overskrider maksimumsstørrelsen. Standardverdien er "1000".
En negativ verdi gjør at
standardverdien blir brukt. En null viser at det ikke er noen maksimumsstørrelse for loggen.
- eclipse.noExtensionMunging
- hvis "true", blir ikke de nedarvede registreringsutvidelsene forandret. Som standard blir slike
utvidelser oppdatert slik at de bruker de nye IDene for utvidelsespunkter i Eclipse 3.0.
- eclipse.noLazyRegistryCacheLoading {-noLazyRegistryCacheLoading}
- hvis "true", deaktiveres plattformens plugin-registerhurtigbuffer som laster inn optimalisering. Som
standard blir konfigurasjonselementene lastet inn fra registerhurtigbufferen (når tilgjengelig) bare ved behov,
slik at minnestørrelsen reduseres. Dette alternativet tvinger registerhurtigbufferen til å være fullt innlastet
ved oppstart.
- eclipse.noRegistryCache {-noRegistryCache}
- hvis "true", blir det interne utvidelsesregisteret verken lest eller skrevet
- eclipse.pluginCustomization {-pluginCustomization}
- filsystemplasseringen for en egenskapsfil som inneholder standardinnstillinger for
plugin-preferanser. Disse standardinnstillingene overstyrer standardinnstillingene
som er oppgitt for den primære funksjonen. Relative
baner oppfattes som relative i forhold til den gjeldende arbeidskatalogen for selve Eclipse.
- eclipse.product {-product}
- IDen for produktet som kjøres. Dette kontrollerer forskjellig merkevareinformasjon og hvilken applikasjon
som brukes.
- eclipse.service.jobs
- styrer registreringen av OSGi-tjenester. Defineres til "false"
for å holde tilbake registrering av OSGi-tjenester av plugin-modulen
org.eclipse.core.jobs
- eclipse.service.pref
- styrer registreringen av OSGi-tjenester. Defineres til "false"
for å holde tilbake registrering av OSGi-tjenester av plugin-modulen
org.eclipse.equinox.preferences
- eclipse.startTime
- denne egenskapen blir definert når Eclipse startes. Verdien til denne egenskapen er en strengrepresentasjon
av verdien som returneres av System.currentTimeMillis(). Denne verdien skal ikke defineres av brukeren.
- eclipse.stateSaveDelayInterval
- forsinkelsesintervallet (i millisekunder) for permanente statusendringsforespørsler.
Standardverdien er 30000 ms (30 sekunder). Statusendringsforespørsler forsinkes for hindre massive mengder av diskskriving mens det utføres
administrative oppgaver (f.eks. installing av bunter). Forsinkelsesintervallet brukes til å vente en viss tid med uvirksomhet før
rammestatusinformasjonen fortsetter.
- eclipse.vm {-vm}
- banen til den utførbare Java-filen som brukes til å kjøre Eclipse. Denne informasjonen brukes til å konstruere
kommandolinjer for å starte på nytt.
- eclipse.vmargs {-vmargs}
- viser VM-argumentene som brukes til å kjøre Eclipse. Denne informasjonen brukes til å konstruere
kommandolinjer for å starte på nytt.
- osgi.adaptor
- klassenavnet på OSGi-rammeverkadapteren som skal brukes.
- osgi.arch {-arch}
- se -arch
- osgi.baseConfiguration.area
- angir en basiskonfigurasjon som blir brukt når osgi.configuration.area
ikke er oppgitt.
- osgi.bundlefile.limit
- spesifiserer en grense på antll JAR-filer rammen vil holde åpen. Minste tillatt verdi er 10.
Standardverdien er ubegrenset.
- osgi.bundles
- en liste over bunter som automatisk blir installert, og som eventuelt kan startes, når systemet er oppe og
går. Listen bruker komma som skilletegn. Hver oppføring har denne formen:
<URL | simple bundle location>[@ [<startnivå>] [":start"]]
Hvis startnivået (>0 heltall) blir utelatt, vil rammeverket bruke standard startnivå for bunten. Hvis
"start"-koden blir lagt til, blir bunten merket som startet etter at den er installert.
Enkle
buntplasseringer blir tolket som relative i forhold til rammeverkets overordnede katalog.
Startnivået viser OSGi-startnivået
som bunten skal kjøres på. Hvis denne verdien ikke er definert, beregner systemet en passende standardverdi.
- osgi.bundles.defaultStartLevel
- dette er startnivået som alle bunter settes til hvis de installeres av Eclipse-oppdatering.
Buntene som spesifiseres på listen osgi.bundles, kan spesifisere et bestemt startnivå.
Hvis de ikke spesifiserer et startnivå, bruker de standardverdien for osgi.bundles.defaultStartLevel.
Standardverdien for osgi.bundles.defaultStartLevel er 4.
- osgi.clean
- hvis den er satt til "true", blir alle hurtigbufrede data som brukes av OSGi-rammeverket og
Eclipse-kjøretiden, fjernet. Dette vil rydde i hurtigbufrene som brukes til å lagre avhengighetsoppløsning for
bunter og Eclipse-utvidelsesregisterdata. Når du bruker dette alternativet, blir Eclipse tvunget til å
initialisere hurtigbufrene på nytt.
- osgi.configuration.cascaded
- hvis den er satt til "true", blir denne konfigurasjonen overført til en overordnet konfigurasjon. Den
overordnede konfigurasjonen er oppgitt av osgi.sharedConfiguration.area. Se seksjonen
plasseringer hvis du vil ha flere opplysninger.
- osgi.configuration.area {-configuration}
- konfigurasjonsplasseringen for denne kjøringen av plattformen. Konfigurasjonen bestemmer hvilke
plugin-moduler som skal kjøres, i tillegg til forskjellige andre systeminnstillinger.
Se seksjonen
plasseringer hvis du vil ha flere opplysninger.
- osgi.configuration.area.default
- standard konfigurasjonsplasseringen for denne kjøringen av plattformen. Konfigurasjonen bestemmer hvilke
plugin-moduler som skal kjøres, i tillegg til forskjellige andre systeminnstillinger.
Denne verdien (det vil si
standardinnstillingen) blir bare brukt hvis det ikke er definert noen verdi for osgi.configuration.area. Se seksjonen
plasseringer hvis du vil ha flere opplysninger.
- osgi.console {-console}
- hvis den er satt til en null-verdi, blir OSGi-konsollen aktivert (hvis installert).
Hvis verdien er et
passende heltall, blir den tolket som porten der konsollen lytter, og som utdataene blir sendt til. Nyttig for å undersøke tilstanden til systemet.
- osgi.console.class
- klassenavnet på konsollen som skal kjøres, hvis det blir bedt om det
- osgi.console.encoding
- hvis denne er definert, brukes den spesifiserte verdien som koding for konsollen
(se osgi.console). Hvis den ikke er definert, brukes verdien til egenskapen
file.encoding. Hvis file.encoding ikke er definert, brukes iso8859-1 som standard.
- osgi.contextClassLoaderParent
- klasselastertypen som skal brukes som overordnet klasselaster for kontekstens klasselaster som brukes av rammen.
Følgende
er gyldige typer:
- app - applikasjonsklasselasteren.
- boot - oppstartsklasselasteren.
- ext - utvidelsesklasselasteren.
- fwk - rammeverkklasselasteren.
- ccl - den opprinnelige kontekstens klasselaster som ble definert da rammen ble startet
(standardverdi).
- osgi.debug {-debug}
- hvis den er satt til en null-verdi, får plattformen feilsøkingsmodus. Hvis verdien er en streng, blir den
tolket som plasseringen av filen .options. Denne filen angir hvilke feilsøkingspunkter som er tilgjengelig for en plugin-modul, og om de er aktivert. Hvis
en plassering ikke er oppgitt, leter plattformen etter filen .options under installeringskatalogen.
- osgi.dev {-dev}
- hvis den er satt til en tom streng, blir dev-modus bare slått på. Denne egenskapen kan også settes til
klassebaneoppføringer skilt av komma som blir lagt til i klassebanen for hver plugin-modul, eller en URL til en
Java-egenskapsfil som inneholder tilpassede klassebanetillegg for et sett med plugin-moduler. For hver
plugin-modul som krever en tilpasset dev time-klassebane, vil filen inneholde en oppføring som har formen
<plug-in id>=<liste over klassebaneoppføringer som skal legges til, skilt av komma>
der plugin-IDen "*" samsvarer med en plugin-modul som ikke ellers er nevnt.
- osgi.filepermissions.command
- spesifiserer en valgfri OS-spesifikk kommando for å definere filtillatelser på ekstrahert intern kodet.
I noen operativsystemer kreves det at interne biblioteker defineres som utførbare.
Denne valgfrie egenskapen gjør det mulig for deg å oppgi kommando.
På et UNIX-basert operativsystem kan du for eksempel ha følgende verdi:
osgi.filepermissions.command="chmod +rx [fullpath]"
[fullpath] brukes som erstatning for den faktiske filbanen for rammen.
- osgi.framework
- URL-plasseringen for OSGi-rammeverket. Nyttig hvis Eclipse-installasjonen er atskilt. Se seksjonen
plasseringer hvis du vil ha flere opplysninger.
- osgi.frameworkClassPath
- en liste over klassebaneoppføringer for OSGi-rammeverkimplementeringen, skilt av komma.
Relative plasseringer
blir tolket som relative i forhold til rammeverkplasseringen (se osgi.framework)
- osgi.framework.extensions
- en liste over rammeverkutvidelser, skilt av komma. Hver oppføring har denne formen:
<simple bundle location>
Enkle buntplasseringer søkes det etter i overordnet katalog for bunten org.eclipse.osgi. Rammeverkutvidelse kan brukes til å kjøre Eclipse med en annen rammeverkadapter. Rammeverkutvidelsen
kan inneholde en eclipse.properties-fil for definering av systemegenskaper. En rammeverkutvidelse som har en
rammeverkadapterimplementering kan for eksempel oppgi hva adapterklassen er, ved å definere egenskapen osgi.adaptor.
- osgi.framework.shape
- definer formen på Eclipse OSGi-rammeverkimplementeringen. Denne egenskapen blir definert når
Eclipse-plattformen startes, og den skal ikke defineres av brukeren. Verdien "jar" viser at Eclipse
OSGi-rammeverket ligger i en enkelt JAR-fil. Verdien "folder" viser at Eclipse OSGi-rammeverket ligger i
en katalog.
- osgi.framework.library.extensions
- en liste (med komma som skilletegn) over ytterligere bibliotekfilutvidelser som det må søkes etter.
Hvis den ikke er definert, brukes bare biblioteknavnet som returneres av
System.mapLibraryName(String), i søket. Dette er nødvendig for visse operativsystemer som tillater flere enn en utvidelse for et bibliotek.
For eksempel tillater AIX bibliotekutvidelsene .a og .so, men
System.mapLibraryName(String) returnerer bare navn med utvidelsen .a.
- osgi.framework.useSystemProperties
- kontrollerer om rammeegenskapene støttes av de globale systemegenskapene eller oppbavares privat for hver forekomst av rammen.
Som standard støttes rammeegenskapene av systemegenskapene (f.eks. true).
Denne egenskapen er nyttig ved kjøring av flere forekomster av
OSGi-rammen innen samme VM der hver forekomst har et eget sett med konfigurasjonsegenskaper (f.eks.
satt i config.ini).
- osgi.genericAliases
- en liste (med komma som skilletegn) over generiske aliaser som kan brukes til å tilodne eksisterende manifesttopptekster
som kan brukes til å tilordne topptekster til
Eclipse-GenericCapability- og Eclipse-GenericRequire-manifesttopptekster. Egenskapen
osgi.genericAliases bruker følgende syntaks:
osgi.genericAliases ::= generic-alias ( ',' generic-alias ) *
generic-alias ::= capability-alias ':' require-alias ':' capability-type
For å tilordne OSGi-topptekstene Export-Service og Import-Service til
Eclipse-GenericCapability og Eclipse-GenericRequire trenger du følgende verdi:
osgi.genericAliases=Export-Service:Import-Service:osgi.service
- osgi.hook.configurators
- en liste (med komma som skilletegn) over bindingskonfigurasjoner.
Hvis denne egenskapen er definert, vil listen over spesifiserte konfigurasjoner være de eneste konfigurasjonene som brukes.
Alle bindingskonfiguratorer som er spesifisert i
hookconfigurators.properties-filer, blir ignorert.
- osgi.hook.configurators.include
- en liste (med komma som skilletegn) over tilleggsbindingskonfigurasjoner.
Denne ter nyttig for konfigurering av valgfrie bindingskonfiguratorer.
Dette alternativet ignoreres hvis alternativet osgi.hook.configurators er brukt.
- osgi.hook.configurators.exclude
- en liste (med komma som skilletegn) over bindingskonfigurasjoner som skal ekskluderes. Dette er nyttig for å deaktivere
bindingskonfiguratorer som er spesifisert i egenskapsfiler for bindingskonfiguratorer.
Dette alternativet ignoreres hvis alternativet osgi.hook.configurators er brukt.
- osgi.java.profile
- en URL til JRE-profilfilen som skal brukes. Den spesifiserte URLen leses som en
Java-egenskapsfil. En JRE-profil inneholder verdier for egenskapene
org.osgi.framework.system.packages, org.osgi.framework.bootdelegation og org.osgi.framework.executionenvironment.
Hvis osgi.java.profile ikke er definert,
blir det valgt en profil basert på verdien java.specification.version i en JRE som kjøres.
- osgi.java.profile.bootdelegation
-
en java-profil, osgi.java.profile, kan inneholde en
"org.osgi.framework.bootdelegation"-egenskap. Denne verdien kan brukes til å definere systemegenskapen "org.osgi.framework.bootdelegation". osgi.java.profile.bootdelegation
viser policyen for bootdelegation som skal brukes. Følgende verdier er gyldige (standardverdien blir ignorert):
- ignore - viser at verdien
"org.osgi.framework.bootdelegation" i Java-profilen skal ignoreres. Systemegenskapen
"org.osgi.framework.bootdelegation" skal brukes for å bestemme hvilke pakker som skal delegeres til
oppstart.
- override - viser at
"org.osgi.framework.bootdelegation" i Java-profilen skal overstyre systemegenskapen "org.osgi.framework.bootdelegation".
- none - viser at
"org.osgi.framework.bootdelegation" i Java-profilen OG systemegenskapene skal ignoreres. Dette er det
strengeste alternativet. Hvis du kjører med dette alternativet, bruker rammeverket den strenge delegeringsmodellen
for oppstart, OSGi R4.
- osgi.install.area {-install}
- installeringsstedet til plattformen. Denne innstillingen viser plasseringen av de grunnleggende
plugin-modulene for Eclipse og er nyttig hvis Eclipse-installeringen er atskilt. Se seksjonen
plasseringer hvis du vil ha flere opplysninger.
- osgi.instance.area {-data}
- plasseringen av forekomstdata for denne sesjonen. Plugin-moduler bruker denne plasseringen til å
lagre data. Plugin-moduler for ressurser bruker for eksempel dette som standardplasseringen for prosjekter (også
kalt arbeidsområde). Se seksjonen
plasseringer hvis du vil ha flere opplysninger.
- osgi.instance.area.default
- standardplasseringen av forekomstdata for denne sesjonen. Plugin-moduler bruker denne plasseringen til å
lagre data. Plugin-moduler for ressurser bruker for eksempel dette som standardplasseringen for prosjekter (også
kalt arbeidsområde). Denne verdien (det vil si standardinnstillingen) blir bare brukt hvis det ikke er definert
noen verdi for osgi.instance.area. Se seksjonen
plasseringer hvis du vil ha flere opplysninger.
- osgi.locking
- låsetypen som skal brukes for denne kjøringen av plattformen. De gyldige låsetypene er "java.io",
"java.nio" og "none". Standardverdien er "java.nio", med mindre JRE ikke støtter
"java.nio", da er standardverdien "java.io".
- osgi.manifest.cache
- plasseringen der genererte manifester blir oppdaget og generert. Standardverdien er konfigurasjonsområdet,
men manifesthurtigbufferen kan lagres separat.
- osgi.nl {-nl}
- navnet på språkmiljøet der Eclipse-plattformen skal kjøres. NL-verdiene skal følge standard
navngivningsregler for Java-språkmiljøet.
- osgi.nl.user
- navnet på språkmiljøet når brukeren eksplisitt legger til -nl i kommandolinjeargumenter.
- osgi.noShutdown {-noExit}
- hvis "true", avsluttes ikke VM når Eclipse-applikasjonen avsluttes. Dette er nyttig for å
undersøke OSGi-rammeverket etter at Eclipse-applikasjonen er avsluttet.
- osgi.os {-os}
- operativsystemverdien. Verdien skal være et av arkitekturnavnene for Eclipse-prosessoren som Eclipse kjenner
til (for eksempel x86, sparc, ...).
- osgi.parentClassloader
- klasselastertypen som skal brukes som overordnet klasselaster for alle bunter installert i rammeverket. Følgende
er gyldige typer:
- app - applikasjonsklasselasteren.
- boot - oppstartsklasselasteren.
- ext - utvidelsesklasselasteren.
- fwk - rammeverkklasselasteren.
- osgi.requiredJavaVersion
- Java-versjonen som minst kreves for å starte Eclipse. Standardverdien er "1.4.1".
- osgi.resolverMode
- modusen som er brukt til å behandle bunter installert i rammeverket. Verdien "strict" setter
behandleren i streng modus. Standard behandlermodus er ikke streng. Når behandleren er i streng modus, vil
rammeverket tvinge gjennom tilgangsbegrensningsregler når klasser og ressurser fra eksporterte
pakker som oppgir direktivene x-internal eller x-friends, blir lastet inn.
- osgi.sharedConfiguration.area
- den delte konfigurasjonsplasseringen for denne kjøringen av plattformen. Hvis
osgi.configuration.cascaded-egenskapen er satt til "true", blir
det delte konfigurasjonsområdet brukt som den overordnede konfigurasjonen.
- osgi.splashLocation
- den absolutte URL-plasseringen til oppstartsbildet (.bmp-filen) som skal vises når Eclipse starter. Denne
egenskapen overstyrer eventuelle verdier oppgitt i osgi.splashPath.
- osgi.splashPath
- en liste skilt med komma over URLer det skal søkes etter filen splash.bmp i. Denne egenskapen blir
overskrevet av eventuelle verdier definert i osgi.splashLocation.
- osgi.startLevel
- startnivåverdien som rammen blir satt til ved oppstart. Standardverdien er 6.
- osgi.support.signature.verify
- gyldige verdier er "true" og "false" standardverdien er "false". Når denne er satt til
"true", vil rammen laste inn sertifikater fra signerte JAR-filer og kontrollere at innholdet
ikke er ødelagt ved kjøring.
- osgi.syspath
- sett til banen der implementeringen av Eclipse OSGi-rammeverket (org.eclipse.osgi) ligger. For
eksempel "<eclipse-installeringsbane>/eclipse/plugins". Denne egenskapen blir definert når
Eclipse-plattformen startes, og den skal ikke defineres av brukeren.
- osgi.user.area {-user}
- plasseringen av brukerområdet. Brukerområdet inneholder data (for eksempel preferanser) som er
spesifikke for OS-brukeren, og som er uavhengig av installeringer, konfigurasjoner eller forekomster av Eclipse. Se seksjonen
plasseringer hvis du vil ha flere opplysninger.
- osgi.user.area.default
- standardplasseringen av brukerdataene. Brukerområdet inneholder data (for eksempel preferanser) som er
spesifikke for OS-brukeren, og som er uavhengig av installeringer, konfigurasjoner eller forekomster av Eclipse.
Denne verdien (det vil si standardinnstillingen) blir bare brukt hvis det ikke er definert noen verdi for
osgi.user.area. Se seksjonen
plasseringer hvis du vil ha flere opplysninger.
- osgi.ws {-ws}
- vindussystemverdien. Verdien skal være et av vindussystemnavnene for Eclipse som Eclipse kjenner til (for
eksempel win32, motif, ...).
Plasseringer
Eclipse-kjøretiden definerer en rekke plasseringer som gir utviklere av plugin-moduler konteksten for
lesing/lagring av data, og Eclipse-brukere kontroll over omfanget av datadeling og synlighet. Eclipse definerer
følgende plasseringsbegreper:
- User (-user) {osgi.user.area} [@none, @noDefault, @user.home, @user.dir,
filbane, url]
- Brukerplasseringer er spesifikke for brukere. Brukerplasseringen er vanligvis basert på verdien av
Java-systemegenskapen
user.home
, men den kan overstyres. Informasjon som for eksempel
brukeravgrensede preferanser og påloggingsinformasjon, kan ligge i brukerplasseringen.
- Install (-install) {osgi.install.area} [@user.home, @user.dir, filbane,
url]
- En installeringsplassering der selve Eclipse er installert. Denne plasseringen er i praksis katalogen
(vanligvis "eclipse") som er den overordnede katalogen for startup.jar eller eclipse.exe som kjøres. Denne
plasseringen skal anses som skrivebeskyttet for vanlige brukere, ettersom en installering kan deles av mange
brukere. Det er mulig å definere installeringsplasseringen og skille startup.jar fra resten av Eclipse.
- Configuration (-configuration) {osgi.configuration.area} [@none, @noDefault,
@user.home, @user.dir, filbane, url]
- Konfigurasjonsplasseringer inneholder filer som identifiserer og administrerer (del)settet av en
installering som skal kjøres. Dermed kan det være mange konfigurasjoner per installering.
Installeringer kan ha et
standard konfigurasjonsområde, men vanlige oppstartsscenarier innebærer at kjøretiden prøver å finne en mer
skrivbar konfigurasjonsplassering.
- Instance (-data) {osgi.instance.area} [@none, @noDefault, @user.home,
@user.dir, filbane, url]
- Forekomstplasseringer inneholder brukerdefinerte dataartefakter. Plugin-modulen for ressurser bruker for
eksempel forekomstområdet som arbeidsområdeplassering, og dermed standard hjemmekatalog for prosjekter. Andre
plugin-moduler kan skrive hvilke som helst filer i denne plasseringen.
Brukere kan definere alle disse plasseringene, men Eclipse vil beregne hensiktsmessige standardverdier hvis
verdiene ikke er oppgitt. Det som vanligvis brukes for å definere plasseringen, er forekomstområdet eller, i
IDE-kontekst, arbeidsområdet. Hvis du skal kjøre Eclipse-standardkonfigurasjonen på et bestemt datasett, kan du
oppgi:
eclipse -data c:\mydata
Mer informasjon
Plasseringer er URLer. For enkelhets skyld blir filbaner også godtatt og automatisk konvertert til file: URLer. For
bedre kontroll og av praktiske grunner er det også en rekke forhåndsdefinerte symbolske plasseringer som kan
brukes. Legg merke til at ikke alle kombinasjoner av plasseringstype og symbolsk verdi er gyldige. Tabellen
nedenfor viser hvilke kombinasjoner du kan ha. Fordi standardtilfellet er at alle plasseringene er definert,
gyldige og skrivbare, kan noen plugin-moduler mislykkes i andre konfigurasjoner selv om de står oppført som mulige. Det
er for eksempel urimelig å forvente at en plugin-modul som fokuserer på brukerdata (for eksempel
Eclipses plugin-modul for ressurser), skal gjøre noe særlig hvis forekomstområdet ikke er definert. Det er opp til
plugin-utviklere å velge hvilke konfigurasjoner de støtter, og utforme funksjonene i henhold til det.
- @none
- Viser at den tilsvarende plasseringen aldri skal defineres, verken eksplisitt eller som
standardverdien. En RCP-applikasjon som ikke har noe brukerdata, kan for eksempel bruke osgi.instance.area=@none
for å hindre at ukjente filer blir skrevet til disken. @none kan ikke etterfølges av andre banesegmenter.
- @noDefault
- Tvinger en plassering til å være udefinert eller eksplisitt definert (det vil si at Eclipse ikke automatisk
beregner en standardverdi). Dette er nyttig når du vil tillate data i den tilhørende plasseringen, men
Eclipse-standardverdien ikke egner seg. @noDefault kan ikke etterfølges av andre banesegmenter.
- @user.home
- Gjør at Eclipse beregner en plasseringsverdi som er relativ i forhold til brukerens hjemmekatalog. @user.home kan
etterfølges av andre banesegmenter. I alle tilfeller blir strengen "@user.home" bare erstattet av verdien
for Javas "user.home"-systemegenskap. Hvis du for eksempel oppgir
osgi.instance.area=@user.home/myWorkspace
får du verdien
file:/users/bob/myWorkspace
- @user.dir
- Gjør at Eclipse beregner en plasseringsverdi som er relativ i forhold til brukerens arbeidskatalog. @user.dir kan etterfølges av andre banesegmenter.
I alle tilfeller blir strengen "@user.dir" bare erstattet av verdien for Javas
"user.dir"-systemegenskap. Hvis du for eksempel oppgir
osgi.instance.area=@user.dir/myWorkspace
får du verdien
file:/usr/share/eclipse/myWorkspace
plassering/verdi |
støtter standardverdi |
fil/URL
|
@none
|
@noDefault
|
@user.home
|
@user.dir
|
forekomst
|
ja |
ja
|
ja
|
ja
|
ja
|
ja (standard)
|
konfigurasjon
|
ja
|
ja
|
ja*
|
ja*
|
ja
|
ja
|
installering
|
nei
|
ja
|
nei
|
nei
|
ja
|
ja
|
bruker
|
ja
|
ja
|
ja
|
ja
|
ja
|
ja
|
* viser at denne konfigurasjonen teknisk sett er mulig, men rent praktisk ganske vanskelig å administrere. Spesielt
gjelder dette Eclipse-kjøretiden, som uten en konfigurasjonsplassering kanskje bare kommer så langt at den starter
OSGi-rammeverket.
Skrivebeskyttede plasseringer
En plassering kan oppgis som en skrivebeskyttet plassering, ved å tilføye ".readOnly"
til plasseringsegenskapen og sette den til "true". Følgende egenskaper kan brukes til å oppgi de
tilhørende plasseringene som skrivebeskyttet:
Oppstarterens ini-fil
eclipse.exe og mer generelle utførbare filer for RCP-applikasjoner leser nå parameterne fra en tilknyttet ini-fil. Denne
filen har en plattformuavhengig måte å sende argumenter på som tidligere måtte oppgis direkte på kommandolinjen,
for eksempel VM eller VM-argumenter. Selv om du kan oppgi alle parametere i denne filen, anbefaler vi at du bare
oppgir VM-plasseringen og VM-argumentene i denne filen, og at du bruker config.ini-filen til andre
parametere. Dette er for å sikre vedlikehold og konsistens på tvers av forskjellig installasjoner.
Filformat
Filen må få navn etter den utførbare filen (eclipse.exe vil for eksempel lese eclipse.ini, mens launcher.exe
vil lese launcher.ini), og hver parameter må oppgis på en ny linje i filen. Her er et eksempel på en slik fil
som oppgir VM-plasseringen og noen parametere:
-vm
c:/myVm/java.exe
-vmargs
-Dms40M