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:
- Použít -DpropName=propValue jako argument VM pro javový stroj VM.
- Nastavit požadovanou vlastnost v souboru config.ini v příslušné
konfigurační oblasti.
- 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"):
- ignore - Označuje, že hodnota
"org.osgi.framework.bootdelegation" v profilu java by se měla ignorovat. Vlastnost systému "org.osgi.framework.bootdelegation" bude použita k určení toho, které balíčky mají být delegovány ke spouštění.
- override - Označuje, že hodnota "org.osgi.framework.bootdelegation" v profilu java by měla potlačit vlastnost systému "org.osgi.framework.bootdelegation".
- none - Označuje, že hodnota
"org.osgi.framework.bootdelegation" v profilu java A ZÁROVEŇ vlastnosti systému by měly být ignorovány.
Toto je nejpřísnější volba. Spuštění s touto volbou způsobí, že rámec bude používat striktní model delegace spouštění OSGi R4.
- 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:
- app - Zaváděč tříd aplikace.
- boot - Zaváděč tříd spouštění.
- ext - Zaváděč tříd rozšíření.
- fwk - Zaváděč tříd Framework.
- 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