Eclipse-ohjelmiston käyttäminen

Kun Eclipse SDK -ohjelmisto on asennettu hakemistoon, voit aloittaa työympäristön ajamalla Eclipse-versioon sisältyvän ohjelmatiedoston (lisäksi järjestelmässä on oltava JRE 1.4.2 -ympäristö, joka ei sisälly Eclipse SDK -asennukseen). Windows-käyttöjärjestelmässä ohjelmatiedosto on eclipse.exe, ja se on asennushakemiston eclipse-alihakemistossa. Jos asennus on esimerkiksi tehty hakemistoon c:\eclipse-SDK-3.2-win32, ohjelmatiedoston polku on c:\eclipse-SDK-3.2-win32\eclipse\eclipse.exe. Huomautus: Rakenne on sama useimmissa muissa käyttöjärjestelmissä. Mac OS X -käyttöjärjestelmän erityisohjeet ovat jäljempänä.

Riittävän muistimäärän varaus ja muistin loppumisvirheiden ratkaisu

Oletusarvon mukaan Eclipse-ympäristö varaa 256 megatavua Java-kekomuistia. Sen pitäisi riittää kaikkiin normaaleihin kehitystyön tehtäviin. Muistin määrää on kuitenkin ehkä kasvatettava sen mukaan, mitä JRE-ympäristöä ja kuinka monta lisäosaa käytät sekä millaisia tiedostomääriä käsittelet. Eclipse-ympäristössä voit välittää argumentteja suoraan Java-näennäiskoneeseen käyttämällä komentorivin -vmargs-argumenttia. Tämän argumentin on oltava kaikkien muiden Eclipse-ympäristön argumenttien perässä. Voit lisätä käytettävissä olevaa kekomuistia esimerkiksi seuraavalla komennolla:

eclipse -vmargs -Xmx<muistin määrä>

Määritä <muistin määrä> -arvo suuremmaksi kuin "256M" (oletusarvo on 256 megatavua).

Jos käytät Sunin näennäiskonetta, pysyvän luontimuistin määrää on myös ehkä lisättävä. Oletusarvon mukaan enimmäismäärä on 64 megatavua, mutta suurempi määrä voi olla tarpeen lisäosakokoonpanon ja käytön mukaan. Voit lisätä pysyvän luontimuistin kokoa argumentilla -XX:MaxPermSize=<muistin määrä>:

eclipse -vmargs -XX:MaxPermSize=<muistin määrä>

Tämä argumentti ei ole ehkä käytettävissä kaikissa näennäiskoneversioissa ja käyttöympäristöissä. Lisätietoja on näennäiskoneen ohjeissa.

Jos määrität muistien määrät suuremmaksi kuin koneen käytettävissä olevan fyysisen muistin määrä, Java-järjestelmä toimii epätasaisesti, koska se joutuu kopioimaan objekteja näennäismuistiin toistuvasti. Tämä heikentää järjestelmän suorituskykyä.

Työtilan valinta

Kun aloitat työympäristön, ensimmäisenä tulee näkyviin valintaikkuna, josta voit valita työtilan sijainnin. Työtila on hakemisto, johon työsi tallentuvat. Jos et määritä muuta sijaintia, Eclipse-ympäristö luo työtilan käyttäjähakemistoosi. Tätä työtilahakemistoa käytetään projektien oletussisältöalueena, minkä lisäksi sinne tallennetaan tarvittavat metatiedot. Jos käytät yhteiskäytössä olevaa tai usean työtilan asennusta, määritä työtilan sijainti erikseen valintaikkunassa (tai käyttämällä komentorivin argumenttia -data).

Seuraavassa on tyypillinen Eclipse-komentorivin komento: 

eclipse -vm c:\jdk1.4.2\jre\bin\javaw

Vihje: Yleensä käytettävä Java-näennäiskone kannattaa määrittää erikseen, kun ajat Eclipse-ympäristöä. Voit tehdä sen komentorivin argumentilla -vm edellä kuvatulla tavalla. Jos et käytä "-vm"-argumenttia, Eclipse-ympäristö etsii näennäiskonetta käyttöjärjestelmän polusta. Kun asennat muita Java-tuotteita, ne voivat muuttaa polkumääritystä, jolloin Eclipse-ympäristö voi ottaa käyttöön muun kuin odotetun Java-näennäiskoneen seuraavalla aloituskerralla.

