Běhové volby Eclipse

Verze 3.1 - Poslední revize 15.června 2005

Platforma Eclipse je velmi konfigurovatelná. Vstup pro konfiguraci je ve tvaru argumentů příkazového řádku a nastavení vlastností systému. V mnoha případech jsou argumenty příkazového řádku pouhou zkratkou k nastavení souvisejících vlastností systému. Ve skutečnosti existuje mnohem více nastavení vlastností systému než argumentů příkazového řádku.

Argumenty příkazového řádku

Níže jsou uvedeny argumenty příkazového řádku zpracovávané různými částmi běhové komponenty Eclipse. Mnoho z těchto hodnot lze také zadat pomocí vlastností systému na příkazovém řádku za použití argumentů -D VM, nebo uvedením těchto hodnot v souboru config.ini, případně použitím souboru <launcher>.ini. Za použití dvou naposledy jmenovaných způsobů lze přizpůsobit platformu Eclipse zcela bez použití argumentů příkazového řádku.

Pro každý argument seznamu je dán jeho odpovídající klíč vlastnosti systému (v {}). Rovněž je dána běhová vrstva Eclipse, ve které je zpracován argument příkazového řádku (v ()). To je užitečné pro ty, kteří nahrazují součásti běhové komponenty pro její přizpůsobení speciálním potřebám.

-application <id> (Runtime)
Rovnocenné s nastavením eclipse.application na <id>.
-arch <architektura> (OSGi)
Rovnocenné s nastavením osgi.arch na <architektura>.
-clean (OSGi)
Rovnocenné s nastavením osgi.clean na "true".
-configuration <umístění> (Main)
Rovnocenné s nastavením osgi.configuration.area na <umístění>.
-console [port] (OSGi)
Rovnocenné s nastavením osgi.console na [port] nebo prázdný řetězec, má-li být také použit výchozí port (tj. když není port specifikován).
-consoleLog (Runtime)
Ekvivalentní s nastavením eclipse.consoleLog na "true"
-data <location> (OSGi)
Rovnocenné s nastavením osgi.instance.area na <umístění>.
-debug [soubor voleb] (OSGi)
Rovnocenné s nastavením osgi.debug na [soubor voleb] nebo prázdný řetězec, má-li být pouze zpřístupněno ladění (tj. pokud není zadáno umístění souboru voleb).
-dev [položky] (OSGi)
Rovnocenné s nastavením osgi.dev na [položky] nebo prázdný řetězec, má-li být pouze zpřístupněn režim dev (tj. pokud nejsou zadány položky).
-endSplash <příkaz> (Main)
Určuje příkaz sloužící k sejmutí úvodní obrazovky. Zpravidla je dodáván spustitelným souborem Eclipse.
-feature <id funkce> (Runtime)
Rovnocenné s nastavením eclipse.product na <id funkce>.
-framework <location> (Main)
Rovnocenné s nastavením osgi.framework na <umístění>.
-initialize (Main)
Inicializuje spouštěnou konfiguraci. Všechny datové struktury a mezipaměti týkající se běhové komponenty jsou obnoveny. Jakákoli uživatelem/modulem plug-in definovaná konfigurační data nejsou vymazána. Není spuštěna žádná aplikace, všechny produktové specifikace jsou ignorovány a nedojde k prezentaci žádného uživatelského rozhraní (např. není vykreslena úvodní obrazovka).
-install <umístění> (Main)
Rovnocenné s nastavením osgi.install.area na <umístění>.
-keyring <umístění> (Runtime)
Umístění autorizační databáze na disku. Tento argument se musí použít spolu s parametrem -password.
-name <řetězec> NEW
Název, který se zobrazí v položce hlavního panelu při spuštění aplikace. Pokud není nastaven, použije se název spustitelného programu.
-nl <národní prostředí> (OSGi)
Rovnocenné s nastavením osgi.nl na <národní prostředí>.
-noExit (OSGi)
Ekvivalentní s nastavením osgi.noShutdown na "true"
-noLazyRegistryCacheLoading (Runtime)
Rovnocenné s nastavením eclipse.noLazyRegistryCacheLoading na "true".
-noRegistryCache (Runtime)
Rovnocenné s nastavením eclipse.noRegistryCache na "true".
-noSplash (Executable, Main)
Určuje, zda bude vykreslena úvodní obrazovka či nikoli.
-os <operační systém> (OSGi)
Rovnocenné s nastavením osgi.os na <operační systém>.
-password <heslo> (Runtime)
Heslo pro autorizační databázi.
-pluginCustomization <umístění> (Runtime)
Rovnocenné s nastavením eclipse.pluginCustomization na <umístění>.
-product <id> (OSGi)
Rovnocenné s nastavením eclipse.product na <id>.
-showSplash <příkaz> (Main)
Určuje příkaz sloužící k zobrazení úvodní obrazovky. Zpravidla je dodáván spustitelným souborem Eclipse.
-startup <umístění> (Executable) NOVÝ
Umístění souboru JAR použitého ke spuštění Eclipse. Soubor JAR, na který se zde odkazuje, musí mít nastaven atribut Main-Class. Pokud tento parametr není nastaven, použije se soubor startup.jar umístěný ve stejné složce jako spustitelný program.
-user <umístění> (OSGi)
Rovnocenné s nastavením osgi.user.area na <umístění>.
-vm <Cesta ke spustitelnému programu java> (Executable, Main)
Při přidání do spustitelného souboru Eclipse tato volba slouží k vyhledání javového VM a spuštění Eclipse. Musí jít o úplnou cestu v systému souborů k příslušnému spustitelnému programu Java. Není-li zadán, spustitelný soubor Eclipse použije vyhledávací algoritmus ke zjištění vhodného stroje VM. V každém případě pak spustitelný soubor předává cestu vlastnímu stroji VM používanému pro Java Main pomocí argumentu -vm. Java Main potom tuto hodnotu uloží do eclipse.vm.
-vmargs [vmargs*] (Executable, Main)
Při přidání do Eclipse tato volba slouží k přizpůsobení činnosti javového VM pro použití ke spuštění Eclipse. Je-li tato volba zadána, musí být na konci příkazového řádku. I když není zadána na příkazovém řádku spustitelného souboru, spustitelný soubor automaticky přidá příslušné argumenty (včetně spouštěné třídy) na příkazový řádek předaný do Javy pomocí parametru -vmargs. Java Main potom tuto hodnotu uloží do eclipse.vmargs.
-ws <systém oken> (OSGi)
Rovnocenné s nastavením osgi.ws na <systém oken>.

