Eclipse Runtime-parametre

Version 3.2 - Sidst revideret den 8. maj 2006

Eclipse-platformen kan konfigureres på mange måder. Input til konfigurationen kan ske via kommandolinjeparametre og angivelse af systemindstillinger. I mange tilfælde er kommandolinjeparametrene ganske enkelt genveje til angivelse af de tilhørende systemindstillinger. Der er i virkeligheden mange flere systemindstillinger end kommandolinjeparametre.

Kommandolinjeparametre

Neden for vises de kommandolinjeparametre, der behandles af forskellige dele af Eclipse-programmet. Mange af disse værdier kan også angives ved hjælp af systemegenskaberne enten på kommandolinjen med parametrene -D VM ved at angive deres værdier i en config.ini-fil eller med en <launcher>.ini-fil. Bruges de to sidstnævnte teknikker kan Eclipse tilpasses uden brug af kommandolinjeparametre.

For hver parameter i oversigten er den tilhørende systemegenskabsnøgle givet (i {}). Eclipse-programlaget, hvor kommandolinjeparameteren behandles (i ()), er også givet. Dette er nyttigt for personer, der udskifter dele for at imødekomme særlige behov.

-application <id> (Runtime)
Det samme som at angive eclipse.application til <id>
-arch <arkitektur> (OSGi)
Det samme som at angive osgi.arch til <arkitektur>
-clean (OSGi)
Det samme som at angive osgi.clean til "true"
-configuration <placering> (primær)
Det samme som at angive osgi.configuration.area til <placering>
-console [port] (OSGi)
Det samme som at angive osgi.console til [port] eller den tomme streng, hvis standardporten skal anvendes (dvs. når porten ikke er angivet)
-consoleLog (Runtime)
Det samme som at angive eclipse.consoleLog til "true"
-data <placering> (OSGi)
Det samme som at angive osgi.instance.area til <placering>
-debug [parameterfil] (OSGi)
Det samme som at angive osgi.debug til [parameterfil] eller den tomme streng for at aktivere fejlfinding (dvs. hvis placeringen af parameterfilen ikke er angivet)
-dev [indgange] (OSGi)
Det samme som at angive osgi.dev til [indgange] eller den tomme streng for at aktivere dev-tilstand (dvs. hvis indgange ikke er aktiveret)
-endSplash <kommando> (primær)
Angiver den kommando, der skal bruges til at afslutte startskærmbilledet. Dette kommer typisk fra Eclipse-programfilen.
-feature <funktions-id> (Runtime)
Det samme som at angive eclipse.product til <feature id>
-framework <placering> (primær)
Det samme som at angive osgi.framework til <placering>
-initialize (primær)
Initialiserer den konfiguration, der udføres. Alle runtime-relaterede datastrukturer og cachelagre opfriskes. Evt. bruger-/plugin-definerede konfigurationsdata bliver ikke slettet. Intet program udføres, evt. produktspecifikationer ignoreres, og ingen brugergrænseflade præsenteres (dvs. startskærmbilledet vises ikke)
-install <placering> (primær)
Det samme som at angive osgi.install.area til <placering>
-keyring <placering> (Runtime)
Placeringen af autorisationsdatabasen på disken. Denne parameter skal bruges sammen med parameteren -password.
-name <streng> NEW
Det navn, der skal vises på opgavelinjen, når programmet startes. Hvis det ikke er angivet, er navnet på den eksekverbare fil.
-nl <locale> (OSGi)
Det samme som at angive osgi.nl til <locale>
-noExit (OSGi)
Det samme som at angive osgi.noShutdown til "true"
-noLazyRegistryCacheLoading (Runtime)
Det samme som at angive eclipse.noLazyRegistryCacheLoading til "true"
-noRegistryCache (Runtime)
Det samme som at angive eclipse.noRegistryCache til "true"
-noSplash (eksekverbar fil, primær)
Styrer, om startskærmbilledet vises
-os <styresystem> (OSGi)
Det samme som at angive osgi.os til <styresystem>
-password <kodeord> (Runtime)
Kodeordet til autorisationsdatabasen
-pluginCustomization <placering> (Runtime)
Det samme som at angive eclipse.pluginCustomization til <placering>
-product <id> (OSGi)
Det samme som at angive eclipse.product til <id>
-showSplash <kommando> (primær)
Angiver den kommando, der skal bruges til at vise startskærmbilledet. Dette kommer typisk fra Eclipse-programfilen.
-startup <placering> (programfil) NEW
Placeringen af den jar-fil, der anvendes til at starte eclipse. Attributten Main-Class skal være angivet for den jar, der henvises til. Hvis denne parameter ikke er angivet, anvendes den startup.jar, der er placeret i samme folder som den eksekverbare fil.
-user <placering> (OSGi)
Det samme som at angive osgi.user.area for <placering>
-vm <sti til eksekverbar java-fil> (eksekverbar fil, primær)
Når denne parameter overføres til den eksekverbare Eclipse-fil, bliver den anvendt til at finde den Java-VM, der skal bruges til at udføre Eclipse. Det skal være den fuldstændige filsystemsti til en passende eksekverbar Java-fil. Hvis den ikke angives, anvender den eksekverbare Eclipse-fil en søgealgoritme til at finde en passede VM. I begge tilfælde overfører den eksekverbare fil stien til den faktiske VM, der anvendes af Java Main, ved hjælp af parameteren -vm. Java Main gemmer derefter denne værdi i eclipse.vm.
-vmargs [vmargs*] (eksekverbar fil, primær)
Når denne indstilling videregives til Eclipse, tilpasser den funktionen af det Java VM, der bruges til at udføre Eclipse. Hvis indstillingen angives, skal den være placeret til sidst på kommandolinjen. Selvom den ikke er angivet på den eksekverbare kommandolinje, føjer den eksekverbare fil automatisk de relevante argumenter (herunder den klasse, der aktiveres) til den kommandolinje, der overføres til Java med parameteren -vmargs. Java Main gemmer derefter denne værdi i eclipse.vmargs.
-ws <vinduessystem> (OSGi)
Det samme som at angive osgi.ws til <vinduessystem>

