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 JRE version 1.4.2, 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 den installerats på c:\eclipse-SDK-3.2-win32 är den körbara filen c:\eclipse-SDK-3.2-win32\eclipse\eclipse.exe. Obs! 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 256 megabyte Java-högminne. Normalt räcker det gott och väl till alla vanliga utvecklingsuppgifter. Det kan emellertid 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 "256M" (256 megabyte - standard).

När du använder en 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å din insticksprogramskonfiguration och användning. 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 dina projekt 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").

Här är en typisk Eclipse-kommandorad: 

eclipse -vm c:\jdk1.4.2\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änder Eclipse O/S-sö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 snabbmeny. Välj "Visa paketinnehåll" på snabbmenyn. Sök filen eclipse.ini i undermappen Contents/MacOS och öppna den med önskad textredigerare när du vill redigera kommandoradsalternativen.

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 låter Spotlight 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 BootLoader.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 configurationFileURL
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 BootLoader.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 BootLoader.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 istä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 inget annat anges är JRE jre, på samma nivå som den körbara filen för Eclipse. 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). Obs! 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".