Zastaralé parametry příkazového řádku

Následující parametry příkazového řádku již nejsou relevantní nebo byly nahrazeny novými. Jsou spotřebovány běhovou komponentou a nejsou předávány do spouštěné aplikace kvůli zachování zpětné kompatibility. .

-boot
viz -configuration
-classLoaderProperties
již není relevantní
-firstUse
již není relevantní
-newUpdates
již není relevantní
-noPackagePrefixes
již není relevantní
-noUpdate
již není relevantní
-plugins
již není relevantní
-update
již není relevantní

Ostatní

Následující parametry příkazového řádku jsou definovány různými moduly plug-in platformy Eclipse a jsou podporovány pouze tehdy, když je nainstalován, vyřešen a aktivován definující modul plug-in.

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

Vlastnosti systému

Následující vlastnosti systému jsou používány běhovou komponentou Eclipse. Poznámka: vlastnosti začínající na "osgi" jsou specifické pro implementaci rámcového systému OSGi, zatímco vlastnosti začínající na "eclipse" se týkají běhové komponenty Eclipse navrstvené na rámcový systém OSGi.

Mnoho těchto vlastností disponuje ekvivalenty na příkazový řádek (viz oddíl argumenty příkazového řádku a hodnotu ve složených závorkách {}). Uživatelé mohou použít buď příkazový řádek nebo nastavení vlastností pro zadání hodnoty. Vlastnosti lze nastavit následujícími způsoby:

eclipse.application {-application}
Identifikátor spouštěné aplikace. Zde zadaná hodnota překryje jakoukoli aplikaci definovanou spouštěným produktem (viz eclipse.product).
eclipse.commands
Seznam všech argumentů příkazového řádku předávaných při spouštění Eclipse. Jednotlivé argumenty jsou odděleny znakem nového řádku.
eclipse.consoleLog
Pokud je "true", jakýkoli výstup protokolu je také odesílán do javového System.out (zpravidla zpět do případné příkazové nadstavby). Vhodné při kombinaci s parametrem -debug
eclipse.debug.startupTime
Čas v milisekundách, když byl spuštěn javový stroj VM pro tuto relaci.
eclipse.exitcode
<description>
eclipse.exitdata
<description>
eclipse.log.backup.max
Maximální počet záložních protokolových souborů, které budou povoleny. Při dosažení maximálního počtu záložních protokolových souborů bude nejstarší soubor odstraněn v důsledku rotování protokolového souboru. Výchozí hodnota je "10". Při nastavení záporné nebo nulové hodnoty se použije výchozí hodnota.
eclipse.log.size.max
Maximální velikost v kB, na kterou může protokolový soubor narůst. Když je maximální velikost dosažena, dojde k rotování protokolového souboru. Výchozí hodnota je "1000". Při nastavení záporné hodnoty se použije výchozí hodnota. Nastavením nulové hodnoty se zadá, že maximální velikost protokolu neexistuje.
eclipse.noExtensionMunging
Je-li "true", starší rozšíření registru jsou ponechána tak jak jsou. Standardně jsou taková rozšíření zaktualizována pro použití nových id bodů rozšíření, obsažených v Eclipse 3.0.
eclipse.noLazyRegistryCacheLoading {-noLazyRegistryCacheLoading}
Je-li "true", bude deaktivována optimalizace paměti cache pro zavádění registru modulů plug-in této platformy. Standardně jsou prvky konfigurace zaváděny z paměti cache registru (je-li k dispozici) pouze na vyžádání, což snižuje využitou paměť. Tato volba zajistí úplné načtení paměti cache registru při spuštění.
eclipse.noRegistryCache {-noRegistryCache}
Je-li "true", z paměti cache registru interních rozšíření nebude čteno ani do ní zapisováno
eclipse.pluginCustomization {-pluginCustomization}
Místo v souborovém systému se souborem vlastností obsahujícím výchozí nastavení pro předvolby modulu plug-in. Tato výchozí nastavení přepisují výchozí nastavení zadaná v primární funkci. Relativní cesty jsou interpretovány vzhledem k aktuálnímu pracovnímu adresáři vlastního eclipse.
eclipse.product {-product}
identifikátor spouštěného produktu. Řídí různé údaje o značení a jaká aplikace je používána.
eclipse.startTime
Tato vlastnost je nastavena na čas spuštění Eclipse. Hodnota této vlastnosti je řetězcovým vyjádřením hodnoty vracené voláním System.currentTimeMillis(). Tuto hodnotu uživatelé nenastavují.
eclipse.vm {-vm}
Cesta ke spustitelnému souboru Java používanému ke spuštění Eclipse. Tyto informace slouží k sestavování příkazových řádků pro další spouštění.
eclipse.vmargs {-vmargs}
Vypíše seznam argumentů VM používaných ke spuštění Eclipse. Tyto informace slouží k sestavování příkazových řádků pro další spouštění.
osgi.adaptor
Název třídy používaného adaptéru rámce OSGi.
osgi.arch {-arch}
viz -arch
osgi.baseConfiguration.area
Určuje základní konfiguraci, která se použije v případě, že není zadána osgi.configuration.area.
osgi.bundles
Čárkou oddělený seznam balíčků, jež jsou automaticky nainstalovány a volitelně spuštěny, jakmile je systém plně funkční. Každý záznam je ve tvaru:
    <URL | simple bundle location>[@ [<start-level>] [":start"]]