Forældede kommandolinjeparametre

Følgende kommandolinjeparametre er ikke længere relevante eller er blevet erstattet. De anvendes af runtime og overføres ikke til det program, der udføres, for at vedligeholde bagudkompatibilitet. .

-boot
Se -configuration
-classLoaderProperties
Ikke længere relevant
-firstUse
Ikke længere relevant
-newUpdates
Ikke længere relevant
-noPackagePrefixes
Ikke længere relevant
-noUpdate
Ikke længere relevant
-plugins
Ikke længere relevant
-update
Ikke længere relevant

Andre

Følgende kommandolinjeparametre er defineret af forskellige Eclipse-plugins, og de understøttes kun, hvis den definerende plugin er installeret, behandlet og aktiveret.

-noVersionCheck (workbench)
<beskrivelse>
-perspective (workbench)
<beskrivelse>
-refresh (org.eclipse.core.resources)
<beskrivelse>
-showLocation (org.eclipse.ui.ide.workbench)
<beskrivelse>
-allowDeadlock
<beskrivelse>

Systemegenskaber

Følgende systemegenskaber anvendes af Eclipse-runtime. Bemærk, at de, der begynder med "osgi", er specifikke for OSGi-rammeimplementeringen, mens de, der begynder med "eclipse" er specielt til den Eclipse-runtime, der er placeret oven på OSGi-rammen.

Mange af disse egenskaber er de samme som parametre, der kan angives på kommandolinjen (se afsnittet Kommandolinjeparametre og værdien i krøllede parenteser {}). Brugere kan anvendes kommandolinjen eller egenskabsindstillinger til at angive en værdi. Egenskaber kan angives på følgende måder:

