Eclipse Runtime-alternativen
Version 3.2 - Senast uppdaterad 8 maj 2006
Eclipse-plattformen har stora möjligheter för konfiguration. Konfiguration görs med hjälp av
kommandoradsargument och systemegenskapsinställningar. I många fall är
kommandoradsargumenten helt enkelt genvägar för inställning av de relaterade systemegenskaperna. Det finns många fler systemegenskapsinställningar än kommandoradsargument.
Kommandoradsargument
Nedan följer en lista med de kommandoradsargument som bearbetas av olika delar av Eclipse Runtime. Många av de här värdena kan även anges med hjälp av systemegenskaper, på kommandoraden med hjälp av -D VM-argument, genom att värden för dem anges i en config.ini-fil eller genom att en <launcher>.ini-fil används. Med hjälp av de två senare teknikerna är det möjligt att anpassa Eclipse utan att använda
kommandoradsargument överhuvudtaget.
För varje argument i listan anges motsvarande systemegenskapsnyckel (inom {}). Dessutom anges det Eclipse Runtime-lager där kommandoradsargumentet bearbetas (inom ()). Det är praktiskt för personer som vill byta ut delar av Runtime och göra anpassningar för särskilda behov.
- -application <id> (Runtime)
- motsvarar att ge eclipse.application
värdet <id>
- -arch <architecture> (OSGi)
- motsvarar att ge osgi.arch värdet <architecture>
- -clean (OSGi)
- motsvarar att ge osgi.clean värdet "true"
- -configuration <location> (Main)
- motsvarar att ge osgi.configuration.area
värdet <location>
- -console [port] (OSGi)
- motsvarar att ge osgi.console värdet [port]
eller en tom sträng om standardporten ska användas (dvs. när ingen port angetts)
- -consoleLog (Runtime)
- motsvarar att ge eclipse.consoleLog värdet
"true"
- -data <location> (OSGi)
- motsvarar att ge osgi.instance.area
värdet <location>
- -debug [options file] (OSGi)
- motsvarar att ge osgi.debug värdet [options
file] eller en tom sträng för att helt enkelt aktivera felsökning (dvs. om platsen för alternativfilen inte angetts)
- -dev [entries] (OSGi)
- motsvarar att ge osgi.dev värdet [entries] eller
en tom sträng för att helt enkelt aktivera dev-läge (dvs. om poster inte angetts)
- -endSplash <command> (Main)
- anger det kommando som ska användas till att stänga välkomstskärmen. Ingår vanligen i den körbara filen för Eclipse.
- -feature <feature id> (Runtime)
- motsvarar att ge eclipse.product
värdet <feature id>
- -framework <location> (Main)
- motsvarar att ge osgi.framework värdet
<location>
- -initialize (Main)
- initierar konfigurationen. Alla Runtime-relaterade datastrukturer och -cacheminnen uppdateras. Eventuella användar-/insticksprogramsdefinierade konfigurationsdata tas inte bort. Inga tillämpningar körs, eventuella produktspecifikationer ignoreras och inget användargränssnitt visas (till exempel ritas inte välkomstskärmen)
- -install <location> (Main)
- motsvarar att ge osgi.install.area värdet
<location>
- -keyring <location> (Runtime)
- platsen för auktoriseringsdatabasen på disken. Det här argumentet måste användas tillsammans med -password-argumentet.
- -name <string> NEW
- Det namn som ska visas i aktivitetsfältet när tillämpningen startas. Om det inte anges visas namnet på den körbara filen.
- -nl <locale> (OSGi)
- motsvarar att ge osgi.nl värdet <locale>
- -noExit (OSGi)
- motsvarar att ge osgi.noShutdown värdet "true"
- -noLazyRegistryCacheLoading (Runtime)
- motsvarar att ge eclipse.noLazyRegistryCacheLoading
värdet "true"
- -noRegistryCache
(Runtime)
- motsvarar att ge eclipse.noRegistryCache
värdet "true"
- -noSplash (Executable, Main)
- anger om välkomstskärmen visas
- -os <operating system> (OSGi)
- motsvarar att ge osgi.os värdet <operating system>
- -password <password> (Runtime)
- lösenordet till auktoriseringsdatabasen
- -pluginCustomization <location> (Runtime)
- motsvarar att ge eclipse.pluginCustomization värdet
<location>
- -product <id> (OSGi)
- motsvarar att ge eclipse.product värdet
<id>
- -showSplash <command> (Main)
- anger det kommando som ska användas till att visa välkomstskärmen. Ingår vanligen i den körbara filen för Eclipse.
- -startup <location> (Executable) NEW
- Platsen för den jar som används till att starta Eclipse. För den aktuella jar måste Main-Class-attributet ha angetts.
Om den parametern inte anges används den startup.jar som finns i samma mapp som den körbara filen.
- -user <location> (OSGi)
- motsvarar att ge osgi.user.area värdet <location>
- -vm <path to java executable> (Executable, Main)
- när det här alternativet överförs till den körbara filen för Eclipse används det till att söka efter den
Java VM som används till att köra Eclipse. Det måste vara den fullständiga filsystemsökvägen till en lämplig körbar fil för Java. Om den inte anges använder den körbara filen för Eclipse en sökalgoritm till att söka efter en lämplig VM. I vilket fall som helst överför sedan den körbara filen sökvägen till den VM som används till Java Main med -vm-argumentet. Java
Main lagrar sedan värdet i eclipse.vm.
- -vmargs [vmargs*] (Executable,
Main)
- när det här alternativet överförs till Eclipse används det till att anpassa funktionen för den
Java VM som används till att köra Eclipse. Om alternativet anges måste det stå i slutet av kommandoraden. Även om det inte anges på kommandoraden lägger den körbara filen automatiskt till relevanta argument (inklusive den klass som startas) till den kommandorad som överförs till Java med hjälp av -vmargs-argumentet.
Java Main lagrar sedan värdet i eclipse.vmargs.
- -ws <window system> (OSGi)
- motsvarar att ge osgi.ws värdet <window system>
Inaktuella kommandoradsargument
Följande kommandoradsargument är inte längre relevanta eller så har de ersatts och används i
Runtime och överförs inte till den tillämpning som körs för att upprätthålla bakåtkompatibilitet. .
- -boot
- se -configuration
- -classLoaderProperties
- inte längre relevant
- -firstUse
- inte längre relevant
- -newUpdates
- inte längre relevant
- -noPackagePrefixes
- inte längre relevant
- -noUpdate
- inte längre relevant
- -plugins
- inte längre relevant
- -update
- inte längre relevant
Övriga
Följande kommandoradsargument definieras av olika Eclipse-insticksprogram och kan användas endast om det insticksprogram som definierar det är installerat, tolkat och aktiverat.
- -noVersionCheck (workbench)
- <description>
- -perspective (workbench)
- <description>
- -refresh (org.eclipse.core.resources)
- <description>
- -showLocation (org.eclipse.ui.ide.workbench)
- <description>
- -allowDeadlock
- <description>
Systemegenskaper
Följande systemegenskaper används av Eclipse Runtime. Lägg märke till att de som börjar med "osgi" är specifika för OSGi-ramverksimplementeringen medan de som börjar med "eclipse" är ämnat för Eclipse Runtime som är ett lager på OSGi-ramverket.
Många av de här egenskaperna har kommandoradsmotsvarigheter (se avsnittet kommandoradsargument och värdena inom parentes {}). Användare kan ange värden med hjälp av kommandoraden eller egenskapsinställningarna. Egenskaper
kan
anges
på
följande
sätt:
- använd -DpropName=propValue som ett VM-argument för Java VM
- ange önskad egenskap i config.ini-filen i lämpligt konfigurationsområde
- eclipse.activateRuntimePlugins
- kontrollerar aktivering av runtime-insticksprogram. I RCP-tillämpningar som inte kräver tjänster som tillhandahålls av runtime-insticksprogram kan värdet "false" användas för den här egenskapen, så aktiveras inte runtime-insticksprogram när Eclipse startas.
- eclipse.application {-application}
- ID:t för den tillämpning som ska köras. Det värde som anges här åsidosätter en tillämpning som eventuellt definierats av den produkt (se eclipse.product) som körs
- eclipse.commands
- en radbrytningsavgränsad lista med alla kommandoradsargument som överförts när Eclipse startades
- eclipse.consoleLog
- om "true" anges skickas även eventuella loggutdata till Javas System.out (vanligen tillbaka till kommandoskalet om det finns något). Praktiskt i kombination med -debug
- eclipse.debug.startupTime
- tiden i millisekunder när Java VM för sessionen startades
- eclipse.ee.install.verify
- om "true" anges kontrollerar ramverket den nödvändiga körningsmiljön när samlingspaketet installeras. Standardvärdet är "false".
- eclipse.log.backup.max
- största tillåtna antal loggfiler för säkerhetskopiering. Den äldsta loggfilen för säkerhetskopiering tas bort när det största antalet loggfiler för säkerhetskopiering har uppnåtts som ett resultat av att loggfilen roteras.
Standardvärdet är "10". Om ett negativt värde eller värdet noll anges används standardvärdet.
- eclipse.log.size.max
- gräns i kB för hur mycket loggfilen kan växa. Loggfilen roteras när
gränsen för filstorleken uppnåtts. Standardvärdet är "1 000".
Om ett negativt värde anges används standardvärdet. Värdet noll anger att det inte finns någon begränsning för loggfilsstorleken.
- eclipse.noExtensionMunging
- om "true" anges ändras inte den gamla registerutökningen. Som standard uppdateras sådana utökningar så att de nya utökningspunkt-ID:na som finns i Eclipse 3.0 används.
- eclipse.noLazyRegistryCacheLoading {-noLazyRegistryCacheLoading}
- om "true" anges avaktiveras inläsningsoptimeringen för registercachefilen för insticksprogram i plattformen. Som standard läses konfigurationselement in från registercachefilen (när en sådan finns)
endast på begäran, vilket minskar minnesstorleken. När det här alternativet används måste registercachefilen vara helt inläst vid start.
- eclipse.noRegistryCache {-noRegistryCache}
- om "true" anges varken läses eller skrivs den interna utökningsregistercachefilen.
- eclipse.pluginCustomization {-pluginCustomization}
- filsystemplatsen för en egenskapsfil som innehåller standardinställningar för insticksprogram. De standardinställningarna åsidosätter de standardinställningar som angetts i huvudfunktionen. Relativa sökvägar tolkas relativt den aktuella arbetskatalogen för Eclipse.
- eclipse.product {-product}
- ID:t för den produkt som körs. Det styr diverse varumärkesinformation och vilken tillämpning som ska användas.
- eclipse.service.jobs
- kontrollerar registrering av OSGi-tjänster. Ange värdet "false" så registreras inte OSGi-tjänster av insticksprogrammet
org.eclipse.core.jobs
- eclipse.service.pref
- Kontrollerar registrering av OSGi-tjänster. Ange värdet "false" så registreras inte OSGi-tjänster av insticksprogrammet
org.eclipse.equinox.preferences
- eclipse.startTime
- Den här egenskapen anges när Eclipse startas. Värdet för egenskapen är en strängrepresentation av det värde som returneras av System.currentTimeMillis(). Det här värdet ska inte anges av användare.
- eclipse.stateSaveDelayInterval
- fördröjningsintervallet (i millisekunder) för begäran om ändring av permanent status. Standardvärdet är 30 000 ms (30 sekunder). Begäran om statusändring fördröjs för att förhindra stora mängder diskskrivåtgärder medan administrativa åtgärder utförs (till exempel installation av samlingspaket).
Fördröjningsintervallet används till att vänta på en period av inaktivetet innan statusinformationen för ramverket blir permanent.
- eclipse.vm {-vm}
- sökvägen till den körbara filen för Java som används till att köra Eclipse. Den här informationen används till att konstruera kommandorader för omstart.
- eclipse.vmargs {-vmargs}
- anger de VM-argument som används till att köra Eclipse. Den här informationen används till att konstruera kommandorader för omstart.
- osgi.adaptor
- klassnamnet för den OSGi-ramverksadapter som ska användas.
- osgi.arch {-arch}
- se -arch
- osgi.baseConfiguration.area
- anger en baskonfiguration som används när osgi.configuration.area inte har angetts.
- osgi.bundlefile.limit
- anger en gräns för det antal jar-filer som hålls öppna i ramverket.
Det minsta värdet är 10. Som standard är värdet obegränsat.
- osgi.bundles
- Den kommaavgränsade listan med samlingspaket som installeras automatiskt och kan startas när systemet väl är igång. Varje post har formatet:
<URL | simple bundle location>[@ [<start-level>] [":start"]]
Om startnivån (heltal >0) utelämnas använder ramverket standardstartnivån för samlingspaketet. Om märkordet "start" läggs till markeras samlingspaketet som startad när det installerats.
Enkla samlingspaketplatser tolkas som relativa ramverkets överordnade katalog.
Startnivån anger den OSGi-startnivå där samlingspaketet ska köras. Om det här värdet inte anges görs en beräkning av ett lämpligt standardvärde i systemet.
- osgi.bundles.defaultStartLevel
- det här är den startnivå som ställs in för alla samlingspaket om de installeras av Eclipse Update.
För samlingspaket som anges i listan osgi.bundles kan en viss startnivå anges.
Om ingen startnivå anges används värdet för osgi.bundles.defaultStartLevel som standard. Standardvärdet för osgi.bundles.defaultStartLevel är 4.
- osgi.clean
- om "true" anges tas eventuella cachelagrade data som används av OSGi-ramverket och Eclipse Runtime
bort. De cachefiler som används till att lagra beroendetolkning för samlingspaket och registerdata för Eclipse-utökningar töms. När det här alternativet används måste Eclipse initiera om de cachefilerna.
- osgi.configuration.cascaded
- om "true" anges överförs den här konfigurationen till en överordnad konfiguration. Den överordnade konfigurationen anges av osgi.sharedConfiguration.area. Mer information finns i avsnittet Platser.
- osgi.configuration.area {-configuration}
- konfigurationsplatsen för den här körningen av plattformen. Med konfigurationen anges vilka insticksprogram som ska köras förutom diverse andra systeminställningar.
Mer information finns i avsnittet Platser.
- osgi.configuration.area.default
- standardkonfigurationsplatsen för den här körningen av plattformen. Med konfigurationen anges vilka insticksprogram som ska köras förutom diverse andra systeminställningar.
Det här värdet (dvs. standardinställningen) används endast om inget värde för osgi.configuration.area har angetts. Mer information finns i avsnittet Platser.
- osgi.console {-console}
- om ett annat värde än null anges aktiveras OSGi-konsolen (om den är installerad).
Om värdet är ett lämpligt heltal tolkas det som den port som
konsolen avlyssnar och utdata styrs till den porten. Praktiskt för att kontrollera status för systemet.
- osgi.console.class
- klassnamnet för den konsol som ska köras vid begäran
- osgi.console.encoding
- om ett värdet anges används det värdet som kodning för konsolen (se
osgi.console). Om inget värde anges används värdet för egenskapen file.encoding. Om file.encoding inte anges används iso8859-1 som standard.
- osgi.contextClassLoaderParent
- den classloadertyp som ska användas som överordnad classloaderfunktion för den kontextclassloaderfunktion som används av ramverket. Giltiga typer:
- app - tillämpningsklassinläsaren.
- boot - startklassinläsaren.
- ext - utökningsklassinläsaren.
- fwk - ramverksklassinläsaren.
- ccl - den ursprungliga kontextclassloaderfunktion som angavs när ramverket startades (standardvärde).
- osgi.debug {-debug}
- om ett annat värde än null anges aktiveras felsökningsläget för plattformen. Om värdet är en sträng tolkas det som platsen för filen .options. Filen anger vilka felsökningspunkter
som är
tillgängliga
för ett insticksprogram och om de är aktiverade. Om ingen plats anges söker plattformen efter filen
.options i installationskatalogen.
- osgi.dev {-dev}
- om en tom sträng anges aktiveras helt enkelt dev-läget. Den här egenskapen
kan även vara kommaavgränsade klassökvägsposter
som har lagts till i
klassökvägen
för varje
insticksprogram eller en URL-adress till en Java-egenskapsfil som innehåller anpassade klassökvägstillägg
för en uppsättning insticksprogram. För varje insticksprogram som det krävs en anpassad utvecklarlägesklassökväg för finns i filen en post i följande format:
<plug-in id>=<comma separated list of classpath entries to add>
där insticksprograms-ID:t "*" överensstämmer med insticksprogram som inte annars nämns.
- osgi.filepermissions.command
- anger ett valfritt OS-specifikt kommando för inställning av filbehörigheter för extraherad intern kod. I vissa operativsystem krävs det att interna bibliotek ställs in som körbara. Den här valfria egenskapen gör det möjligt att ange kommandot.
I ett operativsystem av UNIX-typ kan du till exempel ha följande värden:
osgi.filepermissions.command="chmod +rx [fullpath]"
[fullpath] används till att ersätta den faktiska filsökvägen i ramverket.
- osgi.framework
- URL-adressen för OSGi-ramverket. Praktiskt om Eclipse-installationen är frånkopplad. Mer information finns i avsnittet Platser.
- osgi.frameworkClassPath
- en kommaavgränsad lista med klassökvägsposter för implementeringen av OSGi-ramverket.
Relativa platser tolkas som relativa ramverksplatsen
(se osgi.framework)
- osgi.framework.extensions
- en kommaavgränsad lista med ramverksutökningar. Varje post har formatet:
<plats för enkla samlingspaket>
En sökning av platser för enkla samlingspaket i den överordnade katalogen utförs av org.eclipse.osgi bundle. Ramverksutökningar kan användas till att köra Eclipse med en annan ramverksadapter. Ramverksutökningen kan innehålla en eclipse.properties-fil för systemegenskaper. Till exempel kan en ramverksutökning som tillhandahåller en ramverksadapterimplementering ange adapterklassen genom att ange egenskapen osgi.adaptor.
- osgi.framework.shape
- formen för implementeringen av Eclipse OSGi-ramverket anges. Den här egenskapen anges när Eclipse-plattformen startas och ska inte anges av användaren. Värdet "jar" anger att Eclipse OSGi-ramverket finns i en enskild jar. Värdet "folder" anger att Eclipse OSGi-ramverket finns i en katalog.
- osgi.framework.library.extensions
- en kommaavgränsad lista med extra biblioteksfilstilllägg som det måste göras en sökning efter. Om den inte anges används endast det biblioteksnamn som returneras av System.mapLibraryName(String) i sökningen. Det krävs för vissa
operativsystem där det går att använda fler än ett tillägg för bibliotek.
I till exempel AIX går det att använda bibliotekstilläggen .a och .so men
System.mapLibraryName(String) returnerar endast namn med tillägget .a.
- osgi.framework.useSystemProperties
- anger om ramverkegenskaperna backas upp av de globala systemegenskaperna eller lagras privat för varje förekomst av ramverket. Som standard backas ramverksegenskaperna upp av systemegenskaperna (till exempel true). Den egenskapen är praktisk när du kör flera förekomster av OSGi-ramverket i samma VM och varje förekomst har en separat uppsättning konfigurationsegenskaper (till exempel angivna i config.ini).
- osgi.genericAliases
- en kommaavgränsad lista med generiska alias som kan användas till att avbilda befintliga manifesthuvuden till manifesthuvudena Eclipse-GenericCapability och Eclipse-GenericRequire. För egenskapen osgi.genericAliases används följande syntax:
osgi.genericAliases ::= generic-alias ( ',' generic-alias ) *
generic-alias ::= capability-alias ':' require-alias ':' capability-type
Om du till exempel vill avbilda OSGi-rubrikerna Export-Service och Import-Service till
rubrikerna Eclipse-GenericCapability och Eclipse-GenericRequire använder du följande värde: osgi.genericAliases=Export-Service:Import-Service:osgi.service
- osgi.hook.configurators
- en kommaavgränsad lista med hook-konfigurationsfunktioner. Om den här egenskapen anges används endast listan med angivna konfigurationsfunktioner. Eventuella hook-konfigurationsfunktioner som angetts i filerna hookconfigurators.properties ignoreras.
- osgi.hook.configurators.include
- en kommaavgränsad lista med ytterligare hook-konfigurationsfunktioner. Det är praktiskt för konfiguration av valfria hook-konfigurationsfunktioner. Det här alternativet ignoreras om alternativet osgi.hook.configurators används.
- osgi.hook.configurators.exclude
- en kommaavgränsad lista med hook-konfigurationsfunktioner som ska utelämnas. Det är praktiskt för avaktivering av hook-konfigurationsfunktioner som har angetts i egenskapsfiler för hook-konfigurationsfunktioner. Det här alternativet ignoreras om alternativet osgi.hook.configurators används.
- osgi.java.profile
- en URL-adress till den JRE-profilfil som ska användas. Den angivna URL-adressen läses som en Java-egenskapsfil. En JRE-profil innehåller värden för egenskaperna org.osgi.framework.system.packages,
org.osgi.framework.bootdelegation och org.osgi.framework.executionenvironment. Om osgi.java.profile inte anges väljs en profil baserat på värdet java.specification.version för den JRE som körs.
- osgi.java.profile.bootdelegation
-
en osgi.java.profile-Java-profil kan innehålla egenskapen "org.osgi.framework.bootdelegation" property. Det här värdet kan användas till att ange systemegenskapen "org.osgi.framework.bootdelegation". osgi.java.profile.bootdelegation
anger regel för den bootdelegation som ska användas. Följande värden är giltiga (standardvärdet är ignore):
- ignore - anger att värdet "org.osgi.framework.bootdelegation" i Java-profile ska ignoreras.
Systemegenskapen "org.osgi.framework.bootdelegation" används till att ange vilka paket som ska delegeras för start.
- override -
anger att "org.osgi.framework.bootdelegation" i Java-profilen ska åsidosätta
systemegenskapen "org.osgi.framework.bootdelegation".
- none -
anger att "org.osgi.framework.bootdelegation" i Java-profilen OCH
systemegenskaperna ska ignoreras. Det här är det mest strikta alternativet.
När det alternativet är aktiverat använder ramverket
delegeringsmodellen för strikt start av OSGi R4.
- osgi.install.area {-install}
- installationsplatsen för plattformen. Den här inställningen anger att platsen för
allmänna Eclipse-insticksprogram och är praktisk om Eclipse-installationen är frånkopplad. Mer information finns i avsnittet Platser.
- osgi.instance.area {-data}
- platsen för förekomstdata för den här sessionen. Insticksprogram använder den här platsen till att lagra data. Till exempel använder insticksprogrammet för resurser den som standardplats för projekt (även kallad arbetsyta). Mer information finns i avsnittet Platser.
- osgi.instance.area.default
- standardplatsen för förekomstdata för den här sessionen. Insticksprogram använder den här platsen till att lagra data. Till exempel använder insticksprogrammet för resurser den som standardplats för projekt (även kallad arbetsyta). Det här värdet (dvs. standardinställningen) används endast om inget värde för osgi.instance.area har angetts. Mer information finns i avsnittet Platser.
- osgi.locking
- den låsningstyp som ska användas för den här körningen av plattformen. Giltiga låsningstyper är "java.io", "java.nio" och "none". Standardvärdet är
"java.nio" om inte JRE har funktioner för "java.nio". Om så är fallet är "java.io"
standardvärdet.
- osgi.manifest.cache
- den plats där genererade manifest upptäcks och genereras. Standardinställningen är
konfigurationsområdet men manifestcachefilen kan lagras på en separat plats.
- osgi.nl {-nl}
- namnet på den språkmiljö som ska användas för Eclipse-plattformen. NL-värden bör följa
standardnamnkonventioner för Java-språkmiljöer.
- osgi.nl.user
- namnet på språkmiljön när användaren explicit lägger till -nl till kommandoradsargumenten.
- osgi.noShutdown {-noExit}
- om "true" anges avslutas inte VM när Eclipse-tillämpningen har avslutats. Det är praktiskt för att undersöka OSGi-ramverket när Eclipse-tillämpningen har avslutats.
- osgi.os {-os}
- operativsystemvärdet. Värdet bör vara ett av de Eclipse-processorarkitekturnamn som är kända i Eclipse (till exempel x86, sparc, ...).
- osgi.parentClassloader
- den klassinläsartyp som ska användas som överordnad klassinläsare för alla samlingspaket som installerats i ramverket. Giltiga typer:
- app - tillämpningsklassinläsaren.
- boot - startklassinläsaren.
- ext - utökningsklassinläsaren.
- fwk - ramverksklassinläsaren.
- osgi.requiredJavaVersion
- Den lägsta Java-version som krävs för att starta Eclipse. Standardvärdet är
"1.4.1".
- osgi.resolverMode
- det läge som används till att tolka samlingspaket som installerats i ramverket. Om värdet "strict" anges används strikt läge för tolkningsfunktionen. Standardläge för tolkningsfunktionen är inte strikt läge. När tolkningsfunktionen är i strikt läge använder ramverket åtkomstbegränsningsregler när klasser och resurser läses in från exporterade paket som anger x-internal- eller x-friends-direktiven.
- osgi.sharedConfiguration.area
- den delade konfigurationsplatsen för den här körningen av plattformen. Om egenskapen
osgi.configuration.cascaded har värdet
"true" används ett delat konfigurationsområde som överordnad konfiguration.
- osgi.splashLocation
- den absoluta URL-adressen för välkomstskärmen (.bmp file) som visas när Eclipse startas. Den här egenskapen åsidosätter ett värde för osgi.splashPath.
- osgi.splashPath
- en kommaavgränsad lista med URL-adresser för sökning efter en fil med namnet splash.bmp. Den här egenskapen åsidosätts av ett värde för osgi.splashLocation.
- osgi.startLevel
- det startnivåvärde som anges för ramverket vid start. Standardvärdet är 6.
- osgi.support.signature.verify
- giltiga värden är "true" och "false". Standardvärdet är "false".
När "true" anges läser ramverket in certifikat från signerade jar-filer och kontrollerar att innehållet inte är skadat vid körning.
- osgi.syspath
- sökvägen för platsen för implementeringen av Eclipse OSGi-ramverket (org.eclipse.osgi). Till exempel "<eclipse install path>/eclipse/plugins". Den här egenskapen anges när Eclipse-plattformen startas och ska inte anges av användaren.
- osgi.user.area {-user}
- platsen för användarområdet. Användarområdet innehåller data (till exempel inställningar)
som är specifika för operativsystemsanvändaren och oberoende av Eclipse-installationer, -konfigurationer och -förekomster. Mer information finns i avsnittet Platser.
- osgi.user.area.default
- standardplatsen för användarområdet. Användarområdet innehåller data (till exempel inställningar)
som är specifika för operativsystemsanvändaren och oberoende av Eclipse-installationer, -konfigurationer och -förekomster. Det här värdet (dvs. standardinställningen) används endast om inget värde för osgi.user.area har angetts. Mer information finns i avsnittet Platser.
- osgi.ws {-ws}
- fönstersystemvärdet. Värdet bör vara ett av de Eclipse-fönstersystemnamn som är kända i Eclipse (till exempel win32, motif, ...).
Platser
I Eclipse Runtime definieras ett antal platser som ger utvecklare av insticksprogram
sammanhang för läsning/lagring av data och Eclipse-användare kontroll över
omfånget för datadelning och -synlighet. I Eclipse definieras följande platsbegrepp:
- User (-user) {osgi.user.area} [@none, @noDefault, @user.home, @user.dir,
filepath, url]
- Användarplatser är specifika för, som namnet antyder, användare. Vanligen baseras användarplatsen
på värdet för Java-systemegenskapen
user.home
men det kan åsidosättas. På användarplatsen finns information av typen användaromfångsinställningar och inloggningsinformation.
- Install (-install) {osgi.install.area} [@user.home, @user.dir, filepath,
url]
- En installationsplats är den plats där Eclipse är installerad. I praktiken är det den katalog (vanligen "eclipse") som är den överordnade katalogen för den startup.jar eller eclipse.exe som körs. Den här platsen bör vara skrivskyddad för vanliga användare eftersom en installation kan delas av många användare. Det är möjligt att ange installationsplats och koppla från startup.jar
från övriga Eclipse.
- Configuration (-configuration) {osgi.configuration.area} [@none, @noDefault,
@user.home, @user.dir, filepath, url]
- Konfigurationsplatser innehåller filer som identifierar och hanterar den delmängd av en
installation som ska köras. Det kan därför finnas många konfigurationer per installation.
Installationer kan ha ett standardkonfigurationsområde men i många startscenarion ingår att Runtime försöker hitta en mer skrivbar konfigurationsplats.
- Instance (-data) {osgi.instance.area} [@none, @noDefault, @user.home,
@user.dir, filepath, url]
- Förekomstplatser innehåller användardefinierade datatestobjektsamlingar. Till exempel använder
insticksprogrammet för resurser förekomstområdet som arbetsyteplats och följaktligen även som standardhem för projekt. Andra insticksprogram kan skriva vilka filer som helst till den här platsen.
Användare kan ange vilka som helst av de här platserna men om inga inställningar görs beräknar Eclipse lämpliga standardvärden. Den vanligaste inställningen för plats är förekomstområdet eller, i IDE-sammanhang, arbetsytan. Om du vill köra standardkonfigurationen för Eclipse för en viss datauppsättning kan du ange:
eclipse -data c:\mydata
Mer information
Platser är URL-adresser. För enkelhetens skull accepteras även filsökvägar som automatiskt konverteras till fil-URL-adresser. Det finns också ett antal fördefinierade
symboliska platser som kan användas, vilket ger bättre kontroll och större bekvämlighet. Observera att inte alla kombinationer av platstyp och symboliskt värde är giltiga. I tabellen nedan anges vilka kombinationer som är möjliga. Eftersom standardfallet är att alla platser anges, giltiga och skrivbara, fungerar vissa insticksprogram inte i andra konfigurationer trots att de har angetts som möjliga. Det är till exempel orimligt att förvänta sig att ett insticksprogram som fokuserar på användardata (till exempel insticksprogrammet Eclipse Resources) ska kunna fungera tillfredsställande om förekomstområdet inte har angetts. Det är upp till utvecklare av insticksprogram att välja de konfigurationer som ska gå att använda och utforma funktionen i enlighet med det.
- @none
- Anger att motsvarande plats aldrig bör anges antingen
explicit eller med standardvärdet för den. Till exempel kan en RCP-formattillämpning som inte har några
användardata använda osgi.instance.area=@none till att förhindra att överflödiga filer skrivs till disken. @none får inte följas av några fler sökvägssegment.
- @noDefault
- Anger att en plats ska vara odefinierad eller explicit definierad (dvs. Eclipse
beräknar inte automatiskt ett standardvärde). Det är praktiskt när du vill tillåta
data på motsvarande plats men standard-Eclipse-värdet inte är lämpligt. @noDefault får inte följas av några fler sökvägssegment.
- @user.home
- Anger att Eclipse ska beräkna ett platsvärde relativt användarens hemkatalog. @user.home kan följas av fler sökvägssegment. I alla fall ersätts strängen "@user.home" helt enkelt med värdet för systemegenskapen "user.home". Om du till exempel anger
osgi.instance.area=@user.home/myWorkspace
beräknas värdet
file:/users/bob/myWorkspace
- @user.dir
- Anger att Eclipse ska beräkna ett platsvärde relativt den aktuella arbetskatalogen. @user.dir kan följas av fler sökvägssegment. I alla fall ersätts strängen "@user.dir" helt enkelt med värdet för systemegenskapen "user.dir". Om du till exempel anger
osgi.instance.area=@user.dir/myWorkspace
beräknas värdet
file:/usr/share/eclipse/myWorkspace
plats/värde |
standardvärde kan användas |
fil/URL-adress
|
@none
|
@noDefault
|
@user.home
|
@user.dir
|
instance
|
ja |
ja
|
ja
|
ja
|
ja
|
ja (standard)
|
configuration
|
ja
|
ja
|
ja*
|
ja*
|
ja
|
ja
|
install
|
nej
|
ja
|
nej
|
nej
|
ja
|
ja
|
user
|
ja
|
ja
|
ja
|
ja
|
ja
|
ja
|
* anger att den här konfigurationen är tekniskt möjlig men i praktiken svår att genomföra. Till exempel utan konfigurationsplats kommer Eclipse Runtime inte längre än till att starta OSGi-ramverket.
Skrivskyddade platser
Du kan ange att en plats ska vara skrivskyddad genom att lägga till ".readOnly"
till platsegenskapen och ange värdet "true" för den. Följande egenskaper kan användas till att ange att motsvarande platser är skrivskyddade:
ini-fil för startverktyget
eclipse.exe och allmänna körbara filer för RCP-tillämpningar läser nu parametrar från en associerad ini-fil. Med hjälp av den här filen kan du, oberoende av plattform, överföra argument som tidigare måste anges direkt på kommandoraden som vm-plats eller vm-argument. Även om alla parametrar kan anges i den här filen bör du,med tanke på underhåll och enhetlighet mellan olika installationer, endast ange vm-plats och vm-argument i ini-filen och använda filen config.ini för andra.
Filformat
Filen måste namnges efter namnet på den körbara filen (till exempel läser eclipse.exe eclipse.ini medan launcher.exe läser launcher.ini) och varje parameter måste anges på en ny rad i filen. Här är ett exempel på en sådan fil som anger vm-plats och vissa parametrar:
-vm
c:/myVm/java.exe
-vmargs
-Dms40M