Je-li spouštěcí-úroveň (>0 integer) vynechána, rámcový systém použije výchozí spouštěcí úroveň balíčku. Pokud je přidána značka "start", balíček bude označen jako spuštěný po jeho nainstalování. Jednoduchá umístění balíčků jsou interpretována vzhledem k nadřazenému adresáři rámcového systému. Spouštěcí-úroveň označuje spouštěcí úroveň OSGi, na níž by měl být balíček spuštěn. Není-li tato hodnota nastavena, systém vypočítá vhodnou výchozí hodnotu.
osgi.clean
Je-li "true", jakákoli data v paměti cache používaná rámcovým systémem OSGi a běhovou komponentou eclipse budou dočista vymazána. Tím dojde k vyčištění pamětí cache používaných k ukládání rozpoznání závislostí balíčků a dat registru rozšíření modulu eclipse. Použití této volby přinutí eclipse znovu inicializovat tyto paměti cache.
osgi.configuration.cascaded
Je-li "true", tato konfigurace se postupně přenese do nadřazené konfigurace. Nadřazená konfigurace je zadána hodnotou osgi.sharedConfiguration.area. Další podrobnosti viz oddíl o umístěních.
osgi.configuration.area {-configuration}
Umístění konfigurace pro tento běh platformy. Konfigurace určuje, které moduly plug-in budou spuštěny, i různá další nastavení systému. Další podrobnosti viz oddíl o umístěních.
osgi.configuration.area.default
Výchozí umístění konfigurace pro tento běh platformy. Konfigurace určuje, které moduly plug-in budou spuštěny, i různá další nastavení systému. Tato hodnota (tj. výchozí nastavení) se používá pouze v případě, že není nastavena žádná hodnota pro osgi.configuration.area. Další podrobnosti viz oddíl o umístěních.
osgi.console {-console}
Při nastavení na hodnotu jinou než null bude zpřístupněna konzola OSGi (je-li nainstalována). Pokud je hodnota vhodným celým číslem, bude interpretována jako port, na němž konzola naslouchá a nasměruje svůj výstup na daný port. Vhodné pro zkoumání stavu systému.
osgi.console.class
Název třídy konzoly pro spuštění v případě žádosti
osgi.debug {-debug}
Při nastavení na hodnotu jinou než null bude platforma uvedena do režimu ladění. Pokud je hodnota řetězcem, bude interpretována jako umístění souboru .options. Tento soubor indikuje, které body ladění jsou pro modul plug-in k dispozici a zda jsou zpřístupněny či nikoli. Není-li umístění uvedeno, platforma vyhledá soubor .options v podadresářích instalačního adresáře.
osgi.dev {-dev}
Při nastavení na prázdný řetězec bude jednoduše zapnut režim dev. Tato vlastnost může být rovněž nastavena na čárkou oddělené položky cest ke třídám, jež budou přidány k cestě ke třídě každého modulu plug-in nebo URL k souboru vlastností Java obsahující vlastní dodatky cesty ke třídě pro sadu modulů plug-in. Pro každý modul plug-in vyžadující přizpůsobenou cestu ke třídě dev time bude soubor obsahovat položku ve tvaru
    <plug-in id>=<seznam přidávaných položek cest ke třídě (classpath) oddělených čárkami>
Kde id modulu plug-in "*" odpovídá libovolnému modulu plug-in, jenž nebyl jinak zmíněn.
osgi.framework
Adresa URL umístění rámce OSGi. Užitečné v případě, kdy instalace Eclipse není spojitá. Další podrobnosti viz oddíl o umístěních.
osgi.frameworkClassPath
Čárkou oddělený seznam položek cesty ke třídě pro implementaci rámce OSGi. Relativní umístění jsou interpretována vzhledem k umístění rámce (viz osgi.framework)
osgi.framework.extensions
Čárkou oddělený seznam rozšíření rámce Framework. Každý záznam je ve tvaru:
    <URL | jednoduché umístění balíku>