eclipse.activateRuntimePlugins
Styrer aktivering af runtime-plugins. RCP-programmer, der ikke kræver, at serviceprogramudbydere, der stilles til rådighed af runtime-plugins, kan angive denne indstilling som "false" for at undgå aktivering af runtime-plugins ved Eclipse-start.
eclipse.application {-application}
Id'en på det program, der skal udføres. Den værdi, der angives her, tilsidesætter et evt. program, der er defineret af det produkt (se eclipse.product), der udføres.
eclipse.commands
En liste adskilt af koder for ny linje over alle kommandolinjeparametre, der overføres, når Eclipse startes.
eclipse.consoleLog
Hvis værdien er "true", sendes evt. logoutput også til Javas System.out (typisk tilbage til en evt. shell til kommandoer). Praktisk ved kombination med -debug.
eclipse.debug.startupTime
Tidspunktet i millisekunder, da Java VM til denne session blev startet.
eclipse.ee.install.verify
Hvis den er angivet som "true", kontrollerer strukturen det påkrævede udførelsesmiljø på bundtinstallationstidspunktet. Standardværdien er "false".
eclipse.log.backup.max
Det tilladte maksimale antal logfiler til sikkerhedskopiering. Den ældste logfil til sikkerhedskopiering bliver slettet, når det maksimale antal logfiler til sikkerhedskopiering er nået som et resultat af logfilrotation. Standardværdien er "10". En negativ værdi eller en nulværdi medfører, at standardværdien bliver anvendt.
eclipse.log.size.max
Den maksimale størrelse i KB, som logfilen må vokse. Logfilen roteres, når den filstørrelsen overskrider den maksimale størrelse. Standardværdien "1000". En negativ værdi medfører, at standardværdien bliver anvendt. En nulværdi angiver, at der ikke er en maksimal logstørrelse.
eclipse.noExtensionMunging
Hvis værdien er "true", bliver registreringsudvidelsen bevaret som den er. Som standard bliver sådanne udvidelser opdateret, så de nye id'er for udvidelsespunkter i Eclipse 3.0 bliver anvendt.
eclipse.noLazyRegistryCacheLoading {-noLazyRegistryCacheLoading}
Hvis værdien er "true", deaktiveres optimeringen af registreringscacheindlæsningen til platformens plugin. Som standard bliver konfigurationselementer kun indlæst fra registreringscachen (hvis den er findes), når det er nødvendigt. Dermed reduceres brugen af hukommelsen. Denne parameter tvinger registreringscachen til at være fuldt indlæst ved start.
eclipse.noRegistryCache {-noRegistryCache}
Hvis værdien er "true", bliver den interne udvidelsesregistreringscache hverken læst eller skrevet
eclipse.pluginCustomization {-pluginCustomization}
Filsystemplaceringen af en egenskabsfil, der indeholder standardindstillinger for plugins. Disse standardindstillinger tilsidesætter de standardindstillinger, der er angivet i den primære funktion. Relative stier fortolkes i forhold til det aktuelle arbejdsbibliotek til selve Eclipse.
eclipse.product {-product}
Id'en på det produkt, der udføres. Dette styrer forskellige varemærkeoplysninger og hvilket program, der anvendes.
eclipse.service.jobs
Styrer registrering af OSGi-serviceprogrammer. Angiv som "false" for at undertrykke registrering af OSGi-Serviceprogrammer af plugin'en org.eclipse.core.jobs.
eclipse.service.pref
Styrer registrering af OSGi-serviceprogrammer. Angiv som "false" for at undertrykke registrering af OSGi-Serviceprogrammer af plugin'en org.eclipse.equinox.preferences.
eclipse.startTime
Denne egenskab angives på det tidspunkt, hvor Eclipse startes. Værdien af egenskaben er en strengrepræsentation af den værdi, der returneres af System.currentTimeMillis(). Det er ikke meningen, at brugere skal definere denne værdi.
eclipse.stateSaveDelayInterval
Forsinkelsesintervallet i millisekunder for at fastholde anmodninger om tilstandsændring. Standardværdien er 30000 ms (30 sekunder). Anmodninger om tilstandsændringer forsinkes for at forhindre massive skrivninger til disk under udførelse af administrative funktioner, f.eks. installation af bundter. Forsinkelsesintervallet anvendes til at vente i en periode med inaktivitet, før oplysningerne om strukturtilstanden fastholdes.
eclipse.vm {-vm}
Stien til den eksekverbare Java-fil, der anvendes til at udføre Eclipse. Disse oplysninger anvendes til at konstruere kommandolinjer til genstart.
eclipse.vmargs {-vmargs}
Viser de VM-parametre, der anvendes til udføre Eclipse. Disse oplysninger anvendes til at konstruere kommandolinjer til genstart.
osgi.adaptor
Klassenavnet på den OSGi-rammeadapter, der skal bruges.
osgi.arch {-arch}
Se -arch.
osgi.baseConfiguration.area
Angiver en basiskonfiguration, der anvendes, når osgi.configuration.area ikke er angivet.
osgi.bundlefile.limit
Angiver en grænse for antallet af jar-filer, som strukturen vil holde åbne. Den tilladte minimumsværdi er 10. Som standard er værdien ubegrænset.
osgi.bundles
Den kommaseparerede lister med bundter, som installeres automatisk, og som evt. startes, når systemet er aktivt. Indgangene har følgende format:
    <URL | enkelt bundplacering>[@ [<start-level>] [":start"]]
