Udfør Eclipse

Efter installation af Eclipse SDK i et bibliotek kan du starte arbejdsbænken ved at udføre den eksekvérbare Eclipse-fil, der er inkluderet i denne release (du skal også bruge en 1.4.2 JRE, der ikke er inkluderet i Eclipse SDK). I Windows kaldes den eksekvérbare fil eclipse.exe. Den findes i underbiblioteket eclipse til installationen. Hvis installationen er foretaget til c:\eclipse-SDK-3.2-win32, findes den eksekvérbare fil i c:\eclipse-SDK-3.2-win32\eclipse\eclipse.exe. Bemærk: Installationen på de fleste andre styresystemer svarer til denne. Særlige instruktioner til Mac OS X vises nedenfor.

Allokér tilstrækkelig hukommelse, og løs hukommelsesproblemer

Som standard allokerer Eclipse op til 256 MB hukommelse til Java-hoben. Det er rigeligt til typiske udviklingsopgaver. Afhængig af den JRE, du anvender, antallet af plugins, du anvender, og antallet af filer, du arbejder med, kan du have behov for at øge mængden af hukommelse. I Eclipse kan du sende argumenter direkte til Java-VM med brug af kommandolinjeargumentet -vmargs, der skal efterstilles alle andre Eclipse-specifikke argumenter. Så for at øge den tilgængelige hobhukommelse, skal du typisk bruge:

eclipse -vmargs -Xmx<hukommelsesstørrelse>

hvor værdien for <hukommelsesstørrelse> angives til noget større end "256M", da 256 MB er standard.

Når du anvender Sun VM, kan du også få brug for at øge størrelsen af den permanente genereringshukommelse. Standardmaksimum er 64 MB, men der kan være behov for mere, afhængig af din plugin-konfiguration og -anvendelse. Maksimum for permanent genereringsstørrelse øges vha. argumentet -XX:MaxPermSize=<hukommelsesstørrelse>:

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

Argumentet er måske ikke tilgængeligt for alle VM-versioner og platforme. Der er oplysninger herom i VM-dokumentationen.

Bemærk, at hvis hukommelsesstørrelsen øges, så den overskrider den tilgængelige fysiske hukommelse på maskinen, vil Java "stå i stampe" (thrash), fordi objekter kopieres frem og tilbage til den virtuelle hukommelse, og det vil påvirke ydeevnen kraftigt.

Vælg et arbejdsområde

Når arbejdsbænken startes, er det første, du ser, en dialogboks, hvor du kan vælge, hvor arbejdsområdet skal placeres. Arbejdsområdet er det bibliotek, hvor dit arbejde gemmes. Hvis du ikke angiver andet, opretter Eclipse arbejdsområdet i dit brugerbibliotek. Dette arbejdsområdebibliotek bruges som standardindholdsområde for dine projekter samt til opbevaring af eventuelle påkrævede metadata. Hvis du installerer fælles arbejdsområde eller multiarbejdsområde, skal du angive placeringen af arbejdsområdet i dialogboksen eller med kommandolinjeargumentet "-data".

Dette er en typiske Eclipse-kommandolinje: 

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

Tip: Det anbefales, at du eksplicit angiver, hvilken Java VM der skal bruges, når du udfører Eclipse. Dette opnås med kommandolinjeargumentet "-vm" som vist nedenfor. Hvis du ikke bruger "-vm", vil Eclipse søge i styresystemets sti. Når du installerer andre Java-produkter, kan de ændre stien, hvilket betyder, at der anvendes en anden Java VM, næste gang du starter Eclipse.

Sådan opretter du en Windows-genvej til en installeret Eclipse:

  1. Navigér til eclipse.exe i Windows Explorer og vælg Opret genvej på genvejsmenuen.
  2. Vælg genvejen, og redigér dens Egenskaber. Tilføj kommandolinjeargumenterne i feltet Destination.

Du starter Eclipse ved at åbne genvejen. Du kan trække genvejen til skrivebordet, så den er nemmere at få fat i.

Mac OS X

På Mac OS X starter du Eclipse ved at dobbeltklikke på Eclipse-programmet. Hvis du skal sende argumenter til Eclipse, skal du redigere filen eclipse.ini i Eclipses programbundt: Vælg ikonen for Eclipses programbundt ved at holde Ctrl-tasten nede. Du får vist en pop op-menu. Vælg "Vis pakkeindhold" på pop op-menuen. Find filen eclipse.ini i underfolderen Contents/MacOS, og åbn den med din foretrukne teksteditor for at redigere kommandolinjeparametrene.

