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:

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:
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):
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:
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