Hvis startniveauet (>0 heltal) udelades, anvender rammen standardstartniveauet til bundtet. Hvis koden "start" tilføjes, bliver bundtet valgte som startet, når det er blevet installeret. Enkle bundtplaceringer fortolkes som relative i forhold til rammens overordnede bibliotek. Startniveauet angiver det OSGi-startniveau, som bundtet skal udføres på. Hvis denne værdi ikke er angivet, beregnet systemet en passende standardværdi.
osgi.bundles.defaultStartLevel
Dette er det startniveau, som alle bundter angives til, hvis der installeres en opdatering til Eclipse. Bundter, der er angivet på listen osgi.bundles, kan angive et bestemt startniveau. Hvis de ikke angiver et startniveau, anvender de som standard værdien for osgi.bundles.defaultStartLevel. Standardværdien for osgi.bundles.defaultStartLevel er 4.
osgi.clean
Hvis denne værdi er angivet til "true", bliver evt. cachedata, der anvendes af OSGi-rammen og Eclipse-runtime, renset ud. Dermed tømmes de cachelagre, der bruges til at gemme bundafhængighedsbehandlinger og Eclipse-udvidelsesregistreringsdata. Brug af denne indstilling tvinger Eclipse til at geninitialisere disse cachelagre.
osgi.configuration.cascaded
Hvis værdien er "true", bliver denne konfiguration underlagt en overordnet konfiguration. Den overordnede konfiguration angives af osgi.sharedConfiguration.area. Der er flere oplysninger i afsnittet om placeringer.
osgi.configuration.area {-configuration}
Konfigurationsplaceringen for denne udførelse af platformen. Konfigurationen bestemmer, hvilke plugins skal udføres foruden forskellige andre systemindstillinger. Der er flere oplysninger i afsnittet om placeringer.
osgi.configuration.area.default
Standardkonfigurationsplaceringen for denne udførelse af platformen. Konfigurationen bestemmer, hvilke plugins skal udføres foruden forskellige andre systemindstillinger. Denne værdi (dvs. standardindstillingen) anvendes kun, hvis værdien for osgi.configuration.area er angivet. Der er flere oplysninger i afsnittet om placeringer.
osgi.console {-console}
Hvis denne er angivet til en ikke-nulværdi, bliver OSGi-konsollen (hvis den er installeret) aktiveret. Hvis værdien er et passende heltal, fortolkes det som den port, som konsollen lytter på, og output dirigeres til den angivne port. Praktisk i forbindelse undersøgelse af systemets tilstand.
osgi.console.class
Klassenavnet på den konsol, der skal udføres, hvis der bliver anmodet om det.
osgi.console.encoding
Hvis den er angivet, anvendes den angivne værdi som kodning til konsollen (se osgi.console). Hvis den ikke er angivet, anvendes værdien for egenskaben file.encoding. Hvis file.encoding ikke er angivet, anvendes iso8859-1 som standard.
osgi.contextClassLoaderParent
Den klasseindlæsningstype, der skal anvendes som den overordnede klasseindlæsning for kontekstklasseindlæseren, der anvendes af strukturen. Der er følgende gyldige typer:
osgi.debug {-debug}
Hvis denne er angivet til en ikke-nulværdi, bliver platformen sat i fejlfindingstilstand. Hvis værdien er en streng, fortolkes den som placeringen af filen .options. Denne fil angiver, hvilke fejlfindingspunkter der er tilgængelige for en plugin, og om de er aktiveret. Hvis der ikke er angivet en placering, søger platformen efter filen .options under installationsbiblioteket.
osgi.dev {-dev}
Hvis det er angivet til den tomme streng, bliver dev-tilstand ganske enkelt aktiveret. Egenskaben kan også angives til kommaseparerede classpath-indgange, som føjes til classpath'en for hver plugin eller en URL til en Java-egenskabsfil, der indeholder tilpassede classpath-tilføjelser for en gruppe plugins. For hver plugin, der kræver en tilpasset dev time-classpath, skal filen indeholde en indgang i formatet:
    <plugin-id>=<kommaseparareret liste over classpath-indgange, der skal tilføjes>