Hvis du skal starte Eclipse fra kommandolinjen, kan du bruge det symbolske link "eclipse" i Eclipse-folderen på øverste niveau. Den henviser til den eksekvérbare Eclipse-fil i programbundtet og anvender de samme argumenter som "eclipse.exe" på andre platforme.

På Mac OS X 10.4 og nyere kan maskinen arbejde langsommere med et stort antal ressourcer, hvis du lader Spotlight indeksere arbejdsområdet. For at forhindre dette skal du starte systemindstillingerne, vælge ikonen Spotlight, derefter skillebladet Fortrolighed og klikke på knappen Tilføj ("+") og finde arbejdsområdebiblioteket i den dialogboks, der vises.

Fælles installation

Opstartshastigheden for en fælles installation kan forbedres, hvis korrekte cache-oplysninger er gemt i det fælles installationsområde. Du opnår dette ved at udføre Eclipse én gang, når du har udpakket Eclipse-distributionen med parameteren "-initialize" fra en konto, der har skriveadgang til installationsbiblioteket.

Udvidede indstillinger ved udførelse af Eclipse

Den eksekvérbare fil til Eclipse og selve platformen indeholder en række udførelsesindstillinger, som kan være interessante for personer, der udvikler eller udfører fejlfinding i dele af Eclipse. Her er en liste over almindeligt anvendte indstillinger. Du finder en komplet liste over indstillingerne på den side, der beskriver Eclipse-runtime-indstillinger i Eclipse Platform - plugin-udviklervejledning. Det almindelige format for udførelse af den eksekvérbare Eclipse-fil er:

eclipse [platformindstillinger] [-vmargs [Java VM-argumenter]]
Eclipse-startparametre
Kommando Beskrivelse Siden
-arch arkitektur
Definerer den processorarkitektur, som Eclipse-platformen udføres på. Eclipse-platformen beregner den optimale indstilling på normal vis vha. den øjeblikkelige værdi af Java-egenskaben os.arch. Hvis værdien er angivet her, bliver det den værdi, som Eclipse-platformen bruger. Den værdi, der angives her, er tilgængelig for plugins som BootLoader.getOSArch(). Eksempler på værdier: "x86", "sparc", "PA-RISC", "ppc". 2.0
-application program-id
Det program, der skal udføres. Programmer erklæres af plugins, der leverer udvidelser til udvidelsespunktet org.eclipse.core.runtime.applications. Der er typisk ikke brug for dette argument. Hvis værdien angives, tilsidesætter værdien den værdi, som konfigurationen leverer. Hvis den ikke angives, udføres Eclipse-arbejdsbænken. 1.0
-clean
Rydder op i data i cache, der anvendes af OSGi-strukturen og Eclipse-runtime. Prøv at udføre Eclipse med denne parameter, hvis der er fejl ved start efter installation, opdatering eller ved brug af en fælles installation. 3.0
-configuration URLTilKonfigurationsfil
Placeringen af konfigurationsfilen til Eclipse-platformen, udtrykt som en URL. Konfigurationsfilen bestemmer placeringen af Eclipse-platformen, det tilgængelige sæt plugins og den primære funktion. Bemærk, at relative URL'er ikke er tilladt. Konfigurationsfilen skrives til denne placering, når Eclipse-platformen installeres eller opdateres. 2.0
-consolelog
Spejler Eclipse-platformens fejllog til den konsol, som bruges til at udføre Eclipse. Praktisk ved kombination med -debug. 1.0
-data stiTilArbejdsområde
Stien til det arbejdsområde, som Eclipse-platformen skal udføres på. Placeringen af arbejdsområdet er også standardplacering for projekter. Relative stier fortolkes relativt i forhold til det bibliotek, som Eclipse er startet fra. 1.0
-debug [indstillingsfil]
Sætter platformen i fejlfindingstilstand og indlæser fejlfindingsindstillingerne fra filen på den angivne placering. Denne fil angiver, hvilke fejlfindingspunkter der er tilgængelige for en plugin, og om de aktiveres eller ej. Hvis der ikke angives en filplacering, søger platformen i det bibliotek, som Eclipse er startet fra, efter en fil med navnet ".options". Både URL'er og filsystemstier er tilladt som filplaceringer. 1.0
-dev [classpath-indgange]
Sætter platformen i udviklingstilstand. De valgfrie classpath-indgange (en kommasepareret liste) tilføjes til runtime-classpath for de enkelte plugins. Når arbejdsområdet f.eks. indeholder plugins, der er under udvikling, og du angiver -dev bin, tilføjes en classpath-indgang for alle plugin-projekters bibliotek med navnet bin, så nyligt genererede klassefiler kan findes der. Overflødige eller ikke-eksisterende classpath-indgange inkluderes ikke. 1.0
-initialize
Initialiserer den konfiguration, der udføres. Alle runtime-relaterede datastrukturer og cachelagre opfriskes. Praktisk ved fælles installationer: Hvis du udfører Eclipse én gang med denne parameter fra en konto med skriveadgang, forbedres ydeevnen ved start. 3.0
-keyring stiTilNøgleringsfil
Placeringen af autorisationsdatabasen (eller "nøgleringsfilen") på disken. Dette argument skal bruges sammen med indstillingen -password. Relative stier fortolkes relativt i forhold til det bibliotek, som Eclipse er startet fra. 1.0
-nl sprogkonventioner
Definerer navnet på de sprogkonventioner, som Eclipse-platformen udføres under. Eclipse-platformen beregner automatisk den optimale indstilling på normal vis. Hvis værdien er angivet her, bliver det den værdi, som Eclipse-platformen bruger. Den værdi, der angives her, er tilgængelig for plugins som BootLoader.getNL(). Eksempler på værdier: "en_US" og "fr_FR_EURO". 2.0
-nosplash
Udfører platformen uden at vise åbningsskærmbilledet. 1.0
-os styresystem
Definerer det styresystem, som Eclipse-platformen udføres på. Eclipse-platformen beregner den optimale indstilling på normal vis vha. den øjeblikkelige værdi af Java-egenskaben os.name. Hvis værdien er angivet her, bliver det den værdi, som Eclipse-platformen bruger. Den værdi, der er angivet her, er tilgængelig for plugins som BootLoader.getOS() og bruges til at fortolke forekomster af variablen $os$ i stier, der er nævnt i plugin'ens manifestfil. Eksempel på værdier: "win32", "linux", "hpux", "solaris", "aix". 1.0
-password kodeord
Kodeordet til autorisationsdatabasen. Bruges sammen med indstillingen -keyring. 1.0
-perspective perspektiv-id
Det perspektiv, der skal åbnes i det aktive arbejdsbænkvindue ved start. Hvis parameteren ikke er angivet, åbnes det perspektiv, som var aktivt, da arbejdsbænken blev lukket. 1.0
-plugincustomization
	  egenskabsfil