Voit luoda Windows-käyttöjärjestelmän pikavalinnan asennettuun Eclipse-ympäristöön seuraavasti:

  1. Etsi Windowsin Resurssienhallinnassa eclipse.exe-ohjelmatiedosto ja käytä pikavalikossa pikavalinnan luontikomentoa.
  2. Valitse pikavalinta ja muokkaa sen ominaisuuksia. Lisää komentorivin argumentit Kohde:-kenttään.

Voit aloittaa Eclipse-ympäristön tätä pikavalintaa napsauttamalla. (Voit vetää pikavalinnan Windowsin työpöydälle, jos haluat sen olevan helposti käytettävissä.)

Mac OS X -käyttöjärjestelmä

Mac OS X -käyttöjärjestelmässä voit aloittaa Eclipse-ympäristön kaksoisosoittamalla Eclipse-sovellusta. Jos haluat välittää Eclipse-ympäristöön argumentteja, muokkaa Eclipse-sovelluspaketin eclipse.ini-tiedostoa. Pidä Ctrl-näppäintä painettuna ja valitse Eclipse-sovelluspaketin kuvake. Näkyviin tulee pikavalikko. Valitse pikavalikosta Näytä pakkauksen sisältö -vaihtoehto. Etsi Contents/MacOS-alikansiosta eclipse.ini-tiedosto ja muokkaa komentoriviasetuksia avaamalla tiedosto haluamassasi tekstinmuokkausohjelmassa.

Jos haluat aloittaa Eclipse-ympäristön komentoriviltä, voit käyttää ylätason Eclipse-kansion symbolista eclipse-linkkiä. Se on viittaus sovelluspaketin Eclipse-ohjelmatiedostoon ja voit käyttää sen kanssa samoja argumentteja kuin muiden käyttöjärjestelmien eclipse.exe-ohjelmatiedostoissa.

Mac OS X -käyttöjärjestelmän versiossa 10.4 ja uudemmissa versioissa ympäristön toiminta voi hidastua, kun käsittelet suuria määriä resursseja ja olet määrittänyt Spotlight-hakutoiminnon indeksoimaan työtilan. Voit estää hidastumisen aloittamalla Järjestelmäasetukset-sovelluksen, osoittamalla Spotlight-kuvaketta, valitsemalla Yksityisyys-välilehden ja osoittamalla lisäyspainiketta (+). Etsi työympäristön hakemisto näkyviin tulevassa valintaikkunassa.

Jaettu asennus

Voit parantaa jaetun asennuksen aloitusnopeutta tallentamalla oikeat välimuistitiedot yhteiskäytössä olevalle asennusalueelle. Voit tehdä tämän sen jälkeen, kun olet purkanut Eclipse-jakelun. Aja Eclipse-ympäristö kertaalleen -initialize-valinnalla käyttämällä käyttäjätunnusta, jolla on kirjoitusoikeudet asennushakemistoon.

Eclipse-ohjelmiston käyttämiseen liittyviä lisätietoja

Eclipse-ohjelmatiedostoon ja itse käyttöympäristöön liittyy useita suoritusvaihtoehtoja, joiden avulla Eclipse-ohjelmiston osia voi kehittää tai osissa voi tehdä vianmäärityksen. Seuraavassa on usein käytettyjen asetuksien luettelo. Koko luettelo on saatavilla Platform-sovelluskehittäjän oppaassa ajonaikaisten Eclipse-asetusten sivulla. Eclipse-ohjelmatiedoston yleinen ajomuoto on seuraava:

eclipse [käyttöympäristön asetukset] [-vmargs [Java VM -argumentit]]
Eclipse-ohjelmiston aloitusparametrit
Komento Kuvaus Käytettävissä versiosta
-arch arkkitehtuuri
Määrittää suoritinarkkitehtuurin, jossa Eclipse-käyttöympäristöä käytetään. Eclipse-käyttöympäristö laskee yleensä optimaalisen asetuksen käyttämällä Java-ominaisuuden os.arch käytössä olevaa arvoa. Jos arvo on määritetty, Eclipse-käyttöympäristö käyttää sitä. Lisäosat voivat hakea tässä määritetyn arvon metodilla BootLoader.getOSArch(). Esimerkkiarvot: "x86", "sparc", "PA-RISC", "ppc". 2.0
-application sovellustunnus
Ajettava sovellus. Laajennuspisteeseen org.eclipse.core.runtime.applications laajennuksia toimittavat lisäosat ilmoittavat sovellukset. Tätä argumenttia ei yleensä tarvita. Jos argumentti määritetään, sen arvo ohittaa kokoonpanon järjestelmään kuuluvan arvon. Jos argumenttia ei määritetä, ajettava sovellus on Eclipse Workbench. 1.0
-clean
OSGi-kehyksen ja ajonaikaisen Eclipse-ympäristön käyttämien välimuistin tietojen tyhjennys. Jos aloituksessa ilmenee virheitä asennuksen tai päivityksen jälkeen tai, kun käytät yhteiskäytössä olevaa kokoonpanoa, aja Eclipse-ympäristö kertaalleen käyttämällä tätä asetusta. 3.0
-configuration kokoonpanotiedoston_URL-osoite
Eclipse Platform -kokoonpanotiedoston sijainti URL-osoitteena. Kokoonpanotiedosto määrittää Eclipse-käyttöympäristön sijainnin, käytettävissä olevien lisäosien sarjan sekä ensisijaisen tuoteominaisuuden. Huomaa, että suhteelliset URL-osoitteet eivät ole sallittuja. Järjestelmä kirjoittaa kokoonpanotiedoston tähän sijaintiin, kun Eclipse-käyttöympäristö asennetaan tai päivitetään. 2.0
-consolelog
Peilaa Eclipse-käyttöympäristön virhelokin konsoliin, jossa Eclipse ajetaan. Hyödyllinen yhdessä argumentin -debug kanssa. 1.0
-data työtilan_polku
Sen työtilan polku, jossa Eclipse-käyttöympäristö ajetaan. Työtilan sijainti on myös projektien oletussijainti. Järjestelmä tulkitsee suhteelliset polut suhteessa siihen hakemistoon, josta Eclipse on käynnistetty. 1.0
-debug [asetustiedosto]
Asettaa käyttöympäristön vianmääritystilaan ja lataa vianmääritysasetukset annetussa sijainnissa olevasta tiedostosta, jos sijainti on määritetty. Tiedosto osoittaa, mitkä vianmäärityspisteet ovat lisäosan käytettävissä, sekä sen, onko ne otettu käyttöön. Jos tiedoston sijaintia ei ole annettu, käyttöympäristö etsii Eclipse-ohjelmiston käynnistyshakemistosta .options-tiedostoa. Tiedoston sijainniksi hyväksytään sekä URL-osoitteet että tiedostojärjestelmän polut. 1.0
-dev [luokkapolkumerkinnät]
Siirtää käyttöympäristön kehitystilaan. Valinnaiset luokkapolkumerkinnät (pilkkueroteltu luettelo) lisätään kunkin lisäosan ajonaikaiseen luokkapolkuun. Jos työtila esimerkiksi sisältää kehitettävinä olevia lisäosia, asetuksen -dev bin määrittäminen lisää kunkin lisäosaprojektin hakemistoon luokkapolkumerkinnän nimeltä bin, ja sinne voidaan sijoittaa vastaluodut luokkatiedostot. Järjestelmä poistaa reduntantit luokkapolkumerkinnät ja sellaisten luokkapolkujen merkinnät, joita ei ole. 1.0
-initialize
Ajettavan kokoonpanon alustus. Kaikki ajoympäristöön liittyvät tietorakenteet ja välimuistit verestetään. Tätä asetusta kannattaa käyttää yhteiskäytössä olevissa asennuksissa. Ympäristön aloitus nopeutuu, kun ajat Eclipse-ympäristön kertaalleen käyttämällä tätä asetusta ja käyttäjätunnusta, jolla on kirjoitusoikeudet. 3.0
-keyring avainrengastiedoston_polku
Valtuutustietokannan (eli "avainrengastiedoston") sijainti levyllä. Tätä argumenttia on käytettävä yhdessä asetuksen -password kanssa. Järjestelmä tulkitsee suhteelliset polut suhteessa siihen hakemistoon, josta Eclipse on käynnistetty. 1.0
-nl paikallistunnus
Määrittää sen paikallistunnuksen nimen, jossa Eclipse-käyttöympäristö ajetaan. Tavallisesti Eclipse-käyttöympäristö laskee parhaan mahdollisen asetuksen automaattisesti. Jos arvo on määritetty, Eclipse-käyttöympäristö käyttää sitä. Lisäosat voivat hakea tässä määritetyn arvon metodilla BootLoader.getNL(). Esimerkkiarvot: "en_US" ja "fr_FR_EURO". 2.0
-nosplash
Ajaa käyttöympäristön ilman alkuanimaatiota. 1.0
-os käyttöjärjestelmä
Määrittää käyttöjärjestelmän, jossa Eclipse-käyttöympäristö ajetaan. Eclipse-käyttöympäristö laskee yleensä optimaalisen asetuksen käyttämällä Java-ominaisuuden os.name käytössä olevaa arvoa. Jos arvo on määritetty, Eclipse-käyttöympäristö käyttää sitä. Lisäosat voivat hakea tässä määritetyn arvon metodilla BootLoader.getOS(), ja sen avulla järjestelmä tulkitsee muuttujan $os$ esiintymät poluilla, jotka on mainittu lisäosan manifest-tiedostossa. Esimerkkiarvot: "win32", "linux", "hpux", "solaris", "aix". 1.0
-password salasana
Valtuustietokannan salasana. Tätä käytetään yhdessä asetuksen -keyring kanssa. 1.0
-perspective perspektiivin_tunnus
Käynnistyksen yhteydessä aktiivisessa työympäristön ikkunassa avattava perspektiivi. Jos parametria ei määritetä, järjestelmä avaa edellisen sulkemisen yhteydessä aktiivisena olleen perspektiivin. 1.0
-plugincustomization
	  ominaisuustiedosto