hvor plugin-id "*" matcher en vilkårlig plugin, der ikke ellers nævnes.
osgi.filepermissions.command
Angiver en valgfri OS-specifik kommando til angivelse af filtilladelser på udtrukket oprindelig kode. På visse styresystemer er det påkrævet at native-biblioteker angives for eksekvérbare programmer. Denne valgfri egenskab tillader dig at angive kommandoen. På et UNIX-OS kan du f.eks. have følgende værdi:
    osgi.filepermissions.command="chmod +rx [fuldstændig_sti"
[fuldstændig_sti] anvendes til at erstatte den aktuelle filsti med strukturen.
osgi.framework
URL-placeringen af OSGi-rammen. Praktisk, hvis Eclipse-installationen er blevet beskadiget. Der er flere oplysninger i afsnittet om placeringer.
osgi.frameworkClassPath
En kommaseparareret liste over classpath-indgange til implementeringen af OSGi-rammen. Relative placeringer fortolkes i forhold til placeringen af rammen (se osgi.framework)
osgi.framework.extensions
En kommasepareret liste med rammeudvidelser. Indgangene har følgende format:
    <enkel bundtplacering>
Der søges efter enkle bundtplaceringer i det overordnede bibliotek for bundtet org.eclipse.osgi. Rammeudvidelser kan anvendes til at udføre Eclipse med en anden rammeadapter. Rammeudvidelsen kan indeholde en eclipse.properties-fil, der angives systemegenskaber. F.eks. kan en rammeudvidelse, som indeholder implementeringen af rammeadapteren, angive hvad adapterklassen er ved at angive egenskaben osgi.adaptor.
osgi.framework.shape
Angives til udformningen af implementeringen af Eclipse OSGi-rammen. Denne egenskab angives, når Eclipse-platformen startes, og det er ikke meningen, at den skal angives af brugeren. Værdien "jar" angiver, at Eclipse OSGi-rammen findes i enkelt jar-fil. Værdien "folder" angiver, at Eclipse OSGi-rammen findes i et bibliotek.
osgi.framework.library.extensions
En kommasepareret liste for yderligere biblioteksfiltyper, der skal søges efter. Hvis den ikke er angivet, anvendes kun det biblioteksnavn, der returneres af System.mapLibraryName(String) til søgning. Dette er nødvendigt for bestemte styresystemer, der tillader mere end én filtype til et bibliotek. F.eks. tillader AIX-biblioteksudvidelser af .a og .so, men System.mapLibraryName(String) returnerer kun navne med .a-filtypen.
osgi.framework.useSystemProperties
Styrer, om strukturegenskaber sendes til baggrunden af de globale systemegenskaber eller holdes privat for hver forekomst af strukturen. Som standard sendes strukturegenskaberne til baggrunden af systemegenskaberne (dvs. true). Denne egenskab er nyttig, når der udføres et sæt konfigurationsegenskaber af OSGi-strukturen i samme VM, og hver forekomst har et separat sæt konfigurationsegenskaber, der f.eks. er angivet i config.ini.
osgi.genericAliases
En kommasepareret liste med generiske aliaser, der kan anvendes til at knytte eksisterende manifesttoptekster vha. mapping til Eclipse-GenericCapability- og Eclipse-GenericRequire-manifesttoptekster. Egenskaben osgi.genericAliases anvender følgende sytaks:
  osgi.genericAliases ::= generic-alias ( ',' generic-alias ) *
  generic-alias       ::= capability-alias ':' require-alias ':' capability-type
For f.eks. at tilknytte OSGi-topteksterne Export-Service- og Import-Service-topteksterne til Eclipse-GenericCapability- og Eclipse-GenericRequire-topteksterne vha. mapping skal du bruge den følgende værdi:
  osgi.genericAliases=Export-Service:Import-Service:osgi.service
