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:

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