Ajonaikaiset Eclipse-asetukset
Versio 3.2 - Muutettu viimeksi 8. toukokuuta 2006
Eclipse-ympäristön kokoonpano on suurelta osin määritettävissä. Kokoonpanon määrityksessä syöte on
komentorivin argumenttien ja järjestelmän ominaisuusasetusten muodossa. Monissa tapauksissa
komentorivin argumentit ovat vain pikanäppäimiä, joilla määritetään niihin liittyvät järjestelmän
ominaisuudet. Järjestelmän ominaisuusasetuksia on itse asiassa paljon enemmän kuin
komentorivin argumentteja.
Komentorivin argumentit
Alla on listattu Eclipse-ajoympäristön eri osien käsittelemät komentorivin argumentit. Monet näistä arvoista voidaan määrittää myös järjestelmän
ominaisuuksien kautta käyttämällä komentorivillä näennäiskoneen -D-argumentteja, määrittämällä
niiden arvot config.ini-tiedostossa tai käyttämällä <launcher>.ini-tiedostoa.
Kahden viimeksi mainitun tekniikan avulla voidaan mukauttaa omaa Eclipse-sovellusta
käyttämättä lainkaan komentorivin argumentteja.
Kustakin listatusta argumentista annetaan sitä vastaava järjestelmän ominaisuusavain
(kaarisulkeissa, {}). Lisäksi annetaan se Eclipse-ajoympäristön kerros, jossa komentorivin
argumentti käsitellään (sulkeissa, ()). Tästä on hyötyä, kun ajoympäristön osia korvataan
erikoistarpeita varten.
- -application <id> (ajoympäristö)
- vastaava määritys: kohteelle eclipse.application
arvo <id>
- -arch <architecture> (OSGi)
- vastaava määritys: kohteelle osgi.arch arvo <architecture>
- -clean (OSGi)
- vastaava määritys: kohteelle osgi.clean arvo "true"
- -configuration <location> (pääsovellus)
- vastaava määritys: kohteelle osgi.configuration.area
arvo <location>
- -console [portti] (OSGi)
- vastaava määritys: kohteelle osgi.console arvo [portti]
tai tyhjä merkkijono, jos käytetään oletusporttia (esimerkiksi silloin, kun porttia
ei ole määritetty)
- -consoleLog (ajoympäristö)
- vastaava määritys: kohteelle eclipse.consoleLog arvo
"true"
- -data <location> (OSGi)
- vastaava määritys: kohteelle osgi.instance.area
arvo <location>
- -debug [asetustiedosto] (OSGi)
- vastaava määritys: kohteelle osgi.debug arvo [asetustiedosto]
tai tyhjä merkkijono pelkkää vianmäärityksen käyttöönottoa varten (esimerkiksi jos asetustiedoston
sijaintia ei ole määritetty)
- -dev [merkinnät] (OSGi)
- vastaava määritys: kohteelle osgi.dev arvo [merkinnät] tai
tyhjä merkkijono pelkkää kehitystilan käyttöönottoa varten (esimerkiksi jos merkintöjä ei ole määritetty)
- -endSplash <command> (pääsovellus)
- määrittää komennon, jolla aloitusruutu otetaan pois käytöstä. Se kuuluu yleensä
Eclipse-ohjelmatiedostoon.
- -feature <feature id> (ajoympäristö)
- vastaava määritys: kohteelle eclipse.product
arvo <feature id>
- -framework <location> (pääsovellus)
- vastaava määritys: kohteelle osgi.framework arvo
<location>
- -initialize (pääsovellus)
- alustaa ajettavan kokoonpanon. Kaikki ajoympäristöön liittyvät tietorakenteet
ja välimuistit verestetään. Mitään käyttäjän/lisäosan määrittämiä kokoonpanotietoja
ei poisteta. Mitään sovellusta ei ajeta, kaikki tuotemääritykset ohitetaan,
eikä mitään käyttöliittymää esitetä (esimerkiksi aloitusruutua ei tule näkyviin).
- -install <location> (pääsovellus)
- vastaava määritys: kohteelle osgi.install.area arvo
<location>
- -keyring <location> (ajoympäristö)
- valtuustietokannan sijainti levyllä. Tätä argumenttia täytyy
käyttää yhdessä salasana-argumentin kanssa.
- -name <string> UUSI
- tehtäväpalkin vaihtoehdossa näytettävä nimi, kun sovellus aloitetaan. Kun sitä ei ole määritetty, nimi on ohjelmatiedoston nimi.
- -nl <locale> (OSGi)
- vastaava määritys: kohteelle osgi.nl arvo <locale>
- -noExit (OSGi)
- vastaava määritys: kohteelle osgi.noShutdown arvo "true"
- -noLazyRegistryCacheLoading (ajoympäristö)
- vastaava määritys: kohteelle eclipse.noLazyRegistryCacheLoading
arvo "true"
- -noRegistryCache
(ajoympäristö)
- vastaava määritys: kohteelle eclipse.noRegistryCache
arvo "true"
- -noSplash (ohjelmatiedosto, pääsovellus)
- ohjaa, näytetäänkö aloitusruutu vai ei
- -os <operating system> (OSGi)
- vastaava määritys: kohteelle osgi.os arvo <operating system>
- -password <password> (ajoympäristö)
- valtuustietokannan salasana
- -pluginCustomization <location> (ajoympäristö)
- vastaava määritys: kohteelle eclipse.pluginCustomization arvo
<location>
- -product <id> (OSGi)
- vastaava määritys: kohteelle eclipse.product arvo
<id>
- -showSplash <command> (pääsovellus)
- määrittää komennon, jolla näytetään aloitusruutu. Se kuuluu yleensä
Eclipse-ohjelmatiedostoon.
- -startup <location> (ohjelmatiedosto) UUSI
- Eclipse-sovelluksen aloituksessa käytettävän JAR-tiedoston nimi. Kyseisessä JAR-tiedostossa on oltava määritettynä pääluokan määrite.
Jos tätä parametria ei ole määritetty, käytetään startup.jar-tiedostoa, joka sijaitsee samassa kansiossa kuin ohjelmatiedosto.
- -user <location> (OSGi)
- vastaava määritys: kohteelle osgi.user.area arvo <location>
- -vm <Java-ohjelmatiedoston polku> (ohjelmatiedosto, pääsovellus)
- kun komento välitetään Eclipse-ohjelmatiedostoon, tämän asetuksen avulla paikannetaan
Eclipse-sovelluksen ajoon käytettävä Java-näennäiskone. Sen on oltava tarkka tiedostojärjestelmäpolku
sopivaan Java-ohjelmatiedostoon. Jos sitä ei ole määritetty, Eclipse-ohjelmatiedosto käyttää
hakualgoritmia
sopivan näennäiskoneen paikannukseen. Joka tapauksessa ohjelmatiedosto välittää silloin
polun varsinaiseen Java-pääkoneen käyttämään näennäiskoneeseen -vm-argumentin avulla. Java-pääkone
tallentaa tämän arvon eclipse.vm-tiedostoon.
- -vmargs [vmargs*] (ohjelmatiedosto,
pääsovellus)
- kun komento välitetään Eclipse-sovellukseen, tämän asetuksen avulla mukautetaan
Eclipse-sovelluksen ajoon käytettävän Java-näennäiskoneen toimintaa. Jos sitä
ei ole määritetty, tämä asetus täytyy liittää komentorivin loppuun. Vaikka sitä ei
olisi määritetty ohjelmatiedoston komentorivillä, ohjelmatiedosto lisää
tarvittavat argumentit (kuten käynnistettävän luokan) automaattisesti Javaan välitetylle komentoriville
-vmargs-argumentin avulla.
Jav-pääkone tallentaa tämän arvon eclipse.vmargs-tiedostoon.
- -ws <window system> (OSGi)
- vastaava määritys: kohteelle osgi.ws arvo <window system>
Vanhentuneet komentorivin argumentit
Seuraavia komentorivin argumentteja ei enää käytetä tai ne on korvattu
ja sisällytetty ajoympäristöön, eikä niitä välitetä edelleen
takautuvan yhteensopivuuden ylläpitämiseksi ajettavaan sovellukseen .
- -boot
- ks. -configuration
- -classLoaderProperties
- ei enää käytössä
- -firstUse
- ei enää käytössä
- -newUpdates
- ei enää käytössä
- -noPackagePrefixes
- ei enää käytössä
- -noUpdate
- ei enää käytössä
- -plugins
- ei enää käytössä
- -update
- ei enää käytössä
Muut argumentit
Seuraavat komentorivin argumentit määritetään eri Eclipse-lisäosissa,
ja niitä tuetaan vain, jos määrittävä lisäosa on asennettu, tulkittu ja aktivoitu.
- -noVersionCheck (työympäristö)
- <kuvaus>
- -perspective (työympäristö)
- <kuvaus>
- -refresh (org.eclipse.core.resources)
- <kuvaus>
- -showLocation (org.eclipse.ui.ide.workbench)
- <kuvaus>
- -allowDeadlock
- <kuvaus>
Järjestelmän ominaisuudet
Eclipse-ajoympäristö käyttää seuraavia järjestelmän ominaisuuksia. Huomaa, että
"osgi"-alkuiset järjestelmän ominaisuudet liittyvät OSGi-kehyksen toteutukseen
ja että "eclipse"-alkuiset järjestelmän ominaisuudet liittyvät OSGi-kehyksen päälle kerrostettuun Eclipse-ajoympäristöön.
Monilla näistä ominaisuuksista on vastaavat komentorivin argumentit (ks. kohta Komentorivin
argumentit ja kaarisulkeissa {} oleva arvo). Käyttäjät voivat vapaasti
käyttää joko komentoriviä tai ominaisuusasetuksia arvon määrittämiseen. Ominaisuudet
voidaan
määrittää
seuraavin
tavoin:
- käytetään argumenttia -DpropName=propValue Java-näennäiskoneen VM-argumenttina
- haluttu ominaisuus määritetään config.ini-tiedostossa sopivalla
kokoonpanoalueella
- eclipse.activateRuntimePlugins
- Ohjaa ajonaikaisten lisäosien aktivointia. RCP-sovellukset, jotka eivät edellytä ajonaikaisten lisäosien toimittamia palveluja, voivat määrittää tämän ominaisuuden arvoksi "false". Näin vältetään ajonaikaisten lisäosien aktivointi Eclipse-ympäristöä aloitettaessa.
- eclipse.application {-application}
- ajettavan sovelluksen tunnus. Tässä annettu arvo ohittaa
kaikki ajettavan tuotteen (ks. eclipse.product) määrittämät sovellukset
- eclipse.commands
- rivinsyötöin erotettu luettelo kaikista komentorivin argumenteista, jotka on välitetty
Eclipse-sovellusta aloitettaessa
- eclipse.consoleLog
- jos arvo on "true", kaikki lokitulosteet lähetetään myös Javan System.out-tiedostoon (yleensä
takaisin mahdolliseen komentoliittymään). Tämä on kätevä yhdistettynä -debug-argumenttiin
- eclipse.debug.startupTime
- tämän istunnon Java-näennäiskoneen aloitusaika millisekunteina
- eclipse.ee.install.verify
- jos arvo on "true", kehys tarkistaa pakollisen
suoritusympäristön resurssijoukon asennushetkellä. Oletusarvo on
"false".
- eclipse.log.backup.max
- varmistuslokitiedostojen sallittu enimmäismäärä. Vanhin varmistuslokitiedosto poistetaan,
kun varmistuslokitiedostojen enimmäismäärä saavutetaan lokitiedoston kierron tuloksena.
Oletusarvo on "10". Jos arvo on negatiivinen tai nolla, käytetään
oletusarvoa.
- eclipse.log.size.max
- lokitiedoston enimmäiskoko kilotavuina. Lokitiedostoa kierretään, kun
tiedoston koko ylittää enimmäiskoon. Oletusarvo on "1000".
Jos arvo on negatiivinen, käytetään oletusarvoa. Jos arvo on nolla,
lokitiedostolla ei ole enimmäiskokoa.
- eclipse.noExtensionMunging
- jos arvo on "true", periytyvä rekisterilaajennus jätetään ennalleen. Oletusarvoisesti tällaiset laajennukset
päivitetään käyttämään Eclipse 3.0 -version uusia laajennuspisteen tunnuksia.
- eclipse.noLazyRegistryCacheLoading {-noLazyRegistryCacheLoading}
- jos arvo on "true", optimoinnin lataava ympäristön lisäosarekisterin välimuisti poistetaan
käytöstä. Oletusarvoisesti kokoonpanon elementit ladataan rekisterin
välimuistista (jos se on käytettävissä)
vain pyydettäessä, jolloin muistin peittoalue pienenee. Jos käytetään tätä asetusta, rekisterin
välimuisti ladataan kokonaan aloituksen yhteydessä.
- eclipse.noRegistryCache {-noRegistryCache}
- jos arvo on "true", sisäistä laajennusrekisterin välimuistia ei lueta eikä kirjoiteta
- eclipse.pluginCustomization {-pluginCustomization}
- lisäosan oletusasetukset sisältävän ominaisuustiedoston tiedostojärjestelmäsijainti. Nämä oletusasetukset ohittavat ensisijaisessa tuoteominaisuudessa määritetyt
oletusasetukset. Suhteelliset polut tulkitaan suhteessa
Eclipse-sovelluksen nykyiseen työhakemistoon.
- eclipse.product {-product}
- ajettavan tuotteen tunnus. Tämän asetuksen avulla ohjataan erilaisia tuotteistustietoja
ja käytettävää sovellusta.
- eclipse.service.jobs
- Ohjaa OSGi-palvelujen rekisteröintiä. Määritä arvoksi "false", jos haluat estää OSGi-palvelujen rekisteröinnin
org.eclipse.core.jobs
-lisäosan avulla.
- eclipse.service.pref
- Ohjaa OSGi-palvelujen rekisteröintiä. Määritä arvoksi "false", jos haluat estää OSGi-palvelujen rekisteröinnin
org.eclipse.equinox.preferences
-lisäosan avulla.
- eclipse.startTime
- tämä ominaisuus määritetään Eclipse-sovellusta aloitettaessa. Tämän ominaisuuden arvo on
merkkijonoesitys System.currentTimeMillis()-metodin palauttamasta arvosta. Käyttäjien ei ole tarkoitus
määrittää tätä arvoa.
- eclipse.stateSaveDelayInterval
- tilan muutospyynnön pysyvyysviiveväli (millisekunteina). Oletusarvo on
30000 ms (30 sekuntia). Tilan muutospyynnöt on viivästetty, jotta
estetään suurten tietomäärien kirjoitus levyyn samalla, kun tehdään
pääkäyttäjän toimia (esimerkiksi asennetaan resurssijoukkoja). Viiveväli
määrittää, kuinka kauan odotetaan toimetonta hetkeä, ennen kuin
kehyksen tilatieto tallennetaan pysyväksi.
- eclipse.vm {-vm}
- Eclipse-sovelluksen ajossa käytettävän Java-ohjelmatiedoston polku. Tämän tiedon avulla
muodostetaan uudelleenaloituksen komentorivit.
- eclipse.vmargs {-vmargs}
- luettelee Eclipse-sovelluksen ajossa käytettävät VM-argumentit. Tämän tiedon avulla
muodostetaan uudelleenaloituksen komentorivit.
- osgi.adaptor
- käytettävän OSGi-kehyksen sovitustoiminnon luokan nimi.
- osgi.arch {-arch}
- ks. -arch
- osgi.baseConfiguration.area
- määrittää kantakokoonpanon, jota käytetään, kun
kohdetta osgi.configuration.area ei ole määritetty.
- osgi.bundlefile.limit
- määrittää kehyksen auki pitämien jar-tiedostojen
määrälle raja-arvon. Pienin sallittu arvo on 10. Oletus on,
ettei raja-arvoa ole.
- osgi.bundles
- pilkuin erotettu luettelo resurssijoukoista, jotka asennetaan automaattisesti
ja aloitetaan valinnaisest,
kun järjestelmä on käynnissä. Kunkin merkinnän muoto on seuraava:
<URL | yksinkertainen resurssijoukon sijainti >[@ [<aloitustaso>] [":start"]]
Jos aloitustaso (kokonaisluku, joka on > 0) jätetään pois, kehys käyttää
resurssijoukon oletusaloitustasoa. Jos lisätään "start"-merkintä,
resurssijoukko merkitään aloitetuksi asennuksen jälkeen.
Yksinkertaiset resurssijoukon sijainnit tulkitaan suhteessa kehyksen
päähakemistoon.
Aloitustaso osoittaa OSGi-aloitustason, jolla resurssijoukko täytyy
ajaa. Jos tätä arvoa ei ole määritetty, järjestelmä laskee sopivan oletusarvon.
- osgi.bundles.defaultStartLevel
- aloitustaso, joka määritetään kaikille resurssijoukoille, jos
ne asennetaan Eclipse-päivitystenhallinnan kautta. Osgi.bundles-luettelossa määritetyt
resurssijoukot voivat määrittää erityisen aloitustason. Jos
aloitustasoa ei määritetä, oletusarvo on
osgi.bundles.defaultStartLevel-arvo. Osgi.bundles.defaultStartLevel-oletusarvo
on 4.
- osgi.clean
- jos arvo on "true", kaikki OSGi-kehyksen ja Eclipse-ajoympäristön käyttämät välimuistissa olevat tiedot
tyhjennetään. Tämä tyhjentää välimuistit, joissa säilytetään resurssijoukon
riippuvuusselvitystä ja Eclipse-ympäristön laajennusrekisteritietoja. Jos käytetään tätä asetusta,
Eclipse-ympäristön on alustettava uudelleen nämä välimuistit.
- osgi.configuration.cascaded
- jos arvo on "true", tämä kokoonpano limitetään
pääkokoonpanoon. Pääkokoonpano määritetään kohteessa osgi.sharedConfiguration.area. Lisätietoja on kohdassa Sijainnit.
- osgi.configuration.area {-configuration}
- ympäristön tämän ajon kokoonpanon sijainti. Kokoonpano
määrittää ajettavat lisäosat ja monia muita järjestelmän asetuksia.
Lisätietoja on kohdassa Sijainnit.
- osgi.configuration.area.default
- ympäristön tämän ajon kokoonpanon oletussijainti. Kokoonpano
määrittää ajettavat lisäosat ja monia muita järjestelmän asetuksia.
Tätä arvoa (eli oletusasetusta) käytetään vain, jos kohteelle osgi.configuration.area
ei ole määritetty arvoa. Lisätietoja on kohdassa Sijainnit.
- osgi.console {-console}
- jos arvo on muu kuin tyhjä, OSGi-konsoli otetaan käyttöön (jos se on asennettu).
Jos arvo on sopiva kokonaisluku, se tulkitaan portiksi, jota
konsoli kuuntelee ja johon sen tuloste ohjataan. Tästä on hyötyä
järjestelmän tilan tutkinnassa.
- osgi.console.class
- pyydettäessä ajettavan konsolin luokan nimi
- osgi.console.encoding
- jos arvo määritetään, sitä käytetään konsolin koodauksena
(lisätietoja kohdassa osgi.console). Jos
arvoa ei määritetä, käytetään file.encoding-ominaisuuden arvoa. Jollei
myöskään file.encoding-ominaisuutta ole määritetty, oletusarvo
on ISO 8859-1.
- osgi.contextClassLoaderParent
- luokanlataustoiminnon tyyppi, jota käytetään kehyksen
kontekstikohtaisen luokanlataustoiminnon pääluokanlataustoimintona. Kelvolliset lajit ovat seuraavat:
- app - sovelluksen luokanlataustoiminto.
- boot - aloituksen luokanlataustoiminto.
- ext - laajennuksen luokanlataustoiminto.
- fwk - kehyksen luokanlataustoiminto.
- ccl - alkuperäinen kontekstikohtainen
luokanlataustoiminto, joka on määritetty kehyksen aloituksen
yhteydessä (oletusarvo).
- osgi.debug {-debug}
- jos arvo on muu kuin tyhjä, ympäristö siirretään vianmääritystilaan. Jos arvo
on merkkijono, se tulkitaan
.options-tiedoston sijainniksi. Tämä tiedosto osoittaa, mitkä
vianmäärityspisteet ovat
käytettävissä
lisäosaan, sekä sen, onko ne otettu käyttöön vai ei. Jos sijaintia ei ole määritetty,
ympäristö hakee .options-tiedoston asennushakemistosta.
- osgi.dev {-dev}
- jos arvo on tyhjä merkkijono, kehitystila kytketään päälle. Tämän ominaisuuden arvoksi
voidaan myös määrittää pilkuin erotettu luettelo luokkapolkumerkinnöistä,
jotka lisätään
kunkin lisäosan luokkapolkuun, tai URL-osoite Java-ominaisuustiedostoon, joka sisältää lisäosajoukon mukautetut luokkapolkulisäykset. Kustakin lisäosasta, johon tarvitaan mukautettu kehitysajan luokkapolku,
tiedosto sisältää seuraavaa muotoa olevan merkinnän:
<lisäosan tunnus>=<pilkuin erotettu luettelo lisättävistä luokkapolkumerkinnöistä>
jossa lisäosan tunnus "*" vastaa kaikkia lisäosia, joita ei muuten ole mainittu.
- osgi.filepermissions.command
- määrittää valinnaisen käyttöjärjestelmäkohtaisen komennon,
joka asettaa poimitun alkuperäiskoodin tiedostojen käyttöoikeudet. Jotkin
käyttöjärjestelmät edellyttävät, että alkuperäiskirjastot määritetään
suoritettaviksi. Tämän valinnaisen ominaisuuden avulla voit määrittää
tämän komennon. Esimerkiksi UNIX-tyylisessä käyttöjärjestelmässä arvo voisi olla
seuraava:
osgi.filepermissions.command="chmod +rx [fullpath]"
Kehys korvaa todellisen tiedostopolun, kun [fullpath]-parametri on
määritetty.
- osgi.framework
- OSGi-kehyksen URL-sijainti. Tästä on hyötyä, jos Eclipse-asennus
on erillinen. Lisätietoja on kohdassa Sijainnit.
- osgi.frameworkClassPath
- pilkuin erotettu luettelo OSGi-kehyksen toteutuksen luokkapolkumerkinnöistä.
Suhteelliset sijainnit tulkitaan suhteessa kehyksen sijaintiin
(ks. osgi.framework)
- osgi.framework.extensions
- pilkuin erotettu luettelo kehyksen laajennuksista. Kunkin merkinnän muoto on seuraava:
<yksinkertainen resurssijoukon sijainti>
Yksinkertaisia resurssijoukon sijainteja haetaan org.eclipse.osgi
bundle-päähakemistosta. Kehyksen laajennusten avulla Eclipse-sovellus voidaan ajaa jonkin muun
kehyksen sovitustoiminnon kanssa. Kehyksen laajennus voi sisältää eclipse.properties-tiedoston, jossa määritetään
järjestelmän ominaisuudet. Esimerkiksi kehyksen laajennus, jossa toimitetaan kehyksen sovitustoiminnon
toteutus, voi määrittää sovitustoiminnon luokan
osgi.adaptor-ominaisuuden avulla.
- osgi.framework.shape
- Eclipse-ympäristön OSGi-kehyksen toteutuksen muoto. Tämä ominaisuus määritetään, kun
Eclipse-ympäristö aloitetaan, eikä käyttäjän ole tarkoitus määrittää sitä. Arvo
"jar" osoittaa, että Eclipse-ympäristön OSGi-kehys sisältyy yhteen JAR-tiedostoon.
Arvo "folder" osoittaa, että Eclipse-ympäristön OSGi-kehys sisältyy
hakemistoon.
- osgi.framework.library.extensions
- pilkuin erotettu luettelo niistä kirjastotiedostojen
lisätunnisteista, joita käytetään hauissa. Jos arvoa ei ole määritetty,
vain System.mapLibraryName(String)-metodin palauttamaa kirjaston
nimeä käytetään hauissa.
Tätä määritystä tarvitaan joissakin käyttöjärjestelmissä, jotka
sallivat kirjastolle useita tunnisteita.
Esimerkiksi AIX-käyttöjärjestelmässä sallittuja kirjastojen
tiedostotunnisteita ovat .a ja .so, mutta
System.mapLibraryName(String) palauttaa vain .a-tunnisteiset nimet.
- osgi.framework.useSystemProperties
- ohjaa sitä, käytetäänkö kehyksen ominaisuuksien
tukiominaisuuksina järjestelmän yleisiä ominaisuuksia vai ovatko
kunkin kehysilmentymän ominaisuudet yksityisiä. Oletusarvoisesti
järjestelmän ominaisuudet ovat kehyksen ominaisuuksien tukiarvoja
(eli arvo on true). Ominaisuus on hyödyllinen, kun ajetaan useita
OSGi-kehysilmentymiä samassa virtuaalikoneessa, ja kullakin
ilmentymällä on omat kokoonpanomäärityksensä (jotka on määritetty
config.ini-tiedostossa).
- osgi.genericAliases
- pilkuin erotettu luettelo yleisistä valenimistä, joiden avulla voi
määrittää vastaavuuksia olemassa olevien manifest-ylätunnisteiden sekä Eclipse-GenericCapability- ja
Eclipse-GenericRequire-manifest-ylätunnisteiden välille. Osgi.genericAliases-ominaisuudessa
käytetään seuraavaa syntaksia:
osgi.genericAliases ::= generic-alias ( ',' generic-alias ) *
generic-alias ::= capability-alias ':' require-alias ':' capability-type
Esimerkiksi OSGi:n Export-Service- ja Import-Service-ylätunnisteiden
ja Eclipse-GenericCapability- ja
Eclipse-GenericRequire-ylätunnisteiden välille voi määrittää
vastaavuuden seuraavalla arvolla:
osgi.genericAliases=Export-Service:Import-Service:osgi.service
- osgi.hook.configurators
- pilkuin erotettu ripustimien kokoonpanon
määritysohjelmien luettelo. Jos
ominaisuus on määritetty, käytetään vain määritettyjä kokoonpanon
määritysohjelmia. Hookconfigurators.properties-tiedostoissa
määritetyt ripustimien kokoonpanon määritysohjelmat ohitetaan.
- osgi.hook.configurators.include
- pilkuin erotettu ripustimien kokoonpanon
määritysohjelmien luettelo. Hyödyllinen
ominaisuus, jos haluat määrittää valinnaisia ripustimen
määritysohjelmia. Valinta ohitetaan, jos on käytetty osgi.hook.configurators-valintaa.
- osgi.hook.configurators.exclude
- pilkuin erotettu ripustimien kokoonpanon määritysohjelmien
ohitusluettelo. Tämä
on hyödyllinen ominaisuus, jos haluat poistaa käytöstä
sellaisia ripustimien
kokoonpanon määritysohjelmia, jotka on määritetty ripustimien
kokoonpanon määritysohjelmien properties-tiedostoissa. Valinta
ohitetaan, jos on käytetty osgi.hook.configurators-valintaa.
- osgi.java.profile
- käytettävän JRE-profiilitiedoston URL-osoite. Määritetty
URL-osoite luetaan Java-ominaisuustiedostona. JRE-profiili sisältää ominaisuuksien org.osgi.framework.system.packages,
org.osgi.framework.bootdelegation ja
org.osgi.framework.executionenvironment arvot. Jos
ominaisuutta osgi.java.profile ei ole määritetty, profiili valitaan käynnissä olevan
JRE-ympäristön java.specification.version-arvon perusteella.
- osgi.java.profile.bootdelegation
-
Java-profiili osgi.java.profile voi sisältää
ominaisuuden "org.osgi.framework.bootdelegation". Tämän arvon avulla voidaan määrittää järjestelmän
ominaisuus "org.osgi.framework.bootdelegation". Ominaisuuden osgi.java.profile.bootdelegation
arvo osoittaa aloituksen delegointia koskevan käytännön. Seuraavat arvot ovat kelvollisia
(oletusarvo on ignore):
- ignore - osoittaa, että
ominaisuuden "org.osgi.framework.bootdelegation" arvo Java-profiilissa ohitetaan.
Järjestelmän ominaisuuden "org.osgi.framework.bootdelegation" avulla määritetään,
mitkä paketit delegoidaan aloitukkseen.
- override -
osoittaa, että ominaisuuden "org.osgi.framework.bootdelegation" arvo Java-profiilissa
ohittaa järjestelmän ominaisuuden "org.osgi.framework.bootdelegation".
- none -
osoittaa, että ominaisuuden "org.osgi.framework.bootdelegation" arvo Java-profiilissa JA
järjestelmän ominaisuudet ohitetaan. Tämä on kaikkein tarkin asetus.
Tätä asetusta käytettäessä kehys käyttää OSGi R4 -kehyksen tarkkaa aloituksen
delegointimallia.
- osgi.install.area {-install}
- ympäristön asennussijainti. Tämä asetus osoittaa
Eclipse-peruslisäosien sijainnin, ja siitä on hyötyä, jos Eclipse-asennus on erillinen.
Lisätietoja on kohdassa Sijainnit.
- osgi.instance.area {-data}
- tämän istunnon ilmentymätietojen sijainti. Lisäosat käyttävät tätä sijaintia
tietojensa säilytykseen. Esimerkiksi Resurssit-lisäosa käyttää tätä
projektien oletussijaintina (siis työtilana). Lisätietoja on kohdassa Sijainnit.
- osgi.instance.area.default
- tämän istunnon ilmentymätietojen oletussijainti. Lisäosat käyttävät tätä sijaintia
tietojensa säilytykseen. Esimerkiksi Resurssit-lisäosa käyttää tätä
projektien oletussijaintina (siis työtilana). Tätä arvoa (eli
oletusasetusta) käytetään vain, jos kohteelle osgi.instance.area
ei ole määritetty arvoa. Lisätietoja on kohdassa Sijainnit.
- osgi.locking
- ympäristön tässä ajossa käytettävä lukituslaji. Kelvolliset lukituslajit
ovat "java.io", "java.nio" ja "none". Oletusarvo on
"java.nio";jollei JRE-ympäristö tue arvoa "java.nio", oletusarvo on "java.io".
- osgi.manifest.cache
- sijainti, jossa luodut manifest-tiedostot tunnistetaan ja luodaan. Oletusarvo
on kokoonpanoalue, mutta manifest-tiedoston välimuisti voidaan säilyttää
erikseen.
- osgi.nl {-nl}
- sen paikallistunnuksen nimi, jossa Eclipse-ympäristö ajetaan. NL-arvojen täytyy
noudattaa Java-paikallistunnusten vakionimeämiskäytäntöjä.
- osgi.nl.user
- paikallistunnuksen nimi silloin, kun käyttäjä lisää komentoriviargumentteihin
eksplisiittisen -nl-parametrin.
- osgi.noShutdown {-noExit}
- jos arvo on "true", näennäiskonetta ei lopeteta, kun Eclipse-sovellus on lopetettu. Tästä
on hyötyä tutkittaessa OSGi-kehystä Eclipse-sovelluksen lopetuksen jälkeen.
- osgi.os {-os}
- käyttöjärjestelmän arvo. Arvon täytyy olla jokin Eclipse-ympäristön tuntemista Eclipse-suoritinarkkitehtuurin
nimistä (esimerkiksi x86, sparc ja niin edelleen).
- osgi.parentClassloader
- sen luokanlataustoiminnon laji, jota käytetään pääluokanlataustoimintona kaikissa
kehykseen asennetuissa resurssijoukoissa. Kelvolliset lajit ovat seuraavat:
- app - sovelluksen luokanlataustoiminto.
- boot - aloituksen luokanlataustoiminto.
- ext - laajennuksen luokanlataustoiminto.
- fwk - kehyksen luokanlataustoiminto.
- osgi.requiredJavaVersion
- Eclipse-sovelluksen aloituksessa pakollinen Java-vähimmäisversio. Oletusarvo on
"1.4.1".
- osgi.resolverMode
- kehykseen asennettujen resurssijoukkojen tulkinnassa käytettävä tila. Jos arvo on
"strict", selvitystoiminto siirtyy tarkkaan tilaan. Selvitystoiminnon
oletustila ei ole tarkka. Kun selvitystoiminto on tarkassa tilassa, kehys käyttää
käyttörajoitussääntöjä ladatessaan luokkia ja resursseja
viedyistä paketeista, joissa on määritetty x-sisäisiä tai x-yhteensopivia käskyjä.
- osgi.sharedConfiguration.area
- ympäristön tämän ajon yhteisen kokoonpanon sijainti. Jos
ominaisuuden osgi.configuration.cascaded arvoksi on määritetty
"true", yhteistä kokoonpanoaluetta käytetään pääkokoonpanona.
- osgi.splashLocation
- Eclipse-sovellusta aloitettaessa näkyvän aloitusruudun (.bmp-tiedoston) tarkka URL-sijainti. Tämä ominaisuus ohittaa ominaisuudelle osgi.splashPath määritetyn arvon.
- osgi.splashPath
- pilkuin erotettu luettelo URL-osoitteista, joista etsitään splash.bmp-nimistä tiedostoa.
Mikä tahansa ominaisuudelle osgi.splashLocation määritetty arvo ohittaa tämän ominaisuuden.
- osgi.startLevel
- aloitustasoarvo, joka kehykselle määritetään aloituksen
yhteydessä. Oletusarvo on 6.
- osgi.support.signature.verify
- kelvollisia arvoja ovat "true" tai
"false", joista oletusarvo on "false". Jos arvoksi
määritetään "true", kehys lataa
allekirjoitetuissa JAR-tiedostoissa olevat varmenteet ja tarkistaa, ettei
sisältö ole vioittunut ajon aikana.
- osgi.syspath
- polku, jossa Eclipse-ympäristön OSGi-kehyksen (org.eclipse.osgi) toteutus
sijaitsee. Esimerkiksi "<eclipse install path>/eclipse/plugins".
Tämä ominaisuus määritetään, kun
Eclipse-ympäristö aloitetaan, eikä käyttäjän ole tarkoitus määrittää sitä.
- osgi.user.area {-user}
- käyttäjäalueen sijainti. Käyttäjäalue sisältää vain käyttöjärjestelmän käyttäjää koskevia tietoja (esimerkiksi oletusasetukset),
jotka ovat riippumattomia kaikista Eclipse-asennuksista, -kokoonpanoista
tai -ilmentymistä. Lisätietoja on kohdassa Sijainnit.
- osgi.user.area.default
- käyttäjäalueen oletussijainti. Käyttäjäalue sisältää vain käyttöjärjestelmän käyttäjää koskevia tietoja (esimerkiksi oletusasetukset),
jotka ovat riippumattomia kaikista Eclipse-asennuksista, -kokoonpanoista
tai -ilmentymistä. Tätä arvoa (eli oletusasetusta) käytetään vain, jos
kohteelle osgi.user.area ei ole määritetty arvoa. Lisätietoja on kohdassa Sijainnit.
- osgi.ws {-ws}
- ikkunointijärjestelmän arvo. Arvon täytyy olla jokin Eclipse-ympäristön tuntemista Eclipse-ikkunointijärjestelmän
nimistä (esimerkiksi win32, motif ja niin edelleen).
Sijainnit
Eclipse-ajoympäristössä määritetään useita sijainteja, joissa lisäosien
kehittäjät voivat lukea/tallentaa tietoja ja Eclipse-sovellusten käyttäjät voivat ohjata
tietojen yhteiskäytön ja näkyvyyden laajuutta. Eclipse-ympäristössä on määritetty seuraavat
sijainnit:
- Käyttäjä (-user) {osgi.user.area} [@none, @noDefault, @user.home, @user.dir,
filepath, url]
- Käyttäjän sijainnit ovat käyttäjäkohtaisia, kuten nimestä voi jo päätellä. Käyttäjän
sijainti perustuu yleensä Javan järjestelmän ominaisuuden
user.home
arvoon, mutta tämä voidaan ohittaa. Esimerkiksi käyttäjäkohtaiset oletusasetukset
ja sisäänkirjaustiedot löytyvät käyttäjän sijainnista.
- Asennus (-install) {osgi.install.area} [@user.home, @user.dir, filepath,
url]
- Asennuksen sijainti on se sijainti, johon Eclipse on asennettu. Käytännössä
tämä sijainti on hakemisto (yleensä "eclipse"), joka on
ajettavan startup.jar- tai eclipse.exe-tiedoston pääobjekti. Tämän sijainnin pitää
olla tavallisille käyttäjille vain luettava, sillä asennus voi olla monen käyttäjän
yhteiskäytössä. Asennuksen sijainti ja startup.jar on mahdollista erottaa
muusta Eclipse-ympäristöstä.
- Kokoonpano (-configuration) {osgi.configuration.area} [@none, @noDefault,
@user.home, @user.dir, filepath, url]
- Kokoonpanon sijainnit sisältävät tiedostoja, joissa yksilöidään
ajettavan asennuksen (ali)joukko ja hallinnoidaan sitä. Siten yhtä asennusta kohden voi olla monta kokoonpanoa.
Asennuksissa voi olla oletuskokoonpanoalue, mutta yleensä aloituksen yhteydessä
ajoympäristö yrittää löytää kirjoitukseen paremmin sopivan kokoonpanon
sijainnin.
- Ilmentymä (-data) {osgi.instance.area} [@none, @noDefault, @user.home,
@user.dir, filepath, url]
- Ilmentymän sijainnit sisältävät käyttäjän määrittämiä tietoartefakteja. Esimerkiksi
Resurssit-lisäosa käyttää ilmentymäaluetta työtilan sijaintina
ja siten projektien oletussijaintina. Muut lisäosat voivat vapaasti kirjoittaa
haluamiaan tiedostoja tässä sijainnissa.
Käyttäjät voivat määrittää minkä tahansa näistä sijainneista, mutta Eclipse laskee kohtuulliset
oletusarvot, ellei arvoja ole annettu. Yleisimmin määritettävä sijainti
on ilmentymäalue tai IDE-ympäristössä työtila. Voit ajaa
Eclipse-oletuskokoonpanossa tietyn tietojoukon seuraavan määrityksen avulla:
eclipse -data c:\mydata
Lisätietoja
Sijainnit ovat URL-osoitteita. Yksinkertaisuussyistä hyväksytään myös tiedostopolut, jotka muunnetaan automaattisesti
tiedoston URL-osoitteiksi. Ohjattavuuden ja käyttömukavuuden parantamiseksi on myös
joukko ennalta määritettyjä symbolisia sijainteja, joita voidaan käyttää. Huomaa, että
kaikki sijainnin lajin ja symbolisen arvon yhdistelmät eivät kelpaa. Alla olevasta taulukosta
näkyy, mitkä yhdistelmät ovat mahdollisia. Koska oletustapauksessa kaikki
sijainnit ovat määritettyjä, kelvollisia ja kirjoitettavia, osa lisäosista ei välttämättä toimi muissa asennuksissa,
vaikka ne ovat luettelon mukaan mahdollisia. Esimerkiksi käyttäjätietoihin keskittyvästä lisäosasta (esimerkiksi
Eclipse-ympäristön Resurssit-lisäosasta) ei ole todennäköisesti
juurikaan hyötyä, jollei ilmentymäaluetta ole määritetty. Lisäosien kehittäjien on valittava
tuettavat asennukset ja suunniteltava niiden toiminta vastaavasti.
- @none
- Osoittaa, että vastaavaa sijaintia ei saa koskaan määrittää
eksplisiittisesti eikä sen oletusarvoon. Esimerkiksi RCP-sovelluksen kaltainen sovellus,
jossa ei ole käyttäjätietoja, voi määrityksen osgi.instance.area=@none avulla estää
ylimääräisten tiedostojen kirjoituksen levylle. Arvon @none edellä ei saa olla
ylimääräisiä polkusegmenttejä.
- @noDefault
- Pakottaa määrittämättömän tai eksplisiittisesti määritetyn sijainnin (esimerkiksi Eclipse
ei laske automaattisesti oletusarvoa). Tästä on hyötyä, jos
haluat sallia tiedot vastaavassa sijainnissa, mutta Eclipse-oletusarvo
ei ole sopiva. Arvon @noDefault edellä ei saa olla
ylimääräisiä polkusegmenttejä.
- @user.home
- Ohjaa Eclipse-ympäristön laskemaan sijainnin arvon suhteessa käyttäjän
kotihakemistoon. Arvon @user.home perässä voi olla
ylimääräisiä polkusegmenttejä. Kaikissa tapauksissa merkkijono "@user.home"
korvataan Javan järjestelmän ominaisuuden "user.home"
arvolla. Esimerkiksi määritys
osgi.instance.area=@user.home/myWorkspace
tuottaa arvon
file:/users/bob/myWorkspace
- @user.dir
- Ohjaa Eclipse-ympäristön laskemaan sijainnin arvon suhteessa nykyiseen
työhakemistoon. Arvon @user.dir perässä voi olla
ylimääräisiä polkusegmenttejä. Kaikissa tapauksissa merkkijono "@user.dir"
korvaa Javan järjestelmän ominaisuuden "user.dir"
arvon. Esimerkiksi määritys
osgi.instance.area=@user.dir/myWorkspace
tuottaa arvon
file:/usr/share/eclipse/myWorkspace
sijainti/arvo |
tukee oletusarvoa |
tiedosto/URL
|
@none
|
@noDefault
|
@user.home
|
@user.dir
|
ilmentymä
|
kyllä |
kyllä
|
kyllä
|
kyllä
|
kyllä
|
kyllä (oletusarvo)
|
kokoonpano
|
kyllä
|
kyllä
|
kyllä*
|
kyllä*
|
kyllä
|
kyllä
|
asennus
|
ei
|
kyllä
|
ei
|
ei
|
kyllä
|
kyllä
|
käyttäjä
|
kyllä
|
kyllä
|
kyllä
|
kyllä
|
kyllä
|
kyllä
|
* osoittaa, että tämä asennus on teknisesti mahdollinen mutta käytännössä varsin
vaikeasti hallittava. Varsinkin ilman kokoonpanon sijaintia Eclipse-ajoympäristö
pystyy ehkä vain aloittamaan OSGi-kehyksen.
Lukusijainnit
Sijainti voidaan määrittää lukusijainniksi liittämällä ".readOnly"
sijainnin ominaisuuden ja määrittämällä sen arvoksi "true". Seuraavien ominaisuuksien avulla
voidaan määrittää vastaavat sijainnit lukusijainneiksi:
Aloitustoiminnon ini-tiedosto
Nykyisin eclipse.exe ja yleensäkin RCP-sovellusten ohjelmatiedostot lukevat parametrinsa niihin liittyvästä
ini-tiedostosta. Tämä tiedosto on ympäristöstä riippumaton tapa välittää sellaisia argumentteja, jotka piti aiemmin määrittää suoraan
komentorivillä, kuten näennäiskone tai VM-argumentit. Vaikka kaikki parametrit voidaankin määrittää tässä tiedostossa, hallittavuuden
ja eri asennusten johdonmukaisuuden vuoksi on suositeltavaa määrittää ini-tiedostossa vain näennäiskoneen sijainti ja VM-argumentit ja tehdä muut määritykset config.ini-tiedostossa.
Tiedostomuoto
Tämä tiedosto on nimettävä ohjelmatiedoston nimen mukaan (esimerkiksi eclipse.exe lukee eclipse.ini-tiedoston ja launcher.exe lukee launcher.ini-tiedoston), ja jokainen parametri
on määritettävä uudella rivillä tiedostossa. Seuraavassa on esimerkki tällaisesta tiedostosta, jossa määritetään näennäiskoneen sijainti ja tiettyjä parametreja:
-vm
c:/myVm/java.exe
-vmargs
-Dms40M