osgi.hook.configurators
En kommasepareret liste over hookkonfiguratorer. Hvis denne egenskab er angivet, vil den angivne liste med konfiguratorer være de eneste konfiguratorer, der anvendes. Alle hookkonfiguratorer, der er angivet i hookconfigurators.properties-filer, ignoreres.
osgi.hook.configurators.include
En kommasepareret liste over yderligere hookkonfiguratorer. Dette er nyttigt til konfiguration af valgfri hookkonfiguratorer. Indstillingen ignoreres, hvis indstillingen osgi.hook.configurators anvendes.
osgi.hook.configurators.exclude
En kommasepareret liste over hookkonfiguratorer, der skal udelades. Dette er nyttigt ved deaktivering af hookkonfiguratorer, der er angivet i hookkonfiguratoregenskabsfiler. Indstillingen ignoreres, hvis indstillingen osgi.hook.configurators anvendes.
osgi.java.profile
En URL, JRE-profil-filen skal bruge. Den angivne URL læses som en Java-egenskabsfil. En JRE-profil indeholder værdier for egenskaberne org.osgi.framework.system.packages, org.osgi.framework.bootdelegation og org.osgi.framework.executionenvironment. Hvis osgi.java.profile ikke er angivet, vælges en profil baseret på værdien af java.specification.version til den igangværende JRE.
osgi.java.profile.bootdelegation
En Java-profil osgi.java.profile kan indeholde en "org.osgi.framework.bootdelegation"-egenskab. Denne værdi kan anvendes til at angive systemegenskaben "org.osgi.framework.bootdelegation". osgi.java.profile.bootdelegation angiver den politik, der skal bruges til bootdelegation. Følgende værdier er gyldige (standardværdien er ignore):
osgi.install.area {-install}
Installationsplaceringen for platformen. Denne indstilling angiver placeringen af basis-Eclipse-plugins, og den er nyttig, hvis Eclipse-installationen er beskadiget. Der er flere oplysninger i afsnittet om placeringer.
osgi.instance.area {-data}
Placeringen af data for forekomsten i denne session. Plugins anvender denne placering til at gemme deres data. F.eks. anvender Resources-plugins denne placering som standardplaceringen for projekter (også kaldet arbejdsområdet). Der er flere oplysninger i afsnittet om placeringer.
osgi.instance.area.default
Standardplaceringen af data for forekomsten i denne session. Plugins anvender denne placering til at gemme deres data. F.eks. anvender Resources-plugins denne placering som standardplaceringen for projekter (også kaldet arbejdsområdet). Denne værdi (dvs. standardindstillingen) anvendes kun, hvis værdien for osgi.instance.area er angivet. Der er flere oplysninger i afsnittet om placeringer.
osgi.locking
Låsningstypen, der skal bruges til denne udførelse af platformen. De gyldige låsningstyper er "java.io", "java.nio" og "none". Standardværdien er "java.nio", medmindre JRE ikke understøtter "java.nio". Hvis det er tilfældet, er "java.io" standardværdien.
osgi.manifest.cache
Den placering, hvor genererede manifester findes og genereres. Standardværdien er i konfigurationsområdet, men manifestcachen kan gemmes separat.
osgi.nl {-nl}
Navnet på den sprogkonvention, hvor Eclipse-platformen udføres. NL-værdier skal følge standardreglerne for navngivning af Java-sprogkonventioner.
osgi.nl.user
Navnet på sprogkonventionen, når brugeren eksplicit tilføjer -nl til kommandolinjeargumenter.
osgi.noShutdown {-noExit}
Hvis værdien er "true", afslutter VM ikke, når Eclipse-programmet er afsluttet. Dette er nyttigt ved undersøgelse af OSGi-rammen, når Eclipse-programmet er afsluttet.
osgi.os {-os}
Styresystemsværdien. Værdien skal være et af de navne på Eclipse-processorarkitekturen, som kendes af Eclipse (f.eks. x86, sparc, etc.).
osgi.parentClassloader
Den klasseindlæsningstype, der skal som den overordnede classloader for alle bundter, der er installeret i rammen. Der er følgende gyldige typer:
osgi.requiredJavaVersion
Den mindste Java-version, der kræves til at starte Eclipse. Standardværdien er "1.4.1".
osgi.resolverMode
Den tilstand, der anvendes til at behandle bundter, der er installeret i rammen. Hvis værdien er "strict", bliver resolveren sat i strict-tilstand. Standardresolvertilstanden er ikke strict. Når resolveren er i strict-tilstand, gennemtvinger rammen regler for adgangsbetingelse ved indlæsning af klasser og ressourcer fra eksporterede pakker, der angiver x-interne eller x-friends retningslinjer.
osgi.sharedConfiguration.area
Den delte konfigurationsplacering for denne udførelse af platformen. Hvis egenskaben osgi.configuration.cascaded er angivet til "true", anvendes det delte konfigurationsområde som den overordnede konfiguration.
osgi.splashLocation
Den fuldstændige URL-placering på det skærmbillede (.bmp-fil), der skal vises ved at start af Eclipse. Denne egenskab overskriver en evt. værdi, der er angivet i osgi.splashPath.
osgi.splashPath
En kommasepareret liste over URL'er, der skal søges efter en fil med navnet splash.bmp. Denne egenskab overskrives af en evt. værdi, der er angivet i osgi.splashLocation.
osgi.startLevel
Startniveauværdien, som strukturen angiver ved start. Standardværdien er 6.
osgi.support.signature.verify
Gyldige værdier er "true" eller "false". Standard er "false". Hvis værdien er angivet som "true" vil strukturen indlæse certifikater fra signerede JAR-filer og kontrollere, at indholdet ikke er ødelagt ved runtime.
osgi.syspath
Angiv til den sti, hvor implementeringen af Eclipse OSGi-rammen (org.eclipse.osgi) er placeret. Eksempel: "<Eclipse-installationssti>/eclipse/plugins". Denne egenskab angives, når Eclipse-platformen startes, og det er ikke meningen, at den skal angives af brugeren.
osgi.user.area {-user}
Placeringen af brugerområdet. Brugerområdet indeholder data (dvs. indstillinger), der er specifikke for styresystemsbrugeren og uafhængige af Eclipse-installation, -konfiguration eller -forekomst. Der er flere oplysninger i afsnittet om placeringer.
osgi.user.area.default
Standardplaceringen af brugerområdet. Brugerområdet indeholder data (dvs. indstillinger), der er specifikke for styresystemsbrugeren og uafhængige af Eclipse-installation, -konfiguration eller -forekomst. Denne værdi (dvs. standardindstillingen) anvendes kun, hvis værdien for osgi.user.area er angivet. Der er flere oplysninger i afsnittet om placeringer.
osgi.ws {-ws}
Værdien på vinduessystemet. Værdien skal være et af navnene på Eclipse-vinduessystemer, som kendes af Eclipse (f.eks. win32, motif, etc.).