Placeringen af en egenskabsfil, der indeholder standardindstillinger for plugins. Disse standardindstillinger tilsidesætter de standardindstillinger, der er angivet i den primære funktion. Relative stier fortolkes relativt i forhold til det bibliotek, som Eclipse er startet fra. 2.0
-product produkt-id
Id'en til det produkt, der skal udføres. Produktet giver den startede forekomst af Eclipse sin personlighed og bestemmer, hvilke produkttilpasningsoplysninger der skal bruges. Dette erstatter -feature, som stadig understøttes af hensyn til kompatibiliteten. 3.0
-refresh 
Indstilling til udførelse af en global opfriskning af arbejdsområdet ved start. Dette afstemmer eventuelle ændringer, foretaget af filsystemet, siden sidste gang platformen blev udført. 1.0
-showlocation [workspaceName]
Indstilling til visning af placeringen af arbejdsområdet på vinduets titellinje. I release 2.0 fungerede denne indstilling kun sammen med kommandolinjeargumentet -data. I 3.2 blev et valgfrit argument for arbejdsområdenavn tilføjet, der viser det leverede navn i vinduestitellinjen i stedet for placeringen af arbejdsområdet. 2.0
-vm vmSti
Placeringen af den JRE (Java Runtime Environment), der skal bruges til at udføre Eclipse-platformen. Hvis det ikke angives, anvendes værdien jre, som placerer JRE'et sideordnet med den eksekvérbare Eclipse-fil. Relative stier fortolkes relativt i forhold til det bibliotek, som Eclipse er startet fra. 1.0
-vmargs argumenter
Når denne indstilling videregives til Eclipse, tilpasser den funktionen af det Java VM, der bruges til at udføre Eclipse. Hvis indstillingen angives, skal den være placeret til sidst på kommandolinjen. Argumenterne afhænger af den VM, der udføres. 1.0

Alle argumenter, der følger efter (men ikke inkluderer) indgangen -vmargs, videregives direkte til den angivne Java VM som virtual machine-argumenter (dvs. inden den klasse, der skal udføres). Bemærk: Hvis et Eclipse-startargument, f.eks. -data, leveres efter Java vm-argumenterne (-vmargs), starter Eclipse ikke, og du får fejlmeddelelsen "JVM afbrudt. Afslutningskode=1".