Běhové volby Eclipse
Verze 3.2 - Poslední revize 8.května 2006
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.activateRuntimePlugins
- Aktivace ovládacích prvků modulů plug-in běhového prostředí. Aplikace RCP, které nevyžadují služby poskytované běhovými moduly plug-in, mohou tuto vlastnost nastavovat na "false", aby se zabránilo aktivaci běhových modulů plug-in při spuštění platformy Eclipse
- 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.ee.install.verify
- V případě nastavení na hodnotu "true" rámec zkontroluje požadované prováděcí prostředí
v době instalace balíku. Výchozí hodnota je "false".
- 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.service.jobs
- Řídí registraci služeb OSGi. Nastavit na hodnotu "false" pro potlačení registrace služeb OSGi
modulem plug-in
org.eclipse.core.jobs
- eclipse.service.pref
- Řídí registraci služeb OSGi. Nastavit na hodnotu "false" pro potlačení registrace služeb OSGi
modulem plug-in
org.eclipse.equinox.preferences
- 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.stateSaveDelayInterval
- Interval zpoždění (v milisekundách) pro požadavky na změnu trvalého stavu. Výchozí hodnota je
30000 ms (30 sekund). Požadavky na změnu stavu jsou zpožďovány, aby se zabránilo nadměrnému množství
zápisů na disk při provádění administrativních operací (např. instalace balíků).
Interval zpoždění se používá k čekání na období nečinnosti před uchováním
informací o stavu rámce.
- 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.bundlefile.limit
- Určuje limit počtu souborů jar, které rámec ponechá otevřené.
Minimální povolená hodnota je 10. Ve výchozím nastavení je hodnota neomezená.
- 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řízené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.bundles.defaultStartLevel
- Jedná se o spouštěcí úroveň, na kterou budou všechny balíky nastaveny, pokud budou nainstalovány pomocí Eclipse Update.
Balíky určené na seznamu osgi.bundles mohou určovat konkrétní spouštěcí úroveň.
Pokud neurčují spouštěcí úroveň, nastaví se na výchozí hodnotu
osgi.bundles.defaultStartLevel. Výchozí hodnota osgi.bundles.defaultStartLevel je 4.
- 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řízené
konfigurace. Nadřízená 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.console.encoding
- Pokud je nastavena, použije se zadaná hodnota jako kódování pro konzolu (viz
osgi.console). Pokud není nastavena, použije se hodnota vlastnosti file.encoding.
Pokud hodnota file.encoding není nastavena, použije se jako výchozí hodnota iso8859-1.
- osgi.contextClassLoaderParent
- Typ classloader (zaváděč tříd) pro použití jako nadřízený zaváděč tříd zaváděče tříd kontextu
používaný rámcem. 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.
- ccl - původní zaváděč tříd kontextu,
který byl nastaven při spuštění rámce (výchozí hodnota).
- 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.filepermissions.command
- Označuje volitelný příkaz určitého operačního systému pro nastavení oprávnění k souboru v extrahovaném
nativním kódu. V některých operačních systémech se vyžaduje, aby nativní knihovny byly
nastaveny na spustitelný program. Tato volitelná vlastnost vám umožňuje určit daný příkaz.
Například v operačním systému typu UNIX můžete mít následující hodnotu:
osgi.filepermissions.command="chmod +rx [fullpath]"
Řetězec [fullpath] se používá k nahrazení aktuální cesty k souboru rámcem.
- 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:
<jednoduché umístění balíku>
Jednoduchá umístění balíků jsou vyhledávána v nadřízeném adresáři
org.eclipse.osgi bundle. 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.framework.library.extensions
- Čárkami oddělený seznam dodatečných přípon souboru knihovny,
která se musí vyhledat. Pokud není nastaven, použije se k hledání pouze název knihovny vrácený
System.mapLibraryName(String). To je potřebné pro
některé operační systémy, které umožňují použití více než jedné přípony pro knihovnu.
Například systém AIX umožňuje přípony knihoven .a a .so, ale
System.mapLibraryName(String) vrátí pouze názvy s příponou .a.
- osgi.framework.useSystemProperties
- Rozhoduje, zda jsou vlastnosti rámce zálohovány globálními vlastnostmi systému,
nebo uchovávány soukromě pro každou instanci rámce. Standardně jsou vlastnosti rámce
zálohovány vlastnostmi systému (např. true). Tato vlastnost je užitečná při spouštění
více instancí rámce OSGi v rámci stejného systému VM a každá instance má samostatnou
množinu konfiguračních vlastností (např. nastavenou v config.ini).
- osgi.genericAliases
- Čárkami oddělený seznam generických aliasů, které mohou být použity k mapování stávajících
záhlaví manifestů na záhlaví manifestů Eclipse-GenericCapability a Eclipse-GenericRequire. Vlastnost
osgi.genericAliases používá následující syntaxi:
osgi.genericAliases ::= generic-alias ( ',' generic-alias ) *
generic-alias ::= capability-alias ':' require-alias ':' capability-type
Například k mapování záhlaví OSGi Export-Service a Import-Service
na záhlaví Eclipse-GenericCapability a Eclipse-GenericRequire byste použili
následující hodnotu:
osgi.genericAliases=Export-Service:Import-Service:osgi.service
- osgi.hook.configurators
- Čárkami oddělený seznam konfigurátorů zapojení. Pokud je tato vlastnost nastavena,
seznam určených konfigurátorů bude obsahovat pouze použité konfigurátory. Konfigurátory zapojení
určené v souborech hookconfigurators.properties budou ignorovány.
- osgi.hook.configurators.include
- Čárkami oddělený seznam dodatečných konfigurátorů zapojení. Je užitečný pro
konfiguraci volitelných konfigurátorů zapojení. Tato volba je v případě použití volby
osgi.hook.configurators ignorována.
- osgi.hook.configurators.exclude
- Čárkami oddělený seznam konfigurátorů zapojení, které se mají vyloučit. Je užitečný pro znepřístupnění
konfigurátorů zapojení, které jsou určeny v souborech vlastností konfigurátorů zapojení. Tato volba je v případě použití volby osgi.hook.configurators ignorována.
- osgi.java.profile
- Adresa URL souboru profilu JRE, který se má použít. Zadaná adresa URL se přečte jako soubor vlastností prostředí Java. Profil JRE obsahuje hodnoty pro vlastnosti org.osgi.framework.system.packages,
org.osgi.framework.bootdelegation a org.osgi.framework.executionenvironment. 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.nl.user
- Název národního prostředí, když uživatel explicitně přidá -nl do argumentů příkazového řádku.
- 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řízený 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řízená 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.startLevel
- Hodnota spouštěcí úrovně, na kterou se rámec nastaví při spouštění. Výchozí hodnota je 6.
- osgi.support.signature.verify
- Platné hodnoty jsou "true" nebo "false", výchozí hodnota je "false".
Při nastavení hodnoty na "true" načte rámec certifikáty z podepsaných souborů jar a
ověří, zda obsah není v době běhu porušen.
- 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řízen
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 plug-in 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