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ä.
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ä.
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:
eclipse.exe
-ohjelmatiedosto ja
käytä pikavalikossa pikavalinnan luontikomentoa.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ä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.
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-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]]
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".