Köra Eclipse

När du har installerat Eclipse SDK i en katalog kan du starta arbetsmiljön genom att köra den körbara Eclipse-filen som medföljer versionen (du behöver även en Java SE 5 JRE, som inte ingår i Eclipse SDK). I Windows har den körbara filen namnet eclipse.exe och finns i underkatalogen eclipse för installationen. Om det har installerats i c:\eclipse-SDK-4.1-win32 är den körbara filen c:\eclipse-SDK-4.1-win32\eclipse\eclipse.exe. Anm. Installationen i de flesta andra operativmiljöer är likartad. Särskilda instruktioner för Mac OS X anges nedan.

Allokera tillräckligt med minne och lösa OutOfMemoryErrors

Som standard allokerar Eclipse upp till 384 megabyte Java-högminne. Normalt räcker det gott och väl till alla vanliga utvecklingsuppgifter. Det kan tänkas att du, beroende på den JRE du kör, antalet ytterligare insticksprogram som du använder och antalet filer du arbetar med, behöver öka mängden. I Eclipse kan du skicka argument direkt till Java VM med kommandoradsargumentet -vmargs, som måste följa alla andra Eclipse-specifika argument. För att öka det tillgängliga högminnet använder du vanligen:

eclipse -vmargs -Xmx<memory size>

med värdet <memory size> angivet som större än "384M" (384 megabyte - standard).

När du använder en Oracle (Sun) VM kan du även behöva öka storleken på minnet för permanent generering. Maximistorleken är som standard 64 megabyte, men mer kan behövas beroende på insticksprogramskonfigurationen och användning. Om minnet för permanent generering tar slut för VM-maskinen kan den krascha när klassen läses in. Det här felet är mindre vanligt i Sun JRE version 1.5.0_07 och senare. Maximistorleken för permanent generering ökas med argumentet -XX:MaxPermSize=<memory size>:

eclipse -vmargs -XX:MaxPermSize=<memory size>

Det här argumentet kanske inte är tillgängligt för alla VM-versioner och plattformar. Mer information finns i VM-dokumentationen.

Observera att om du anger större minnesstorlek än det tillgängliga fysiska minne som finns på datorn kommer Java att krascha eftersom objekt kopieras fram och tillbaka till det virtuella minnet, vilket ger en kraftig prestandaförsämring.

Välja en arbetsyta

När arbetsmiljön startas visas en dialogruta där du kan välja var arbetsytan ska finnas. Arbetsytan är den katalog där arbetet lagras. Om du inte anger något annat skapar Eclipse arbetsytan i användarkatalogen. Arbetsytekatalogen är standardkatalog för projekten samt för alla metadata som behövs. För delade installationer eller installationer på flera arbetsytor måste du explicit ange platsen för arbetsytan med hjälp av dialogrutan (eller via kommandoradsargumentet "-data").

Ange den virtuella Java-maskinen

Här är en typisk Eclipse-kommandorad: 

eclipse -vm c:\jdk5u22\jre\bin\javaw

Tips! Det är alltid bra att explicit ange vilken Java VM som ska användas när du kör Eclipse. Det uppnås med kommandoradsargumentet "-vm" enligt ovan. Om du inte använder "-vm" används operativsystemssökvägen. När du installerar andra Java-baserade produkter kan sökvägen ändras och orsaka att en annan Java VM används nästa gång du startar Eclipse.

Så här skapar du en Windows-genväg till ett installerat Eclipse:

  1. Navigera till eclipse.exe i Utforskaren och använd Skapa genväg på innehållsmenyn.
  2. Markera genvägen och redigera dess egenskaper. Ange kommandoradsargumenten i fältet Mål.

När du öppnar den här genvägen startas Eclipse. (Du kan dra genvägen till skrivbordet om du vill ha den bekvämt inom räckhåll.)

Mac OS X

In Mac OS X startar du Eclipse genom att dubbelklicka på Eclipse-tillämpningen. Om du behöver skicka argument till Eclipse måste du redigera filen eclipse.ini i Eclipse-tillämpningspaketet: klicka på ikonen för Eclipse-tillämpningspaketet samtidigt som du håller ned ctrl-tangenten. Då visas en kontextmeny. Välj "Visa paketinnehåll" på menyn. Leta rätt på filen eclipse.ini i underkatalogen Contents/MacOS och öppna den i en textredigerare och redigera kommandoradsalternativen.