Pokud je zadáno jednoduché umístění balíku (nikoli adresa URL), bude se hledat v nadřazeném adresáři balíku org.eclipse.osgi. Lze použít rozšíření Framework ke spuštění Eclipse s jiným adaptérem rámce. Rozšíření rámce Framework může obsahovat soubor eclipse.properties pro nastavení vlastností systému. Například rozšíření rámce Framework poskytující implementaci adaptéru rámce může nastavením vlastnosti osgi.adaptor určit, jaká je třída adaptéru.
osgi.framework.shape
Nastaveno na tvar implementace OSGi Framework platformy Eclipse. Tato vlastnost se nastavuje při spuštění platformy Eclipse a uživatel by ji neměl nastavovat. Hodnota "jar" označuje, že OSGi Framework platformy Eclipse je obsažen v jednom souboru JAR. Hodnota "folder" označuje, že OSGi Framework platformy Eclipse je obsažen v adresáři.
osgi.java.profile
Adresa URL souboru profilu JRE, který se má použít. Profil JRE obsahuje hodnoty vlastností org.osgi.framework.system.packages a org.osgi.framework.bootdelegation. Pokud parametr osgi.java.profile není nastaven, vybere se profil na základě hodnoty java.specification.version běžícího JRE.
osgi.java.profile.bootdelegation
Profil osgi.java.profile může obsahovat vlastnost "org.osgi.framework.bootdelegation". Tuto hodnotu lze použít k nastavení vlastnosti systému "org.osgi.framework.bootdelegation". osgi.java.profile.bootdelegation označuje zásadu pro bootdelegation. Platné jsou následující hodnoty (výchozí nastavení je "ignore"):
osgi.install.area {-install}
Umístění instalace dané platformy. Toto nastavení určuje umístění základních modulů plug-in Eclipse a je užitečné tehdy, když instalace Eclipse není spojitá. Další podrobnosti viz oddíl o umístěních.
osgi.instance.area {-data}
Umístění dat instance pro tuto relaci. Moduly plug-in toto umístění používají k ukládání svých dat. Například modul plug-in Resources jej používá jako výchozí umístění projektů (neboli pracovní prostor). Další podrobnosti viz oddíl o umístěních.
osgi.instance.area.default
Výchozí umístění dat instance pro tuto relaci. Moduly plug-in toto umístění používají k ukládání svých dat. Například modul plug-in Resources jej používá jako výchozí umístění projektů (neboli pracovní prostor). Tato hodnota (tj. výchozí nastavení) se používá pouze v případě, že není nastavena žádná hodnota pro osgi.instance.area. Další podrobnosti viz oddíl o umístěních.
osgi.locking
Typ zamykání pro toto spuštění platformy. Platné typy zamykání jsou "java.io", "java.nio" a "none". Výchozí hodnotou je "java.nio", pokud JRE nepodporuje "java.nio", pak je výchozí hodnotou "java.io".
osgi.manifest.cache
Umístění, kde jsou generované soubory manifest zjištěny a vygenerovány. Výchozí nastavení je v konfigurační oblasti ale paměť cache pro manifest lze uložit odděleně.
osgi.nl {-nl}
Název národního prostředí, na němž bude platforma Eclipse spuštěna. Hodnoty NL by se měly řídit standardními pravidly pro pojmenování národního prostředí v jazyce Java.
osgi.noShutdown {-noExit}
Pokud je hodnota nastavena na "true", systém VM nebude po skončení aplikace Eclipse ukončen. To je užitečné chcete-li přezkoumat rámec OSGi po skončení aplikace Eclipse.
osgi.os {-os}
Hodnota operačního systému. Hodnotou by měl být jeden z názvů procesorových architektur rozpoznaných platformou Eclipse (např. x86, sparc atd.).
osgi.parentClassLoader
Typ zaváděče tříd, který se má používat jako nadřazený zaváděč tříd pro všechny balíky instalované ve Framework. Jsou platné tyto typy:
osgi.requiredJavaVersion
Minimální verze prostředí Java potřebná ke spuštění platformy Eclipse. Výchozí hodnota je "1.4.1".
osgi.resolverMode
Režim použitý k vyřešení balíků instalovaných ve Framework. Při nastavení hodnoty "strict" se resolver přepne do striktního režimu. Striktní režim není výchozím nastavením resolveru. Pokud je resolver ve striktním režimu, Framework si bude vynucovat pravidla omezení přístupu při načítání tříd a prostředků z exportovaných balíčků uvádějících direktivy x-internal a x-friends.
osgi.sharedConfiguration.area
Umístění sdílené konfigurace pro toto spuštění platformy. Pokud je vlastnost osgi.configuration.cascaded nastavena na "true", oblast sdílené konfigurace se bude používat jako nadřazená konfigurace.
osgi.splashLocation
Absolutní URL-umístění úvodní obrazovky (soubor .bmp) pro zobrazení při spouštění platformy Eclipse. Tato vlastnost překryje libovolnou hodnotu nastavenou v osgi.splashPath.
osgi.splashPath
Čárkou oddělený seznam adres URL určených k vyhledání souboru splash.bmp. Tato vlastnost překryje libovolnou hodnotu nastavenou v osgi.splashLocation.
osgi.syspath
Je nastavena na cestu, kde je umístěna implementace OSGi Framework (org.eclipse.osgi) platformy Eclipse. Například "<cesta instalace Eclipse>/eclipse/plugins". Tato vlastnost se nastavuje při spuštění platformy Eclipse a uživatel by ji neměl nastavovat.
osgi.user.area {-user}
Umístění uživatelské oblasti. Uživatelská oblast obsahuje data (např. předvolby) specifická pro OS uživatele a nezávislá na jakékoli instalaci, konfiguraci či instanci Eclipse. Další podrobnosti viz oddíl o umístěních.
osgi.user.area.default
Výchozí umístění uživatelské oblasti. Uživatelská oblast obsahuje data (např. předvolby) specifická pro OS uživatele a nezávislá na jakékoli instalaci, konfiguraci či instanci Eclipse. Tato hodnota (tj. výchozí nastavení) se používá pouze v případě, že není nastavena žádná hodnota pro osgi.user.area. Další podrobnosti viz oddíl o umístěních.
osgi.ws {-ws}
Hodnota systému oken. Hodnotou by měl být jeden z názvů systémů oken rozpoznaných platformou Eclipse (např. win32, motif atd.).

