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:

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:
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):
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:
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