Eclipse futási beállítások
3.2 változat - Legutóbbi felülvizsgálat: 2006. május 8.
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 szerepelni. 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.activateRuntimePlugins
- a távoli bedolgozók aktiválását irányítja. Az RCP alkalmazások,
amelyek nem igénylik a futási bedolgozók által biztosított
szolgáltatásokat, a tulajdonságot "false" értékre állíthatják a
futási bedolgozók aktiválásának elkerüléséhez az Eclipse indításkor
- 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.ee.install.verify
- Ha értéke "true", akkor a keretrendszer megvizsgálja a
szükséges végrehajtási környezetet a köteg telepítésekor. Az
alapértelmezett érték "false".
- 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.service.jobs
- az OSGi szolgáltatások bejegyzését irányítja. Állítsa "false" értékre az OSGi
szolgáltatások
org.eclipse.core.jobs
bedolgozó általi bejegyzésének kikapcsolásához
- eclipse.service.pref
- Az OSGi szolgáltatások bejegyzését irányítja. Állítsa "false" értékre az OSGi
szolgáltatások
org.eclipse.equinox.preferences
bedolgozó általi bejegyzésének kikapcsolásához
- 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.stateSaveDelayInterval
- a késleltetési időköz (ezredmásodpercben) az állapotmódosítási
kérések tárolásához. Az alapértelmezés 30000 ms (30 sec). Az
állapotmódosítási kérések késleltetésének célja, hogy megelőzze az
adminisztrációs műveletek (pl. kötegek telepítése) közben fellépő jelentős
mennyiségű lemezre írást. A késleltetési időtartam használatával
beállítható egy várakozási időtartam, amikor művelet nincs folyamatban. A
keretrendszer állapotinformációi ezt követően kerülnek tárolásra.
- 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.bundlefile.limit
- meghatározza a keretrendszer által nyitva tartott jar fájlok
maximális számát. A minimálisan megengedett érték 10. Alapértelmezésben az
érték korlátlan.
- 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.bundles.defaultStartLevel
- az alapértelmezett indítási szint, amelyre az összes Eclipse
Frissítés által telepített köteg beállításra kerül. Az
osgi.bundles listában megadott kötegek egyedi
indítási szintet adhatnak meg. Ha nem adnak meg indítási szintet, akkor
alapértelmezésben értékük a osgi.bundles.defaultStartLevel érték. Az
osgi.bundles.defaultStartLevel alapértelmezett értéke 4.
- 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.console.encoding
- ha be van állítva, akkor a rendszer a megadott értéket használja a
konzol kódolásaként (lásd osgi.console). Ha
nincs megadva, akkor a file.encoding tulajdonság értéke kerül
felhasználásra. Ha a file.encoding nincs beállítva, akkor
alapértelmezésben a rendszer az iso8859-1 kódolást használja.
- osgi.contextClassLoaderParent
- a Keretrendszer által a kontextus osztálybetöltő szülő
osztálybetöltőjeként használni kívánt osztálybetöltő típus. É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ő.
- ccl - a keretrendszer indításakor beállított eredeti
osztálybetöltő (alapértelmezett érték).
- 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.filepermissions.command
- meghatároz egy nem kötelező, operációs rendszerre jellemző parancsot
a kinyert natív kód fájl-jogosultságainak beállításához. Bizonyos
operációs rendszerek esetében elvárás, hogy a natív könyvtárak
végrehajtható fájlnak legyenek beállítva. Ez az elhagyható tulajdonság
lehetővé teszi az ehhez szükséges parancs megadását.
Például egy UNIX-stílusú operációs rendszer esetében az alábbi érték
adható meg:
osgi.filepermissions.command="chmod +rx [fullpath]"
A [fullpath] segítségével a keretrendszer behelyettesíti a tényleges
fájlelérési utat.
- 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:
<simple bundle location>
A rendszer az egyszerű köteghelyeket az org.eclipse.osgi köteg
szülőkönyvtárában keresi. 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.framework.library.extensions
- az egyéb könyvtár-fájlkiterjesztések vesszőkkel elválasztott
felsorolása, amelyeket a rendszernek keresnie kell. Ha nincs beállítva,
akkor a kereséshez csak a System.mapLibraryName(String) által
visszaadott könyvtárnév kerül felhasználásra. Erre az olyan operációs
rendszerek esetében van szükség, amelyek a könyvtárakra vonatkozóan több
eltérő kiterjesztés használatát teszik lehetővé. Például az AIX .a és .so
könyvtár-kiterjesztéseket is megenged, de a System.mapLibraryName(String)
csak az .a kiterjesztéssel rendelkező neveket adja vissza.
- osgi.framework.useSystemProperties
- azt vezérli, hogy a keretrendszer tulajdonságait a globális
Rendszertulajdonságok mentik vagy pedig a keretrendszer minden egyes
példányára vonatkozóan, privát módon kerülnek tárolásra. Alapértelmezésben
a keretrendszer tulajdonságait a Rendszertulajdonságok mentik (tehát
true). A tulajdonság akkor hasznos, amikor ugyanazon a virtuális gépen az
OSGi keretrendszer több példányát futtatja és minden egyes példány
különálló konfigurációs tulajdonság-készlettel rendelkezik (pl. a
config.ini fájlban beállítva).
- osgi.genericAliases
- általános álnevek vesszővel elválasztott listája, amelyek
segítségével a meglévő leírófájl-fejlécek az Eclipse-GenericCapability és
az Eclipse-GenericRequire leírófájl-fejléceire leképezhetők. Az
osgi.genericAliases tulajdonság szintaxisa:
osgi.genericAliases ::= általános-álnév ( ',' általános-álnév ) *
generic-alias ::= képesség-álnév ':' szükséges-álnév ':' képesség-típus
Például ha az Export-Service és Import-Service OSGi fejléceket az
Eclipse-GenericCapability és az Eclipse-GenericRequire fejlécekre kívánja
leképezni, akkor a következő értékeket használhatja:
osgi.genericAliases=Export-Service:Import-Service:osgi.service
- osgi.hook.configurators
- csatlakozópont-beállítók vesszőkkel elválasztott felsorolása. Ha az
érték meg van adva, akkor a rendszer kizárólag a listában megadott
beállítókat használja. A hookconfigurators.properties fájlokban
esetlegesen megadott csatlakozópont-beállítók figyelmen kívül maradnak.
- osgi.hook.configurators.include
- további csatlakozópont-beállítók vesszőkkel elválasztott
felsorolása. Ez a választható csatlakozópont-beállítók beállítása során
lehet hasznos. Az
osgi.hook.configurators beállítás
használata esetén ez a beállítás figyelmen kívül marad.
- osgi.hook.configurators.exclude
- a kizárni kívánt csatlakozópont-beállítók vesszőkkel elválasztott
felsorolása. Ez a csatlakozópont-beállító tulajdonságfájljaiban megadott
csatlakozópont-beállítók letiltása során hasznos. Az
osgi.hook.configurators beállítás
használata esetén ez a beállítás figyelmen kívül marad.
- osgi.java.profile
- a használandó JRE profil URL címe. A megadott URL címet a rendszer
Java tulajdonságfájlként értelmezi. A JRE profilok értékeket tartalmaznak
az org.osgi.framework.system.packages, az
org.osgi.framework.bootdelegation és az
org.osgi.framework.executionenvironment tulajdonságokra. 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.nl.user
- a területi beállítás neve, amikor a felhasználó kifejezetten
hozzáadja az -nl paramétert a parancssori paraméterekhez.
- 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.startLevel
- az indítási szint érték, amelyre a keretrendszer indításkor
beállításra kerül. Az alapértelmezett érték 6.
- osgi.support.signature.verify
- érvényes értékei a "true" és "false", az
alapértelmezés a "false". Ha értéke "true", akkor a
keretrendszer a tanúsítványokat aláírt jar fájlokból tölti be, futtatáskor
pedig ellenőrzi tartalmuk épségét.
- 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őkön múlik a támogatott
beállítások kiválasztása, illetve a szolgáltatások ennek megfelelő
megtervezése.
- @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