Umístění

Běhová komponenta Eclipse definuje počet umístění, jež vývojářům modulů plug-in poskytují kontext pro čtení/zápis dat a uživatelům Eclipse kontrolu nad rozsahem sdílení a viditelnosti dat. Eclipse definuje následující pojmy umístění:

User (-user) {osgi.user.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
Uživatelská umístění se týkají, což nepřekvapí, uživatelů. Uživatelské umístění je zpravidla založeno na hodnotě systémové vlastnosti user.home jazyka Java ale ta může být překryta. Informace týkající se záležitostí, jako jsou uživatelem vymezené předvolby a informace o přihlášení, lze nalézt v uživatelském umístění.
Install (-install) {osgi.install.area} [@user.home, @user.dir, filepath, url]
Umístění, kde je nainstalována vlastní platforma Eclipse. V praxi je toto umístění adresářem (zpravidla "eclipse"), který je nadřazen spuštěnému startup.jar nebo eclipse.exe. Toto umístění by mělo být považováno za pouze ke čtení pro běžné uživatele, protože instalace může být sdílena více uživateli. Je možné nastavit umístění instalace a odpojit startup.jar od zbytku platformy Eclipse.
Configuration (-configuration) {osgi.configuration.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
Umístění konfigurace obsahuje soubory, jež určují a spravují (pod)množinu spouštěné instalace. Na jednu instalaci může být více takových konfigurací. Instalace mohou obsahovat výchozí konfigurační oblast ale typické spouštěcí scénáře používají běhovou komponentu, jež zkouší najít konfigurační oblast schopnější pro zápis.
Instance (-data) {osgi.instance.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
Umístění instancí obsahují uživatelem definované datové artefakty. Například modul plug-in Resources používá oblast instance jako umístění pracovního prostoru a tím i výchozího adresáře pro projekty. Jiné moduly plug-in mohou do tohoto umístění volně zapisovat jakékoli požadované soubory.

Zatímco uživatelé mohou nastavit jakékoli z těchto umístění, platforma Eclipse vypočítá přiměřené předvolby v případě nezadání hodnot. Nejběžněji používaným případem nastavení umístění je instanční oblast - neboli pracovní prostor v kontextu IDE. Chcete-li spustit výchozí konfiguraci platformy Eclipse na určitou množinu dat, můžete zadat:

    eclipse -data c:\mydata

Další podrobnosti

Umístění jsou adresy URL. Pro jednoduchost jsou také akceptovány cesty k souboru a automaticky převedeny na URL typu file:. Kvůli lepšímu ovládání a pohodlí také existuje řada předdefinovaných symbolických umístění, jež lze použít. Všimněte si, že všechny kombinace typů umístění a symbolických hodnot nejsou platné. Níže uvedená tabulka určuje, které kombinace jsou možné. Protože výchozí případ je pro všechna nastavovaná umístění (platná a zapisovatelná), může u některých modulů plug-in dojít k selhání při instalaci (nastavení), i když jsou uvedeny jako možné. Například není možné realisticky předpokládat, že modul plugin zaměřený na uživatelská data (např. modul plug-in Resources v Eclipse) bude schopen nějaké činnosti, pokud nebude definována instanční oblast. Jde o úkol pro vývojáře modulu plug-in, aby vybral podporovaná nastavení a podle toho navrhl jejich funkci.

@none
Určuje, že odpovídající umístění by nikdy nemělo být nastaveno výslovně ani na jeho výchozí hodnotu. Například aplikace typu RCP, která nemá žádná uživatelská data, může použít osgi.instance.area=@none jako prevenci pro zápis cizorodých souborů na disk. Za @none nesmí následovat žádné další segmenty cesty.
@noDefault
Zajistí, aby umístění bylo výslovně definováno nebo nedefinováno (tj. Eclipse nebude automaticky počítat výchozí hodnotu). To je vhodné tam, kde chcete povolit data v odpovídajícím umístění, ale výchozí hodnota Eclipse nevyhovuje. Za @noDefault nesmí následovat žádné další segmenty cesty.
@user.home
Zajistí, že Eclipse vypočítá hodnotu umístění vzhledem k domovskému adresáři uživatele. Za @user.home mohou následovat další segmenty cesty. Ve všech případech je řetězec "@user.home" jednoduše nahrazen hodnotou systémové vlastnosti "user.home" jazyka Java. Například nastavení
    osgi.instance.area=@user.home/myWorkspace
zajistí výslednou hodnotu
    file:/users/bob/myWorkspace
@user.dir
Zajistí, že Eclipse vypočítá hodnotu umístění vzhledem k aktuálnímu pracovnímu adresáři. Za @user.dir mohou následovat další segmenty cesty. Ve všech případech je řetězec "@user.dir" jednoduše nahrazen hodnotou systémové vlastnosti "user.dir" jazyka Java. Například nastavení
    osgi.instance.area=@user.dir/myWorkspace
zajistí výslednou hodnotu
    file:/usr/share/eclipse/myWorkspace
umístění/hodnota
podporuje předvolbu
soubor/URL
@none
@noDefault
@user.home
@user.dir
instance
ano
ano
ano
ano
ano
ano (výchozí)
konfigurace
ano
ano
ano*
ano*
ano
ano
instalace
ne
ano
ne
ne
ano
ano
uživatel
ano
ano
ano
ano
ano
ano

* označuje, že toto nastavení je technicky možné ale z pragmatického hlediska obtížně spravovatelné. Zejména bez umístění konfigurace se může běhová komponenta Eclipse dostat jen tak daleko, že spustí rámcový systém OSGi.

Umístění určená pouze pro čtení

Umístění může být určeno pouze pro čtení tak, že se připojí ".readOnly" k vlastnosti umístění a nastaví se na hodnotu "true". Následující vlastnosti lze použít k nastavení odpovídajících umístění pouze pro čtení:

Soubor INI spouštěče

Program eclipse.exe a obecněji spustitelné soubory aplikací RCP nyní načítají své parametry z přidruženého souboru INI. Tento soubor nabízí na platformě nezávislý způsob předávání argumentů, které bylo dříve nutné zadávat přímo na příkazovém řádku, např. argumenty vm. Přestože lze v tomto souboru zadávat všechny parametry, z důvodu udržitelnosti a zajištění jednotnosti mezi různými instalacemi se doporučuje zadávat v tomto souboru INI pouze umístění vm a argumenty vm a pro ostatní používat soubor config.ini.

Formát souboru

Tento soubor musí být pojmenován podle názvu spustitelného programu (například pro eclipse.exe bude eclipse.ini, zatímco pro launcher.exe bude launcher.ini) a každý parametr musí být v souboru uveden na novém řádku. Zde je příklad takového souboru obsahujícího umístění vm a několik parametrů:

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