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:
- Brug -DpropName=propValue som en VM-parameter til Java VM.
- Angiv den ønskede egenskab i filen config.ini i det relevante konfigurationsområde.
- 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:
- app - Program-classloader.
- boot - Boot-classloader.
- ext - Udvidelses-classloader.
- fwk - Ramme-classloader.
- ccl - Den oprindelige tekstklasseindlæser, der blev angivet, da strukturen startede (standardværdi).
- 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):
- ignore - Angiver, at værdien "org.osgi.framework.bootdelegation" i Java-profilen skal ignoreres. Systemegenskaben "org.osgi.framework.bootdelegation" bliver anvendt til at afgøre, hvilke pakker der skal delegeres til boot.
- override - Angiver, at "org.osgi.framework.bootdelegation" i Java-profilen skal overskrive systemegenskaben "org.osgi.framework.bootdelegation".
- none - Angiver, at "org.osgi.framework.bootdelegation" i Java-profilen OG systemegenskaberne skal ignoreres.
Det er den mest restriktive parameter. Udførelse af denne parameter medfører, at rammen anvender delegeringsmodellen OSGi R4 strict boot.
- 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:
- app - Program-classloader.
- boot - Boot-classloader.
- ext - Udvidelses-classloader.
- fwk - Ramme-classloader.
- 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