Eclipse futási beállítások
3.1 változat - Utolsó felülvizsgált: 2005. június 15.
Az Eclipse platform rendkívül jól konfigurálható. A konfiguráció
bevitele parancssori paraméterek formájában és rendszertulajdonságok
megadásával történik. Számos esetben a parancssori paraméterek egyszerűen gyorsbillentyűk a
kapcsolódó rendszertulajdonságok megadására. A valóságban sokkal több rendszertulajdonság-beállítás létezik, mint
parancssori paraméter.
Parancssori paraméterek
Az alábbiakban az Eclipse futási környezet különböző részei által
feldolgozott parancssori paramétereket soroljuk fel. Ezek nagy része rendszertulajdonságokkal is meghatározható, vagy a
parancssorban a -D VM paraméterekkel, az értékek megadásával a
config.ini fájlban vagy egy <launcher>.ini fájl segítségével.
A két
utóbbi technika alkalmazásával a parancssori paraméterek használatának
teljes mellőzésével lehet személyre szabni az Eclipse-et.
A lista minden paraméteréhez meg van adva a megfelelő
rendszertulajdonság-kulcs (kapcsos zárójelek között). Megadtuk azt az
Eclipse futási réteget is, ahol a parancssori paraméter feldolgozásra
kerül (sima zárójelek között). Ez azok számára hasznos, akik le szeretnék cserélni a futási környezet
részeit valamilyen speciális igénynek megfelelően.
- -application <id> (futási környezet)
- megfelel annak, ha az
eclipse.application paraméter számára
<id> értéket adunk meg.
- -arch <architecture> (OSGi)
- megfelel annak, ha az osgi.arch paraméter
számára <architecture> értéket adunk meg.
- -clean (OSGi)
- megfelel annak, ha az osgi.clean paraméter
számára "true" értéket adunk meg.
- -configuration <location> (fő réteg)
- megfelel annak, ha az
osgi.configuration.area paraméter
számára <location> értéket adunk meg.
- -console [port] (OSGi)
- megfelel annak, ha az osgi.console
paraméter számára a [port] értéket adjuk meg, illetve egy üres
karaktersorozatot, ha az alapértelmezett portot kell használni (vagyis ha
a port nincs megadva).
- -consoleLog (futási környezet)
- megfelel annak, ha az
eclipse.consoleLog paraméter
számára "true" értéket adunk meg.
- -data <location> (OSGi)
- megfelel annak, ha az
osgi.instance.area paraméter számára
<location> értéket adunk meg.
- -debug [options fájl] (OSGi)
- megfelel annak, ha azosgi.debug
paraméter számára az [options fájl] értéket adjuk meg, vagy egy üres
karaktersorozatot, amellyel egyszerűen engedélyezzük a hibakeresést
(ha az options fájl helye nincs megadva).
- -dev [bejegyzések] (OSGi)
- megfelel annak, ha az osgi.dev paraméter
számára a [bejegyzések] értéket adjuk meg, vagy egy üres
karaktersorozatot, amellyel egyszerűen engedélyezzük a dev módot (ha
nincsenek megadva bejegyzések).
- -endSplash <command> (fő réteg)
- meghatározza, hogy milyen paranccsal tüntethető el a nyitóképernyő. Általában az Eclipse végrehajtható fájl adja meg.
- -feature <feature id> (futási környezet)
- megfelel annak, ha azeclipse.product
paraméter számára <feature id> értéket adunk meg.
- -framework <location> (Main)
- megfelel annak, ha az osgi.framework
paraméter számára <location> értéket adunk meg.
- -initialize (fő réteg)
- inicializálja a futtatott konfigurációt. Minden, a futási környezethez kapcsolódó adatstruktúra és gyorsítótár
frissítésre kerül. Semmilyen felhasználók vagy bedolgozók által megadott konfigurációs adat
nem kerül kiürítésre. Egyetlen alkalmazás sem fut, minden termékspecifikáció figyelmen kívül
hagyásra kerül, és semmilyen felhasználói felület sem jelenik meg (pl. nem
tűnik el a nyitóképernyő).
- -install <location> (fő réteg)
- megfelel annak, ha az
osgi.install.area paraméter számára
<location> értéket adunk meg.
- -keyring <location> (futási környezet)
- a hitelesítési adatbázis helye a lemezen. Ezt a paramétert együtt kell használni a -password paraméterrel.
- -name <string> NEW
- Az alkalmazás indításakor a feladatsoron megjelenítendő név. Ha nincs
beállítva, akkor a név a végrehajtható fájl neve.
- -nl <locale> (OSGi)
- megfelel annak, ha az osgi.nl paraméter
számára <locale> értéket adunk meg.
- -noExit (OSGi)
- megegyezik az osgi.noShutdown
"true" értékre állításával
- -noLazyRegistryCacheLoading (futási környezet)
- megfelel annak, ha az
eclipse.noLazyRegistryCacheLoading
paraméter számára "true" értéket adunk meg.
- -noRegistryCache (futási környezet)
- megfelel annak, ha az
eclipse.noRegistryCache paraméter
számára "true" értéket adunk meg.
- -noSplash (végrehajtható, fő réteg)
- azt vezérli, hogy a nyitóképernyő megjelenjen vagy ne jelenjen meg.
- -os <operating system> (OSGi)
- megfelel annak, ha az osgi.os <operating
system> értéket adunk meg.
- -password <password> (futási környezet)
- A hitelesítési adatbázis jelszava.
- -pluginCustomization <location> (futási környezet)
- megfelel annak, ha az
eclipse.pluginCustomization
paraméter számára <location> értéket adunk meg.
- -product <id> (OSGi)
- megfelel annak, ha azeclipse.product
paraméter számára <id> értéket adunk meg.
- -showSplash <command> (fő réteg)
- meghatározza, hogy milyen paranccsal jeleníthető meg a
nyitóképernyő. Általában az Eclipse végrehajtható fájl adja meg.
- -startup <location> (végrehajtható) NEW
- Az Eclipse indításához használt jar helye. A hivatkozott jar fájl
Main-Class attribútumát be kell állítani. Ha ez a paraméter nincs
beállítva, akkor az a startup.jar kerül felhasználásra, amelyik ugyanabban
a mappán található, mint a végrehajtható fájl.
- -user <location> (OSGi)
- megfelel annak, ha az
osgi.user.area paraméter számára
<location> értéket adunk meg.
- -vm <path to java executable> (végrehajtható, fő réteg)
- amikor átadásra kerül az Eclipse végrehajtható fájlnak, ez a
beállítás kerül felhasználásra az Eclipse-et futtató Java virtuális gép
megkeresésére. A megfelelő Java végrehajtható fájl teljes fájlrendszeri elérési útjának
kell lennie. Ha nincs megadva, az Eclipse végrehajtható fájl egy keresési algoritmust
használ a megfelelő virtuális gép felkutatására. Bármelyik esetben a végrehajtható fájl ezután átadja az elérési utat a
Java főréteg által használt aktuális virtuális gépnek a -vm paraméter
használatával. A Java főréteg ezután eltárolja ezt az értéket az
eclipse.vm-ben.
- -vmargs [vmargs*] (végrehajtható, fő)
- amikor átadásra kerül az Eclipse-nek, ez a beállítás kerül
felhasználásra az Eclipse-et futtató Java virtuális gép tevékenységének
személyre szabására. Ha meg van adva, akkor ennek a beállításnak a parancssor végén kell
jönnie. Még ha nincs is megadva a végrehajtható parancssorban, a végrehajtható
fájl automatikusan hozzáadja a fontos paramétereket (köztük az elindított
osztályt) a -vmargs paraméterrel a Javába továbbított parancssorhoz.
A Java főréteg ezután eltárolja ezt az értéket az
eclipse.vmargs-ban.
- -ws <window system> (OSGi)
- megfelel annak, ha az osgi.ws paraméter
számára <window system> értéket adunk meg.
Elavult parancssori paraméterek
A következő parancssori paraméterek már nem relevánsak vagy
meghaladottak, azokat a futási környezet felemésztette és nem kerültek
átadásra a futtatott alkalmazásnak a visszamenőleges kompatibilitás
fenntartására. .
- -boot
- lásd: -configuration
- -classLoaderProperties
- már nem releváns
- -firstUse
- már nem releváns
- -newUpdates
- már nem releváns
- -noPackagePrefixes
- már nem releváns
- -noUpdate
- már nem releváns
- -plugins
- már nem releváns
- -update
- már nem releváns
Egyebek
A következő parancssori paramétereket különféle Eclipse bedolgozók
határozzák meg, és csak akkor támogatottak, ha a meghatározó bedolgozó
telepítve van, valamint feloldva és aktiválva.
- -noVersionCheck (munkaterület)
- <description>
- -perspective (munkaterület)
- <description>
- -refresh (org.eclipse.core.resources)
- <description>
- -showLocation (org.eclipse.ui.ide.workbench)
- <description>
- -allowDeadlock
- <description>
Rendszertulajdonságok
A következő rendszertulajdonságokat az Eclipse használja. Figyeljen rá, hogy az "osgi" szóval kezdődők az OSGi
keretrendszer-implementációra jellemzők, míg az "eclipse"
kezdetűek az OSGi keretrendszer fölött elhelyezkedő Eclipse futási
környezet szempontjából különlegesek.
Ezek közül a tulajdonságok közül sok rendelkezik parancssori paraméter
megfelelővel (lásd a parancssori paraméterek
részt, valamint a kapcsos zárójelben található értékeket). A felhasználók szabadon választhatnak aközött, hogy a parancssort vagy a
tulajdonságbeállítást használják egy adott érték megadására. A tulajdonságok a következő módokon állíthatók be:
- használja a -DpropName=propValue a Java virtuális gép VN
paramétereként.
- állítsa be a kívánt tulajdonságot a megfelelő konfigurációs terület
config.ini fájljában.
- eclipse.application {-application}
- a futtatandó alkalmazás azonosítója. Az itt megadott érték felülír minden, a futtatott termék által
(lásd: eclipse.product) meghatározott
alkalmazást
- eclipse.commands
- a parancssori paraméterek új sor karakterrel elválasztott listája,
amely az Eclipse indításakor átadásra kerül
- eclipse.consoleLog
- ha az érték "true", minden naplófájl-kimenet elküldésre
kerül a Java System.out eleme számára is (jellemzően vissza a parancs
shellnek, ha van ilyen). Rendkívül kényelmes a -debug paraméterrel együtt használva.
- eclipse.debug.startupTime
- a jelenlegi munkamenetben elindított Java virtuális gép
elindításától eltelt idő ezredmásodpercekben.
- eclipse.exitcode
- <description>
- eclipse.exitdata
- <description>
- eclipse.log.backup.max
- a mentési naplófájlok maximálisan engedélyezhető száma. Ha a mentési
naplófájlok elérik a maximális számot, akkor a naplófájlok forgatásának
hatására a legrégebbi mentési fájl törlésre kerül.
Az alapértelmezett érték "10". Negatív vagy nulla érték megadása
esetén az alapértelmezett érték kerül alkalmazásra.
- eclipse.log.size.max
- a naplófájl maximális mérete kilobyte-ban. A naplófájl forgatásra
kerül, ha a fájl mérete meghaladja a maximális értéket. Az alapértelmezett
érték az "1000".
Negatív érték megadása esetén az alapértelmezett érték kerül alkalmazásra.
A nulla azt jelenti, hogy nincs maximális naplóméret.
- eclipse.noExtensionMunging
- ha az érték "true", a régebbi nyilvántartások abban az
állapotban maradnak, ahogy vannak. Az ilyen kiterjesztések alapértelmezésben frissítésre kerülnek az Eclipse
3.0-s verziójában található új kiterjesztési pont azonosítók
használatához.
- eclipse.noLazyRegistryCacheLoading {-noLazyRegistryCacheLoading}
- ha az érték "true", a platform bedolgozó nyilvántartási
gyorsítótár betöltési optimalizálása leállításra kerül. A konfigurációs elemek alapértelmezésben csak az igényeknek megfelelően
kerülnek betöltésre a nyilvántartási gyorsítótárból (ha elérhető) a
memóriafoglaltság csökkentésére. Ez a beállítás kikényszeríti, hogy a nyilvántartási gyorsítótár teljes
egészében töltődjön be az indításkor.
- eclipse.noRegistryCache {-noRegistryCache}
- ha az érték "true", a belső nyilvántartási gyorsítótárat
sem írni, sem olvasni nem lehet.
- eclipse.pluginCustomization {-pluginCustomization}
- a bedolgozó-beállítások alapértelmezett beállításait tartalmazó
tulajdonságfájl fájlrendszeri helye. Ezek az alapértelmezett beállítások felülbírálják az elsődleges
szolgáltatásban megadott alapértelmezett beállításokat. A relatív útvonalak magától az Eclipse saját aktuális munkakönyvtárától
vannak értelmezve.
- eclipse.product {-product}
- a futó termék azonosítója. Ez vezérli a különféle arculati
információkat, és hogy melyik alkalmazás van használatban.
- eclipse.startTime
- A tulajdonság az Eclipse elindításakor kerül beállításra. A
tulajdonság értéke a System.currentTimeMillis() által visszaadott érték
karaktersorozat ábrázolása. Ezt az értéket nem a felhasználók állítják be.
- eclipse.vm {-vm}
- az az útvonal, amelyet a Java végrehajtható fájl használ az Eclipse
futtatására. Ez az információ az újraindítási parancssorok összeállítására használatos.
- eclipse.vmargs {-vmargs}
- felsorolja az Eclipse futtatásánál használt virtuális gép
paramétereket. Ez az információ az újraindítási parancssorok összeállítására használatos.
- osgi.adaptor
- a használandó OSGi keretrendszer-átalakító osztályneve.
- osgi.arch {-arch}
- lásd: -arch
- osgi.baseConfiguration.area
- egy alapkonfigurációt ad meg, amely akkor kerül felhasználásra, ha
az osgi.configuration.area nincs
megadva.
- osgi.bundles
- Vesszőkkel elválasztott lista azokról a kötegekről, amelyek
automatikusan telepítésre kerülnek és opcionálisan elindulnak, ha a
rendszer felállt és fut. Az egyes bejegyzések formája:
<URL | egyszerű köteghely>[@ [<indítási szint>]
[":start"]]
Ha az indítási szint (>0 egész) ki van hagyva, akkor a
keretrendszer az alapértelmezett indítási szintet fogja használni a
köteghez. Ha a "start" címke hozzá van adva, akkor a köteg elindítottként
lesz megjelölve a telepítést követően.
Az egyszerű csomaghelyek a keretrendszer szülőkönyvtárához képest kerülnek
értelmezésre.
Az indítási szint jelzi azt az OSGi indítási szintet, amelyen a kötegnek
futnia kell. Ha ez az érték nincs megadva, a rendszer kiszámít egy megfelelő
alapértelmezést.
- osgi.clean
- ha az érték "true", minden, az OSGi keretrendszer és
az Eclipse futási környezet által használt gyorsítótárazott adat
kitörlődik. Ki fogja törölni a köteg-függőségek feloldásának tárolására használt
gyorsítótárat, illetve az Eclipse kiterjesztési nyilvántartási adatokat
is. A beállítás használata kikényszeríti, hogy az Eclipse újrainicializálja
ezeket a gyorsítótárakat.
- osgi.configuration.cascaded
- ha "true" értékre van állítva, ez a beállítás rárakódik
egy szülő beállításra. A szülőkonfigurációt az
osgi.sharedConfiguration.area
adja meg. További részletekért lásd a helyszínek részt.
- osgi.configuration.area {-configuration}
- a platform e futtatásának a konfigurációs adatainak a helye. A
konfiguráció meghatározza azt, hogy mely bedolgozók fognak futni, valamint
különféle más beállításokat is.
További részletekért lásd a helyszínek részt.
- osgi.configuration.area.default
- a platform e futtatásának a konfigurációs adatainak alapértelmezett helye. A
konfiguráció meghatározza azt, hogy mely bedolgozók fognak futni, valamint
különféle más beállításokat is.
Ez az érték (vagyis az alapértelmezett beállítás) csak akkor használható,
ha nincs beállítva érték az osgi.configuration.area számára. További részletekért lásd a helyszínek részt.
- osgi.console {-console}
- ha nem nulla értékre van állítva, az OSGi konzol (amennyiben
telepítve van) állapota engedélyezett.
Ha az érték egy megfelelő egész szám, akkor azt a rendszer egy portként
értelmezi, amelyen a konzol figyel, és kimeneteit az adott portra
irányítja.
Kényelmes megoldás a rendszere állapotának vizsgálatához.
- osgi.console.class
- a kérésre futó konzol osztályneve
- osgi.debug {-debug}
- ha nem nulla értékre van állítva, a platform hibakeresési módba
kapcsol. Ha az érték egy karaktersorozat, akkor azt a .options fájl helyeként
értelmezi a rendszer. Ez a fájl jelzi, hogy mely hibakeresési pontok állnak rendelkezésre egy
bedolgozóhoz, és hogy ezek engedélyezettek-e vagy nem. Ha a hely nincs megadva, a platform a telepítési könyvtár alatt keresi a
.options fájlt.
- osgi.dev {-dev}
- ha üres karaktersorozatra van állítva, egyszerűen bekapcsol a dev
mód. Ez a tulajdonság osztályútvonal-bejegyzések vesszővel elválasztott
listájaként is meg lehet adva, amelyek hozzáadásra kerülnek az egyes
bedolgozók osztályútvonalához, vagy tartalmazhatja a bedolgozók
készletének egyéni osztályútvonal-kiegészítéseit hordozó Java
tulajdonságfájl URL-jét is. Minden egyes bedolgozóhoz, amelyik egyéni fejlesztési idejű osztályútvonalat
igényel, a fájlban található egy
<bedolgozó azonosító>=<felveendő
osztályútvonal-bejegyzések>
formátumú bejegyzés, ahol a
bedolgozó azonosító"*" illeszkedik az egyébként nem említett
bedolgozókhoz.
- osgi.framework
- az OSGi keretrendszer URL-helyszíne. Akkor hasznos, ha az Eclipse telepítés szétesett. További részletekért lásd a helyszínek részt.
- osgi.frameworkClassPath
- az OSGi keretrendszer-implementáció osztályútvonal-bejegyzéseinek
vesszőkkel elválasztott listája.
A relatív helyek a keretrendszer helyéhez (lásd:
osgi.framework) képest vannak értelmezve.
- osgi.framework.extensions
- a keretrendszer-kiterjesztések vesszővel elválasztott listája. Az egyes bejegyzések formája:
<URL | simple bundle location>
Ha egy egyszerű köteghely van megadva (nem egy URL), akkor az
org.eclipse.osgi köteg szülőkönyvtárában keresés kerül hajtásra. A
keretrendszer-kiterjesztések segítségével az Eclipse különböző
keretrendszer-átalakítóval futtatható. A keretrendszer-kiterjesztés
tartalmazhat egy eclipse.properties fájlt a rendszertulajdonságok
beállításához. A keretrendszer-átalakítót biztosító
keretrendszer-kiterjesztés például az
osgi.adaptor tulajdonság beállításával
megadhatja, hogy mi az átalakítóosztály.
- osgi.framework.shape
- az Eclipse keretrendszer-megvalósítás alakjára van állítva. Ez a
tulajdonság akkor kerül beállításra, amikor az Eclipse platform
elindításra került és a felhasználó nem kívánja beállítani. A
"jar" érték jelzi, hogy az Eclipse OSGi keretrendszert egy
jar tartalmazza.
A "folder" érték jelzi, hogy az Eclipse OSGi keretrendszert egy
könyvtár tartalmazza.
- osgi.java.profile
- a használandó JRE profil URL címe. A JRE profil az
org.osgi.framework.system.packages és org.osgi.framework.bootdelegation
tulajdonság értékeit tartalmazza. Ha az osgi.java.profile nincs beállítva,
akkor a profil a futó JRE java.specification.version értéke alapján kerül
kiválasztásra.
- osgi.java.profile.bootdelegation
-
az osgi.java.profile java profil
tartalmazhat egy "org.osgi.framework.bootdelegation"
tulajdonságot. Ez az érték az
"org.osgi.framework.bootdelegation" rendszertulajdonság
beállításához használható. Az osgi.java.profile.bootdelegation jelzi a
használandó rendszerinítás-átruházási (bootdelegation) irányelvét. Az
alábbi értékek érvényesek (az alapértelmezés a figyelmen kívül hagyás):
- ignore -
jelzi, hogy a java profilban lévő
"org.osgi.framework.bootdelegation" értéket figyelmen kívül kell
hagyni. Az "org.osgi.framework.bootdelegation"
rendszertulajdonság segítségével kerül meghatározásra, hogy mely
csomagokat kell delegálni a rendszerbetöltéshez.
- override -
jelzi, hogy a java profilban lévő
"org.osgi.framework.bootdelegation" értéknek felül kell írnia az
"org.osgi.framework.bootdelegation" rendszertulajdonságot.
- none -
jelzi, hogy a java profilban lévő
"org.osgi.framework.bootdelegation" értéket ÉS a
rendszertulajdonságokat figyelmen kívül kell hagyni. Ez a legszigorúbb
beállítás. Ezen beállítással futtatása hatására a keretrendszer az OSGi R4
szigorú rendszerbetöltési delegálás-modellt használja.
- osgi.install.area {-install}
- a platform telepítési helye. Ez a beállítás jelzi az alap Eclipse
bedolgozók helyét, és hasznos, ha az Eclipse telepítés szétesett.
További részletekért lásd a helyszínek részt.
- osgi.instance.area {-data}
- a példányadatok helye ehhez a szekcióhoz. A bedolgozók az adataik tárolására használják ezt a helyet. A Resources bedolgozó például ezt használja a projektek alapértelmezett
helyeként (más néven munkaterületként). További részletekért lásd a helyszínek részt.
- osgi.instance.area.default
- a példányadatok alapértelmezett helye ehhez a szekcióhoz. A bedolgozók az adataik tárolására használják ezt a helyet. A Resources bedolgozó például ezt használja a projektek alapértelmezett
helyeként (más néven munkaterületként). Ez az érték (vagyis az alapértelmezett beállítás) csak akkor használható,
ha nincs beállítva érték az osgi.instance.area számára. További részletekért lásd a helyszínek részt.
- osgi.locking
- a platform ezen futásához használandó zárolási típus. Érvényes
zárolási típusok: "java.io", "java.nio" és
"none". Az alapértelmezett érték a
"java.nio", kivéve, ha a JRE nem támogatja a
"java.nio" értéket. Ebben az esetben a "java.io"
az alapértelmezett.
- osgi.manifest.cache
- az a hely, ahol a létrejövő leírófájlok felfedezésre és elkészítésre
kerülnek. Az alapértelmezés a konfigurációs terület, de a leírófájl gyorsítótára
külön is tárolható.
- osgi.nl {-nl}
- annak a területi beállításnak a neve, amelyen az Eclipse platform
futni fog. Az NL értékeknek követniük kell a szabványos Java területi beállítás
elnevezési megállapodásokat.
- osgi.noShutdown {-noExit}
- Ha "true", akkor a VM az Eclipse alkalmazás befejezése
után nem lép ki. Ez az OSGi keretrendszer megvizsgálásához hasznos, miután
az Eclipse alkalmazás befejeződött.
- osgi.os {-os}
- az operációs rendszer értéke. Az értéknek az Eclipse által ismert
Eclipse processzorarchitektúra-nevek valamelyikének kell lennie (pl.: x86, sparc, ...).
- osgi.parentClassLoader
- a szülő-osztálybetöltőként használandó osztálybetöltő-típus a
keretrendszeren telepített kötegekhez. Érvényes típusok a következők:
- app - az
alkalmazás-osztálybetöltő.
- boot - a
rendszerindító osztálybetöltő.
- ext - a
kiterjesztés-osztálybetöltő.
- fwk - a
keretrendszer-osztálybetöltő.
- osgi.requiredJavaVersion
- Az Eclipse indításához szükséges minimális java verzió. Az
alapértelmezett érték az "1.4.1".
- osgi.resolverMode
- a keretrendszeren telepített kötegeket feloldó mód. A
"strict" érték a feloldót szigorú módba állítja. Az
alapértelmezett feloldó mód nem szigorú. Ha a feloldó szigorú módban van,
akkor a keretrendszer hozzáférés-korlátozási szabályokat kényszerít ki az
exportált csomagok osztályainak és erőforrásainak betöltésekor, amely
az x-internal vagy x-friends direktívát adja meg.
- osgi.sharedConfiguration.area
- a platform ezen futásának megosztott konfigurációs helye. Ha az
osgi.configuration.cascaded
tulajdonság értéke "true", akkor a megosztott konfigurációs
terület kerül alkalmazásra szülőkonfigurációként.
- osgi.splashLocation
- az Eclipse indítása során megjelenített nyitóképernyő (.bmp fájl)
abszolút URL-helyszíne. Ez a beállítás minden, az osgi.splashPath
tulajdonságban beállított értéket felülír.
- osgi.splashPath
- URL-címek vesszővel elválasztott listája, amelyeken a rendszer egy
splash.bmp nevű fájlt keres.
Ezt a tulajdonságot az
osgi.splashLocation elemben megadott
bármilyen érték felülírja.
- osgi.syspath
- azon elérési útra van állítva, amelyen az OSGi keretrendszer
(org.eclipse.osgi) megvalósítás található. Például: "<eclipse
telepítési útvonal>/eclipse/plugins".
Ez a
tulajdonság akkor kerül beállításra, amikor az Eclipse platform
elindításra került és a felhasználó nem kívánja beállítani.
- osgi.user.area {-user}
- a felhasználói terület helye. A felhasználói terület
adatokat (például beállításokat) tartalmaz, amelyek jellemzőek az
operációs rendszer felhasználójára, és függetlenek bármely Eclipse
telepítéstől, beállítástól vagy példánytól. További részletekért lásd a helyszínek részt.
- osgi.user.area.default
- a felhasználói terület alapértelmezett helye. A felhasználói terület
adatokat (például beállításokat) tartalmaz, amelyek jellemzőek az
operációs rendszer felhasználójára, és függetlenek bármely Eclipse
telepítéstől, beállítástól vagy példánytól. Ez az érték (vagyis az alapértelmezett beállítás) csak akkor használható,
ha nincs beállítva érték az osgi.user.area számára. További részletekért lásd a helyszínek részt.
- osgi.ws {-ws}
- az ablakrendszer értéke. Az értéknek az Eclipse által ismert Eclipse
ablakrendszer-nevek valamelyikének kell lennie (pl.: win32, motif, ...).
Helyszínek
Az Eclipse futási környezet meghatároz egy sor helyet, amelyek
kontextust biztosítanak a bedolgozó-fejlesztők számára az adatok
olvasásához/tárolásához, illetve biztosítják az Eclipse felhasználóknak az
ellenőrzést az adatmegosztás hatóköre és a láthatóság felett. Az Eclipse a következő helyfogalmakat határozza meg:
- Felhasználói (-user) {osgi.user.area}
[@none, @noDefault, @user.home, @user.dir, filepath, url]
- A felhasználói helyszínek a felhasználókra jellemzők. A felhasználói helyszín általában a Java
user.home
rendszertulajdonság-értékén alapszik, de felülírható. Az olyan információk, mint például a felhasználói hatókörű beállítások és
a bejelentkezési információk, a felhasználói helyszínen lehetnek
megtalálhatók.
- Telepítési (-install) {osgi.install.area} [@user.home, @user.dir,
filepath, url]
- Telepítési helyszín az, ahová maga az Eclipse telepítésre került. A gyakorlatban ez a helyszín az a könyvtár (általában az
"eclipse"), amely a startup.jar vagy az eclipse.exe futtatási
szülőkönyvtára. Ennek a helyszínnek írásvédettnek kell lennie a normál felhasználók
számára, ha egy telepítés több felhasználó között lehet megosztva. Be lehet állítani a telepítési helyszínt, és kettéválasztani a startup.jar
állományt és az Eclipse többi részét.
- Beállítási (-configuration) {osgi.configuration.area} [@none,
@noDefault, @user.home, @user.dir, filepath, url]
- A beállítási helyszínek fájlokat tartalmaznak, amelyek egy
telepítő(al)készletet azonosítanak és kezelnek a futtatáshoz. Ilyen módon telepítőnként több konfiguráció is lehet.
A telepítők alapértelmezett beállítási területtel is érkezhetnek, de az
általános indítási szituáció az, hogy a futási környezet megkísérel egy
jobban írható konfigurációs helyszínt találni.
- Példány (-data) {osgi.instance.area} [@none, @noDefault,
@user.home, @user.dir, filepath, url]
- A példányhelyszínek felhasználók által megadott adattermékeket
tartalmaznak. A Resource bedolgozó például a példány területet használja munkaterület
helyszínként, és így ez a projektek alapértelmezett saját helye. Más bedolgozók szabadon írhatnak fájlokat erre a helyre.
Miközben a felhasználók e helyek bármelyikét beállíthatják, az Eclipse
ki fogja számítani az ésszerű alapértelmezéseket, ha az értékek nincsenek
megadva. A helymegadás leggyakoribb használati területe a példány terület, vagy
IDE kontextusban a munkaterület. Az alapértelmezett Eclipse konfiguráció futtatásához egy adott
adatkészlettel megadhatja a következőt:
eclipse -data c:\mydata
További részletek
A helyek URL-címek. Az egyszerűség kedvéért a fájlelérési útvonalak is
elfogadottak, és automatikusan file: URL-ekké konvertálódnak. A jobb
kézbentarthatóság és a kényelem érdekében egy sor szimbolikus hely is
használható. Figyeljen rá, hogy a helytípusok és a szimbolikus értékek nem minden
kombinációja érvényes. Az alábbi tábla részletesen ismerteti, hogy mely kombinációk lehetségesek. Mivel az alapértelmezett eset minden helyhez beállítandó, érvényes és
írható, bizonyos bedolgozók lehet, hogy hibát fognak jelezni más
beállításoknál, még ha lehetségesként is vannak felsorolva. Ésszerűtlen például elvárni, hogy egy felhasználói adatokra fókuszáló
bedolgozó (például az Eclipse Resources bedolgozó) túl sokra jusson, ha a
példány terület nincs megadva. A bedolgozófejlesztőktől függ, hogy kiválasszák azokat a beállításokat,
amelyeket támogatnak, és ennek megfelelően tervezzék a szolgáltatásokat.
- @none
- Jelzi, hogy a vonatkozó hely soha ne legyen sem kifejezetten
beállítva, sem alapértelmezett értékére állítva. Egy PCP-stílusú alkalmazás például, amelynek nincsenek felhasználói
adatai, annak megelőzésére használhatja az osgi.instance.area=@none
beállítást, hogy idegen fájlok kerüljenek a lemezre írásra. A @none után nem következhet semmilyen további elérési út szegmens.
- @noDefault
- Kikényszeríti, hogy egy hely meghatározatlan vagy kifejezetten
meghatározott legyen (vagyis hogy az Eclipse ne számítsa ki automatikusan
az alapértelmezett értéket). Ez akkor hasznos, ha engedélyezni szeretné a megfelelő helyen található
adatokat, de az Eclipse alapértelmezett értéke nem jó. A @noDefault után nem következhet semmilyen további elérési út szegmens.
- @user.home
- Arra utasítja az Eclipse-et, hogy számítsa ki a hely értékét a
felhasználó saját könyvtárához képest. A @user.home után további elérési útvonal szegmensek következhetnek. A "@user.home" karaktersorozat minden esetben egyszerűen
behelyettesítésre kerül a Java "user.home"
rendszertulajdonság-értékével. Az
osgi.instance.area=@user.home/myWorkspace
beállítás például a
file:/users/bob/myWorkspace értéket
eredményezi.
- @user.dir
- Arra utasítja az Eclipse-et, hogy számítsa ki a hely értékét a
jelenlegi munkakönyvtárhoz képest. A @user.dir után további elérési útvonal szegmensek következhetnek. A "@user.dir" karaktersorozat minden esetben egyszerűen
behelyettesítésre kerül a Java "user.dir"
rendszertulajdonság-értékével. Az
osgi.instance.area=@user.dir/myWorkspace
beállítás például a
file:/usr/share/eclipse/myWorkspace értéket
eredményezheti.
hely/érték |
alapértelmezés támogatása |
fájl/URL
|
@none
|
@noDefault
|
@user.home
|
@user.dir
|
példány
|
igen |
igen
|
igen
|
igen
|
igen
|
igen (alapértelmezett)
|
beállítás
|
igen
|
igen
|
igen*
|
igen*
|
igen
|
igen
|
telepítés
|
nem
|
igen
|
nem
|
nem
|
igen
|
igen
|
felhasználó
|
igen
|
igen
|
igen
|
igen
|
igen
|
igen
|
* jelzi, hogy ez a beállítás technikailag lehetséges, de a gyakorlatban
meglehetősen bonyolultan kezelhető. Főleg, mert egy konfigurációs hely nélkül az Eclipse futási környezet csak
az OSGi keretrendszer elindításáig jut.
Írásvédett helyek
A hely a ".readOnly" helytulajdonsághoz adásával és a
"true" érték beállításával írásvédettként adható meg. Az alábbi
tulajdonságok segítségével a megfelelő helyek megadhatók írásvédettként:
Indító ini fájl
Az eclipse.exe és az RCP alkalmazások még általánosabb végrehajtható
fájljai a paramétereiket egy társított ini fájlból olvassák. Ez a fájl egy
platform-független módszert biztosít az argumentumok átadásához, amelyeket
korábban közvetlenül a parancssorban kellett megadni, mint például a vm
vagy vm argumentumok. Minden paraméter megadható ebben a fájlban, de a
különböző telepítések közötti karbantarthatóság és konzisztencia érdekében
csak a vm helyet és az vm argumentumokat adja meg ebben az ini fájlban, a
többihez pedig a config.ini fájlt használja.
Fájlformátum
A fájl a végrehajtható fájl neve alapján kell elnevezni (az eclipse.exe
például eclipse.ini lesz, a launcher.exe pedig launcher.ini) és minden
paramétert a fájl új sorában kell megadni. Az alábbiakban egy ilyen fájlra
látható példa, amely a vm helyet és néhány paramétert ad meg:
-vm
c:/myVm/java.exe
-vmargs
-Dms40M