Kjøre Eclipse

Når du har installert Eclipse SDK i en katalog, kan du starte arbeidsbenken ved å kjøre den utførbare Eclipse-filen som følger med denne utgaven (du trenger også en 1.4.2 JRE, som ikke følger med Eclipse SDK). I Windows kalles den utførbare filen eclipse.exe og befinner seg i underkatalogen eclipse for installeringen. Hvis det er installert i c:\eclipse-SDK-3.2-win32, er den utførbare filen c:\eclipse-SDK-3.2-win32\eclipse\eclipse.exe. Merk: Konfigurering i de fleste andre operativmiljøer er ganske lik. Det finnes spesielle instruksjoner for Mac OS X nedenfor.

Tildele nok minne og løse OutOfMemoryErrors

Eclipse vil som standard tildele inntil 256 megabyte med Java-internminne. Dette skulle være tilstrekkelig for alle typiske utviklingsoppgaver. Avhengig av hvilken JRE du kjører, antall plugin-moduler du bruker, og antall filer du arbeider med, kan det imidlertid være nødvendig å øke denne mengden. Eclipse lar deg sende argumenter direkte til Java VM ved hjelp av kommandolinjeargumentet -vmargs, som må følge alle andre Eclipse-spesifikke argumenter. For å øke mengden tilgjengelig internminne bruker du gjerne

eclipse -vmargs -Xmx<minnestørrelse>

der verdien for <minnestørrelse> settes til større enn "256M" (256 megabyte -- standardverdien).

Når du bruker Sun VM, kan du også ha behov for å øke størrelsen på minnet for permanent generering. Standard maksimum er 64 megabyte, men det kan være behov for mer avhengig av plugin-modulens konfigurasjon og bruk. Maksimal permanent genereringsstørrelse økes ved hjelp av argumentet -XX:MaxPermSize=<minnestørrelse>:

eclipse -vmargs -XX:MaxPermSize=<minnestørrelse>

Dette argumentet er kanskje ikke tilgjengelig for alle VM-versjoner og -plattformer. Undersøk VM-dokumentasjonen hvis du trenger flere detaljer.

Merk at hvis du definerer minnestørrelsen som større enn mengden av fysisk tilgjengelig minne på maskinen, vil Java "flimre" idet den kopierer objekter frem og tilbake ti det virtuelle minnet, noe som vil redusere ytelsen betraktelig.

Velge arbeidsområde

Når arbeidsbenken startes, får du først frem en dialogboks der du kan velge hvor arbeidsområdet skal ligge. Arbeidsområdet er katalogen der arbeidet ditt blir lagret. Med mindre du oppgir noe annet, oppretter Eclipse arbeidsområdet i din brukerkatalog. Denne arbeidsområdekatalogen inneholder som standard prosjektene og nødvendige metadata. For delte installeringer eller installeringer med flere arbeidsområder må du eksplisitt oppgi plassering for arbeidsområdet ved hjelp av dialogboksen (eller via kommandolinjeargumentet "-data").

Her er en typisk Eclipse-kommandolinje: 

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

Tips: Det er generelt en god idé å eksplisitt oppgi hvilken Java VM som skal brukes når du kjører Eclipse. Dette gjør du ved å bruke kommandolinjeargumentet "-vm" som illustrert ovenfor. Hvis du ikke bruker "-vm", vil Eclipse bruke operativsystembanen. Hvis du installerer andre Java-baserte produkter, kan de endre banen og føre til et at en annen Java VM blir brukt når du neste gang starter Eclipse.

Slik lager du en Windows-snarvei til en installert Eclipse:

  1. Naviger til eclipse.exe i Windows Utforsker og bruk Opprett snarvei i innholdsmenyen.
  2. Velg snarvei og rediger egenskapene for den. Legg til kommandolinjeargumenter i feltet Mål.

Når du åpner denne snarveien, starter Eclipse. (Du kan dra snarveien til Windows-skrivebordet hvis du vil ha den innen rekkevidde.)

Mac OS X

På Mac OS X starter du Eclipse ved å dobbeltklikke på Eclipse-applikasjonen. Hvis du må sende argumenter til Eclipse, må du redigere filen eclipse.ini i Eclipse-applikasjonsbunten: Velg ikonet for Eclipse-applikasjonsbunten mens du holder Ctrl-tasten nede. Det får frem en hurtigmeny. Velg "Vis pakkeinnhold" i hurtigmenyen. Fin filen eclipse.ini i undermappen Contents/MacOS og åpne den i et tekstredigeringsprogram for å redigere kommandolinjealternativene.