Mac OS X: Det går endast att starta användargränssnittsprogram flera gånger om du har olika kopior av programmet på hårddisken. Orsaken till det är att alla användargränssnittsprogram i Mac OS X kan öppna fler program, så vanligtvis finns det inget behov av att öppna ett program flera gånger. Eftersom Eclipse inte kan öppna flera arbetsytor innebär att du måste göra en kopia av Eclipse-installationen om du vill öppna flera arbetsytor samtidigt (fel 139319).

Om du behöver starta Eclipse från kommandoraden kan du använda den symboliska länken "eclipse" i Eclipse-mappen på den översta nivån. Den refererar till den körbara Eclipse-filen i tillämpningspaketet och tar samma argument som "eclipse.exe" på andra plattformar.

I Mac OS X 10.4 och senare kan det hända att det går långsammare när du arbetar med en betydande mängd resurser om du använder Spotlight till att indexera arbetsytan. Du kan förhindra det genom att starta Systeminställningar, välja ikonen Spotlight, sedan fliken Sekretess och sedan klicka på knappen Lägg till ("+") och sök arbetsytekatalogen i den dialogruta som visas.

Delad installation

Starthastigheten för en delad installation kan förbättras om rätt cacheinformation lagras i området för delad installation. Det uppnås genom att du, efter att ha zippat upp Eclipse-distributionen, kör Eclipse en gång med alternativet "-initialize" från ett konto som har skrivåtkomst till installationskatalogen.

Avancerade avsnitt i Köra Eclipse

I den körbara filen för Eclipse samt i själva plattformen finns ett antal körningsalternativ för personer som utvecklar och felsöker delar av Eclipse. Här följer en lista med de vanligaste alternativen. En fullständig lista finns på sidan med alternativ för Eclipse Runtime i Utvecklarhandbok för insticksprogram. Det allmänna formatet för en körbar fil i Eclipse är:

eclipse [alternativ för plattformen] [-vmargs [Java VM-argument]]
Startparametrar i Eclipse
Kommando Beskrivning Sedan
-arch architecture
Definierar processorarkitekturen som Eclipse-plattformen körs på. Eclipse-plattformen beräknar vanligtvis den optimala inställningen med hjälp av det aktuella värdet för Java-egenskapen os.arch. Om värdet är angivet används det av Eclipse-plattformen. Värdet görs tillgängligt för insticksprogram som Platform.getOSArch(). Exempelvärden: "x86", "sparc", "PA-RISC", "ppc". 2.0
-application applicationId
Den tillämpning som ska köras. Tillämpningarna deklareras av insticksprogram som tillhandahåller tillägg för utökningspunkten org.eclipse.core.runtime.applications. Argumentet brukar inte behövas. Om värdet anges åsidosätter det värdet som tillhandahålls av konfigurationen. Om värdet inte anges körs Eclipse-arbetsmiljön. 1.0
-clean
Rensar cachelagrade data som används av OSGi-ramverket och Eclipse Runtime. Försök att köra Eclipse en gång med det här alternativet om du observerar startfel efter installation, uppdatering eller användning av en delad konfiguration. 3.0
-configuration configURL
Platsen för Eclipse-plattformens konfigurationsfil, uttryckt som en URL. Konfigurationsfilen bestämmer platsen för Eclipse-plattformen, uppsättningen med tillgängliga insticksprogram och den primära funktionen. Kom ihåg att relativa URL-adresser inte kan användas. Konfigurationsfilen skrivs till den här platsen när Eclipse-plattformen installeras eller uppdateras. 2.0
-consolelog
Speglar Eclipse-plattformens fel till den konsol som används för att köra Eclipse. Detta är praktiskt i kombination med -debug. 1.0
-data workspacePath
Sökvägen till den arbetsyta där Eclipse-plattformen ska köras. Platsen för arbetsytan är även standardplatsen för projekt. Relativa sökvägar tolkas med utgångspunkt i den katalog där Eclipse startades. 1.0
-debug [optionsFile]
Försätter plattformen i felsökningsläge och läser in felsökningsalternativen från filen till en angiven plats, om en sådan finns. Filen anger vilka felsökningspunkter som är tillgängliga för ett insticksprogram och om de är aktiverade eller inte. Om filens plats inte anges söker plattformen efter filen ".options" i startkatalogen för Eclipse. Både URL-adresser och filsystemsökvägar kan användas som filplatser. 1.0
-dev [classpathEntries]
Försätter plattformen i utvecklingsläge. De valfria klassökvägsposterna (en kommaavgränsad lista) läggs till i klassökvägen under körning för varje insticksprogram. Exempel: När arbetsytan innehåller insticksprogram under utveckling och du anger -dev bin, läggs en klassökvägspost till för katalogen bin för varje insticksprogramprojekt. Här hamnar alla nya genererade klassfiler. Överflödiga eller obefintliga klassökvägsposter tas bort. 1.0
-initialize
Initierar den konfiguration som körs. Alla Runtime-relaterade datastrukturer och -cacheminnen uppdateras. Praktisk vid delade installationer: om du kör Eclipse en gång med det här alternativet från ett konto med skrivbehörigheter förbättras startprestanda. 3.0
-keyring keyringFilePath
Platsen för auktoriseringsdatabasen (eller "keyring"-filen) på disken. Argumentet måste användas tillsammans med alternativet -password. Relativa sökvägar tolkas med utgångspunkt i den katalog där Eclipse startades. 1.0
-nl locale
Definierar språkmiljön som Eclipse-plattformen körs på. Eclipse-plattformen beräknar vanligtvis den optimala inställningen automatiskt. Om värdet är angivet används det av Eclipse-plattformen. Värdet görs tillgängligt för insticksprogram som Platform.getNL(). Exempelvärden: "en_US" och "fr_FR_EURO". 2.0
-nosplash
Kör plattformen utan att visa välkomstskärmen. 1.0
-os operatingSystem
Definierar operativsystemet som Eclipse-plattformen körs på. Eclipse-plattformen beräknar vanligtvis den optimala inställningen med hjälp av det aktuella värdet för Java-egenskapen os.name. Om värdet är angivet används det av Eclipse-plattformen. Värdet görs tillgängligt för insticksprogram som Platform.getOS() och används för att tolka förekomster av variabeln $os$ i de sökvägar som nämns i insticksprogrammets manifestfil. Exempelvärden: "win32", "linux", "hpux", "solaris", "aix". 1.0
-password password
Lösenord för auktoriseringsdatabasen. Används tillsammans med alternativet -keyring. 1.0
-perspective perspectiveId
Det perspektiv som ska öppnas i det aktiva arbetsmiljöfönstret vid start. Om parametern inte anges öppnas det perspektiv som var aktivt när programmet avslutades. 1.0
-plugincustomization
	  propertiesFile