Lisäosa-asetusten oletusasetukset sisältävän ominaisuustiedoston sijainti. Nämä oletusasetukset ohittavat ensisijaisessa tuoteominaisuudessa määritetyt oletusasetukset. Järjestelmä tulkitsee suhteelliset polut suhteessa siihen hakemistoon, josta Eclipse on käynnistetty. 2.0
-product tuotetunnus
Ajettavan tuotteen tunnus. Tuote määrittää käynnistetyn Eclipse-ilmentymän tietovirran ja määrittää, mitä tuotteen mukautustietoja käytetään. Tämä korvaa asetuksen -feature, jota järjestelmä tukee yhteensopivuuden vuoksi. 3.0
-refresh 
Mahdollisuus toteuttaa työtilan yleisverestys käynnistyksen yhteydessä. Tällöin otetaan käyttöön muutokset, joita tiedostojärjestelmään on tehty käyttöympäristön edellisen ajokerran jälkeen. 1.0
-showlocation [työtilan_nimi]
Asetus, joka tuo työtilan sijainnin näyttöön ikkunan otsikkoriviin. Versiossa 2.0 tämä asetus toimi vain yhdessä komentorivin argumentin -data kanssa. Versiossa 3.2 ympäristöön lisättiin valinnainen työtilan nimen määrittävä argumentti, joka määrittää ikkunan otsikkopalkissa näytettäväksi annetun nimen työtilan sijainnin sijasta. 2.0
-vm VM-polku
Eclipse-käyttöympäristön ajoon käytettävän JRE (Java Runtime Environment) -ympäristön sijainti. Jos attribuuttia ei määritetä, JRE on kohteessa jre, Eclipse-ohjelmatiedoston rinnakkaisobjektissa. Järjestelmä tulkitsee suhteelliset polut suhteessa siihen hakemistoon, josta Eclipse on käynnistetty. 1.0
-vmargs argumentit
Kun tämä asetus välittyy Eclipselle, sen avulla mukautetaan Eclipse-ohjelmiston ajoon käytetyn Java VM:n toimintaa. Jos tämä asetus on määritetty, sen on oltava komentorivin lopussa. Annetut argumentit määräytyvät ajoon käytetyn näennäiskoneen mukaan. 1.0

Järjestelmä siirtää kaikki argumenttia -vmargs seuraavat argumentit (mutta ei argumenttia -vmargs) suoraan ilmoitettuun Java VM -ympäristöön näennäiskoneen argumentteina (eli ennen ajettavaa luokkaa). Huomautus: Jos Eclipse-ohjelmiston käynnistysargumentti, kuten -data, annetaan Java VM -argumenttien (-vmargs) jäljessä, Eclipse ei käynnisty ja näyttöön tulee virhesanoma "JVM lopetettu. Lopetuskoodi: 1".