Placeringer

Eclipse-runtime definerer et antal placeringer, som giver plugin-udviklere kontekst til læsning/lagring af data, og Eclipse-brugere kontrol over omfanget af datadeling og -synlighed. Eclipse definerer følgende placeringer:

User (-user) {osgi.user.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
Brugerplaceringer er specifikke for brugere. Typisk er brugerplaceringen baseret på værdien af Java-systemegenskaben user.home, men denne kan overskrives. Oplysninger om f.eks. brugerindstillinger og logon-oplysninger findes i brugerplaceringen.
Install (-install) {osgi.install.area} [@user.home, @user.dir, filepath, url]
Det sted, hvor selve Eclipse er installeret. I praksis er denne placering biblioteket (typisk "eclipse"), som er overordnet den startup.jar eller eclipse.exe, der udføres. Denne placering skal være skrivebeskyttet for almindelige brugere, da en installation kan deles af mange brugere. Det er muligt at angive installationsplaceringen og frakoble startup.jar fra resten af Eclipse.
Configuration (-configuration) {osgi.configuration.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
Konfigurationsplaceringer indeholder filer, der identificerer og styrer en (eller et udsnit af) installation, der skal udføres. Der kan være mange konfigurationer pr. installation. Installationer kan være leveret med et standardkonfigurationsområde, men de typiske startscenarier involverer, at runtime forsøger at finde en mere skrivbar konfigurationsplacering.
Instance (-data) {osgi.instance.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
Forekomstplaceringer indeholder brugerdefinerede dataelementer. F.eks. anvender plugin'en Resources forekomstområdet som arbejdsområdeplacering og dermed som standardhjemmeområde for projektet. Andre plugins kan skrive de filer, som de vil, på deres placering.

Mens brugere kan definere disse placeringer, beregner Eclipse rimelige standardværdier, hvis der ikke er angivet værdier. Den mest almindelige usecase til angivelse af placering er forekomstområdet eller arbejdsområdet i IDE-konteksten. Hvis du vil udføre standard-Eclipse-konfigurationen på et specifikt datasæt, kan du angive:

    eclipse -data c:\minedata

Flere oplysninger

Placeringer er URL'er. Af praktiske hensyn accepteres filstier også og konverteres automatisk til fil-URL'er. Der findes også et antal foruddefinerede symbolske placeringer, der kan anvendes. Bemærk, at ikke alle kombinationer af placeringstype og symbolsk værdi er gyldige. I tabellen nedenfor vises, hvilke kombinationer der er mulige. Da standardværdien er, at alle placeringer skal angives på en gyldig måde, og der skal kunne skrives til dem, kan nogle plugin'en muligvis ikke anvendes i andre konfigurationer, selvom de er angivet som mulige. F.eks. kan man ikke forvente, at en plugin, der er fokuseret på brugerdata (f.eks. Eclipse Resources-plugin'en), kan udføre noget, hvis forekomstområdet ikke er defineret. Det er udviklernes ansvar at vælge de konfigurationer, de understøtter, og udforme deres funktioner i henhold til dette.

@none
Angiver, at den tilhørende placering aldrig skal angives eksplicit eller til dens standardværdi. F.eks. et RCP-typeprogram, der ikke har nogen brugerdata, kan bruge osgi.instance.area=@none for at forhindre, at uvedkommende filer skrives til disken. @none må ikke efterfølges af yderligere stisegmenter.
@noDefault
Tvinger en placering til at være udefineret (dvs., at Eclipse ikke automatisk beregner en standardværdi). Det er nyttigt dér, hvor du vil tillade data i den tilhørende placering, men hvor Eclipse-standardværdien ikke kan anvendes. @noDefault må ikke efterfølges af yderligere stisegmenter.
@user.home
Angiver, at Eclipse skal beregne en placeringsværdi i forhold til brugeren hjemmebibliotek. @user.home kan efterfølges af yderligere stisegmenter. Under alle omstændigheder bliver strengen "@user.home" ganske enkelt erstattet med værdier af Java-systemegenskaben "user.home". Hvis der f.eks. angives
    osgi.instance.area=@user.home/myWorkspace
medfører det værdien
    file:/users/bob/myWorkspace
@user.dir
Angiver, at Eclipse skal beregne en placeringsværdi i forhold til det aktuelle arbejdsbibliotek. @user.dir kan efterfølges af yderligere stisegmenter. Under alle omstændigheder bliver strengen "@user.dir" ganske enkelt erstattet med værdier af Java-systemegenskaben "user.dir". Hvis der f.eks. angives
    osgi.instance.area=@user.dir/myWorkspace
medfører det værdien
    file:/usr/share/eclipse/myWorkspace
Placering/værdi
Understøtter standard
fil/URL
@none
@noDefault
@user.home
@user.dir
Forekomst
ja
ja
ja
ja
ja
ja (standardværdi)
Konfiguration
ja
ja
ja*
ja*
ja
ja
Installér
no
ja
no
no
ja
ja
Bruger
ja
ja
ja
ja
ja
ja

* angiver, at denne konfiguration er teknisk mulig, men i praksis vanskelig at administrere. Uden en konfigurationsplacering kan Eclipse-runtime kun komme så langt som til at starte OSGi-rammen.

Skrivebeskyttede placeringer

En placering kan angives som en skrivebeskytte placering ved at tilføje ".readOnly" til placeringsegenskaben og angive dens værdi til "true". Følgende egenskaber kan anvendes til at angive deres tilhørende placeringer som skrivebeskyttede.

Start-ini-fil

Filen eclipse.exe og generelle exe-filer til RCP-programmer læser nu deres parametre fra en tilknyttet ini-fil. Denne fil indeholder en platform-uafhængig måde at anvende argumenter på, som tidligere skulle angives direkte på kommandolinjen som f.eks. VM eller VM-argumenter. Selvom alle parametre kan angives i denne fil, anbefales det af hensyn til vedligeholdelse og konsistens på tværs af installationer kun at angive VM-placeringen og VM-argumenterne i denne ini-fil og bruge filen config.ini til andre.

Filformat

Filen skal navngives efter det eksekverbare navn (f.eks. skal eclipse.exe hedde eclipse.ini, og launcher.exe skal hedde launcher.ini) og alle parametre skal angives på en ny linje i filen. Eksempel på en fil, der angiver VM-placeringen og nogle parametre:

-vm
c:/myVm/java.exe
-vmargs
-Dms40M