Platsen för en egenskapsfil som innehåller standardinställningar för insticksprogram. De standardinställningarna åsidosätter de standardinställningar som angetts i huvudfunktionen. Relativa sökvägar tolkas med utgångspunkt i den katalog där eclipse startades. 2.0
-product productId
ID för den produkt som ska köras. Produkten ger den startade Eclipse-förekomsten sin "personlighet" och bestämmer vilken anpassningsinformation som ska användas för produkten. Detta ersätter -feature vilken fortfarande kan användas för kompatibilitet. 3.0
-refresh 
Alternativ för global uppdatering av arbetsytan vid start. Detta stämmer av de ändringar som gjorts i filsystemet sedan plattformen senast kördes. 1.0
-showlocation [workspaceName]
Alternativ för att visa platsen för arbetsytan i fönstrets namnlist. I release 2.0 fungerade det här alternativet endast tillsammans med kommandoradsargumentet -data. I 3.2 har ett valfritt arbetsytenamn lagts till som visar det angivna namnet i fönstrets rubrikrad i stället för platsen för arbetsytan. 2.0
-vm vmPath
Platsen för den JRE (Java Runtime Environment) som ska användas till att köra Eclipse-plattformen. Om den inte är angiven, försöker startfunktionen att hitta en JRE. Det söker först efter en katalog som heter jre, på samma nivå som den körbara Eclipse-filen, och söker sedan i operativsystemets sökväg. Relativa sökvägar tolkas med utgångspunkt i den katalog där eclipse startades. 1.0
-vmargs args
När kommandot skickas till Eclipse används alternativet för att anpassa hur den Java VM som används för att köra Eclipse fungerar. Om alternativet anges måste det stå i slutet av kommandoraden. Vilka argument som anges beror på vilken VM som körs. 1.0

Alla argument som kommer efter posten -vmargs skickas direkt till angiven Java VM som argument för virtuell maskin (dvs. före den klass som ska köras). Anm. Om ett startargument för Eclipse, till exempel -data, anges efter Java VM-argumenten (-vmargs), startar inte Eclipse och du får felmeddelandet "JVM avslutad. Exit code=1".