Hvis du må starte Eclipse fra kommandolinjen, kan du bruke den symbolske linken "eclipse" i toppnivåmappen for Eclipse. Den refererer til den utførbare Eclipse-filen i applikasjonsbunten og tar de samme argumentene som "eclipse.exe" på andre plattformer.

På Mac OS X 10.4 og senere kan det være at det går saktere når du arbeider med et betydelig antall ressurser, hvis du lar Spotlight indeksere arbeidsområdet. Du kan hindre det ved å starte Systempreferanser, velge Spotlight-ikonet og så Privacy-flippen, klikke på Add-knappen ("+") og finne arbeidsområdekatalogen i dialogboksen du får frem.

Delt installering

Oppstartshastigheten til en delt installering kan forbedres hvis skikkelig hurtigbufferinformasjon lagres i det delte installeringsområdet. Etter at du har pakket ut Eclipse-distribusjonen, kjører du Eclipse en gang med alternativet "-initialize" fra en konto som har skrivetilgang til installeringskatalogen.

Avanserte emner for kjøring av Eclipse

Den utførbare Eclipse-filen og selve plattformen inneholder en rekke utføringskommandoer som er beregnet på de som utvikler og feilsøker Eclipse. Dette er en liste over alternativer som brukes hyppig. Hvis du vil se en komplett liste, går du til siden med kjøretidsalternativer for Eclipse i utviklerhåndboken for plugin-moduler for plattform. Du kan vanligvis bruke følgende kommandoer ved kjøring av en utførbar Eclipse-fil:

eclipse [plattformalternativer] [-vmargs [Java VM-argumenter]
Oppstartsparametere for Eclipse
Kommando Beskrivelse Fra og med versjon
-arch arkitektur
Definerer arkitekturen i prosessoren som Eclipse-plattformen kjører på. Eclipse-plattformen finner den optimale innstillingen ved hjelp av den gjeldende verdien for Java-egenskapen os.arch. Hvis verdien er oppgitt her, bruker Eclipse-plattformen denne verdien. Verdien som er oppgitt her er tilgjengelig for plugin-moduler som BootLoader.getOSArch(). Eksempelverdier: "x86", "sparc", "PA-RISC", "ppc". 2.0
-application applikasjons-ID
Applikasjonen som skal kjøres. Plugin-modulene deklarerer applikasjoner ved å oppgi filtype for org.eclipse.core.runtime.applications. Vanligvis er det ikke nødvendig å bruke dette argumentet. Hvis du oppgir en verdi her, overstyrer denne konfigurasjonsverdien. Hvis du ikke oppgir noen verdi, kjøres Eclipse-arbeidsbenken. 1.0
-clean
Rydder opp i hurtigbufrede data som brukes av OSGi-rammen og Eclipse-kjøretiden. Prøv å kjøre Eclipse en gang med dette alternativet hvis du observerer oppstartsfeil etter installering, oppdatering eller bruk av en felles konfigurasjon. 3.0
-configuration konfigurasjonsfil-URL
Plasseringen av konfigurasjonsfilen for Eclipse-plattformen, uttrykt som en URL-adresse. Konfigurasjonsfilen angir hvor Eclipse-plattformen skal plasseres, tilgjengelige plugin-moduler og den primære funksjonen. Merk at det ikke er tillatt med relative URL-adresser. Konfigurasjonsfilen skrives til denne plasseringen når Eclipse-plattformen installeres eller oppdateres. 2.0
-consolelog
Speiler feilloggen for Eclipse-plattformen til konsollen som brukes for å kjøre Eclipse. Nyttig i kombinasjon med -debug. 1.0
-data arbeidsområdebane
Banen til arbeidsområdet som Eclipse-plattformen skal kjøres fra. Plasseringen av arbeidsområdet er også standard plassering av prosjekter. Relative baner oppfattes som relative i forhold til katalogen som Eclipse ble startet fra. 1.0
-debug [alternativfil]
Setter plattformen i feilsøkingsmodus og laster inn feilsøkingskommandoer fra filen som ligger et bestemt sted, hvis plasseringen er oppgitt. Denne filen angir hvilke feilsøkingspunkt som er tilgjengelig for en plugin-modul, og om de er aktivert. Hvis filplasseringen ikke er oppgitt, søker plattformen etter filen .options i katalogen som Eclipse ble startet fra. Både URL-adresser og baner til filsystemer er gyldige filplasseringer. 1.0
-dev [klassebaneverdier]
Setter plattformen i utviklingsmodus. De valgfrie klassebaneverdiene (en liste med komma som skilletegn) legges til i klassebanen for kjøretid, i hver plugin-modul. Hvis arbeidsområdet inneholder plugin-moduler som utvikles, kan du ved å oppgi -dev bin legge til en klassebaneverdi for samtlige av plugin-modulprosjektets kataloger som heter bin, slik at nygenererte klassefiler legges der. Overflødige eller ikke-eksisterende klassebaneverdier elimineres. 1.0
-initialize
Initialiserer konfigurasjonen som kjøres. Alle kjøretidsrelaterte datastrukturer og hurtigbufre blir oppdatert. Nyttig med delte installeringen: Hvis du kjører Eclipse en gang med dette alternativet fra en konto med skriverettigheter, forbedrer du oppstartsytelsen. 3.0
-keyring filbane_til_nøkkelring
Plasseringen av autorisasjonsdatabasen (eller "nøkkelringfilen") på en disk. Dette argumentet må brukes sammen med alternativet -password. Relative baner oppfattes som relative i forhold til katalogen som Eclipse ble startet fra. 1.0
-nl språkmiljø
Definerer navnet på språkmiljøet som Eclipse-plattformen kjøres i. Eclipse-plattformen finner den optimale innstillingen automatisk. Hvis verdien er oppgitt her, bruker Eclipse-plattformen denne verdien. Verdien som er oppgitt her er tilgjengelig for plugin-moduler som BootLoader.getNL(). Eksempelverdier: "en_US" og "fr_FR_EURO". 2.0
-nosplash
Kjører plattformen uten å vise oppstartsbildet. 1.0
-os operativsystem
Definerer operativsystemet som Eclipse-plattformen kjøres i. Eclipse-plattformen finner vanligvis den optimale innstillingen ved hjelp av den gjeldende verdien for Java-egenskapen os.name. Hvis verdien er oppgitt her, bruker Eclipse-plattformen denne verdien. Denne verdien er tilgjengelig for plugin-moduler som BootLoader.getOS(), og blir brukt til å behandle forekomster av variabelen $os$ i baner som er oppgitt i filen for plugin-manifest. Eksempelverdier: "win32", "linux", "hpux", "solaris", "aix". 1.0
-password passord
Passordet til autorisasjonsdatabasen. Brukes sammen med alternativet -keyring. 1.0
-perspective perspektiv-ID
Perspektivet som skal åpnes under oppstart, i det aktive vinduet på arbeidsbenken. Hvis denne parameteren ikke er oppgitt, åpnes det perspektivet som var aktivt ved avslutning. 1.0
-plugincustomization
	  egenskapsfil
Plasseringen av en egenskapsfil som inneholder standardinnstillinger for plugin-preferanser. Disse standardinnstillingene overstyrer standardinnstillingene som er angitt for den primære funksjonen. Relative baner oppfattes som relative i forhold til katalogen som Eclipse ble startet fra. 2.0
-product produkt-ID
IDen for produktet som skal kjøres. Produktet gir den startede forekomsten av Eclipse en ID og fastsetter produkttilpassingsinformasjon. Dette erstatter kommandoen -feature, som fortsatt støttes av kompatibilitetsårsaker. 3.0
-refresh 
Alternativ for global oppdatering av arbeidsområdet ved oppstart. Eventuelle endringer i filsystemet siden siste kjøring av plattformen vil bli avstemt. 1.0
-showlocation [workspaceName]
Alternativ som brukes for å vise plasseringen av arbeidsområdet, på tittellinjen i vinduet. I versjon 2.0 kunne dette alternativet bare brukes med kommandolinjeargumentet -data. I 3.2 viste et valgfritt navneargument for arbeidsområdet det oppgitte navnet i vinduets tittellinje i stedet for arbeidsområdets plassering. 2.0
-vm VM-bane
Plasseringen av Java Runtime Environment (JRE), som Eclipse-plattformen skal kjøres i. Hvis den ikke er oppgitt, finnes JRE i jre sideordnet den utførbare Eclipse-filen. Relative baner oppfattes som relative i forhold til katalogen som Eclipse ble startet fra. 1.0
-vmparametere parametere
Når dette alternativet sendes til Eclipse, tilpasses operasjonen av Java VM som kjører Eclipse. Når dette alternativet brukes, må det stå til sist på en kommandolinje. De angitte argumentene avhenger av hvilken VM som kjøres. 1.0

Alle argumenter som følger etter (men ikke omfatter) verdien -vmargs, sendes direkte til den oppgitte Java VM som virtuelle maskinparametere (det vil si før klassen som skal kjøres). Merk: Hvis et oppstartsargument for Eclipse (for eksempel -data) oppgis etter Java VM-argumenter (-vmargs), starter ikke Eclipse og du vil motta en feilmelding om at JVM er avsluttet, og at avslutningskoden er 1.