Esecuzione di Eclipse

Dopo aver installato Eclipse SDK in una directory, è possibile avviare il Workbench eseguendo il file Eclipse incluso con il rilascio (è necessario anche JRE 1.4.2, non incluso in Eclipse SDK). Su Windows, il file eseguibile si chiama eclipse.exe, e si trova nella sottodirectory eclipse del percorso di installazione. Se installato in c:\eclipse-SDK-3.2-win32, il file eseguibile sarà c:\eclipse-SDK-3.2-win32\eclipse\eclipse.exe. Nota: le operazioni di impostazione per la maggior parte dei sistemi operativi sono simili. Per Mac OS X sono riportate informazioni particolari di seguito.

Assegnazione di memoria sufficiente e risoluzione di errori OutOfMemoryErrors

Per impostazione predefinita, Eclipse assegnerà un massimo di 256 megabyte di memoria heap Java. Questa memoria è necessaria per tutte le attività di sviluppo tipiche. Tuttavia, a seconda del JRE che viene eseguito, il numero di plug-in aggiuntivi che viene utilizzato e dal numero di file in uso, potrebbe essere necessario dover aumentare questa quantità. Eclipse consente di passare gli argomenti direttamente alla VM Java mediante l'argomento della riga comandi -vmargs che deve seguire tutti gli altri argomenti specifici di Eclipse. Pertanto, per aumentare la memoria heap immettere:

eclipse -vmargs -Xmx<dimensione memoria>

con il valore di <dimensione memoria> maggiore di "256M" (256 megabyte è il valore predefinito).

Se si utilizza Sun VM, potrebbe essere necessario aumentare anche la dimensione della memoria permanente. Il valore predefinito è 64 megabyte, ma potrebbe essere necessaria più memoria in base alla configurazione dei plug-in e dall'uso. La dimensione massima permanente viene aumentata mediante l'argomento -XX:MaxPermSize=<dimensione memoria>:

eclipse -vmargs -XX:MaxPermSize=<dimensione memoria>

Questo argomento potrebbe non essere disponibile per tutte le versioni e le piattaforme VM; consultare la documentazione della VM per maggiori dettagli.

L'impostazione su un valore maggiore della dimensione della memoria rispetto alla quantità di memoria fisica disponibile sulla macchina provoca una "interruzione anomala" di Java in quanto gli oggetti vengono copiati continuamente nella memoria virtuale e pertanto le prestazioni risulteranno ridotte.

Selezione di uno spazio di lavoro

Quando il workbench viene avviato, viene visualizzata una finestra di dialogo che consente di selezionare la posizione dello spazio di lavoro. Lo spazio di lavoro è la directory in cui verrà memorizzato il lavoro. Se non viene specificata altrimenti, lo spazio di lavoro verrà creato nella directory utente. Questa directory dello spazio di lavoro viene utilizzata come area di contenuto predefinita per i progetti e per contenere tutti i metadati necessari. Per uno spazio di lavoro condiviso o multiplo è necessario specificare esplicitamente il percorso dello spazio di lavoro utilizzando la finestra di dialogo o l'argomento della riga comandi "-data".

Di seguito è riportata una riga comandi di Eclipse tipica: 

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

Suggerimento: generalmente è preferibile specificare esplicitamente la Java VM da utilizzare durante l'esecuzione di Eclipse. Questa impostazione può essere eseguita mediate l'argomento della riga comandi "-vm", come mostrato precedentemente. Se non si utilizza l'argomento "-vm", Eclipse ricercherà la directory nel percorso del sistema operativo. L'installazione di altri prodotti potrebbe modificare il percorso specificato, quindi al successivo avvio di Eclipse potrebbe essere utilizzata una Java VM diversa.

Per creare un collegamento di Windows a una versione di Eclipse installata:

  1. Passare a eclipse.exe in Esplora risorse di Windows e utilizzare Crea collegamento dal menu contestuale.
  2. Selezionare il collegamento e modificarne le proprietà. Nel campo Destinazione immettere gli argomenti della riga comandi.

Selezionando questo collegamento verrà avviato Eclipse. È possibile trascinare il collegamento sul desktop di Windows in modo che sia più facilmente raggiungibile.

Mac OS X

Su Mac OS X, Eclipse viene avviato facendo doppio clic sull'applicazione Eclipse. Se è necessario passare degli argomenti a Eclipse, sarà necessario modificare il file eclipse.ini all'interno del bundle dell'applicazione Eclipse selezionando l'icona e tenendo premuto il tasto Control. verrà visualizzato un menu a comparsa. Selezionare "Mostra contenuto pacchetto" dal menu. Individuare il file eclipse.ini nella cartella Contenuto/MacOS e aprirlo con un editor di testo per modificare le opzioni della riga comandi.

Se è necessario avviare Eclipse dalla riga comandi, è possibile utilizzare il collegamento simbolico "eclipse" nella cartella eclipse. Esso fa riferimento all'eseguibile di Eclipse all'interno del bundle dell'applicazione e utilizza gli stessi argomenti di "eclipse.exe" su altre piattaforme.

Su Mac OS X 10.4 e successivo, è possibile che si verifichi un rallentamento quando si utilizza un numero elevato di risorse e se si consente a Spotlight di indicizzare lo spazio di lavoro. Per impedire ciò, avviare Preferenze di sistema, selezionare l'icona Spotlight, quindi la scheda Privacy e fare clic sul pulsante Aggiungi ("+") e individuare la directory dello spazio di lavoro nella finestra visualizzata.

Installazione condivisa

La velocità di avvio di una installazione condivisa può essere migliorata se le informazioni sulla cache sono memorizzate nell'area di installazione condivisa. Per far ciò, dopo aver decompresso la distribuzione Eclipse, eseguire Eclipse una volta con l'opzione"-initialize" da un account che ha un accesso in scrittura sulladirectory di installazione.

Argomenti avanzati nell'esecuzione di Eclipse

Il file eseguibile di Eclipse e la stessa piattaforma offrono una serie di opzioni di esecuzione di grande interesse per gli utenti che sviluppano o eseguono il debug di parti di Eclipse. Questo è un elenco delle opzioni usate più frequentemente; per l'elenco completo consultare la pagina delle opzioni runtime di Eclipse nella guida per lo sviluppatore di plugin di piattaforma. Il formato più comune di esecuzione del file eseguibile di Eclipse è:

eclipse [opzioni di piattaforma] [-vmargs [argomenti Java VM]]
Parametri di avvio di Eclipse
Comando Descrizione Da
-arch architecture
Definisce l'architettura del processore su cui viene eseguita la piattaforma Eclipse. Tale piattaforma di solito calcola l'impostazione ottimale utilizzando il valore prevalente della proprietà os.arch di Java. Se specificato, rappresenta il valore utilizzato dalla piattaforma Eclipse. Il valore specificato in questa sede è disponibile per i plugin come BootLoader.getOSArch(). Valori di esempio: "x86", "sparc", "PA-RISC", "ppc". 2.0
-application applicationId
Applicazione da eseguire. Le applicazioni vengono dichiarate dai plugin che forniscono le estensioni al punto di estensione org.eclipse.core.runtime.applications. Generalmente, questo argomento non è necessario. Se specificato, il valore sovrascrive quello fornito dalla configurazione. Se non specificato, viene eseguito il workbench di Eclipse. 1.0
-clean
Cancella i dati memorizzati nella cache utilizzati dalla struttura OSGi e dal runtime Eclipse. Provare a eseguire Eclipse una volta con questa opzione se si verificano errori di avvio in seguito all'installazione o all'aggiornamento o se si utilizza una configurazione condivisa. 3.0
-configuration configurationFileURL
Il percorso del file di configurazione della piattaforma Eclipse, espresso come URL. Il file di configurazione determina il percorso della piattaforma Eclipse, l'insieme di plugin disponibili e la funzione principale. Non sono consentiti gli URL relativi. Il file di configurazione viene inserito in questo percorso quando viene installata o aggiornata la piattaforma Eclipse. 2.0
-consolelog
Riflette il log degli errori della piattaforma Eclipse sulla console utilizzata per eseguire Eclipse. Utile se combinato con -debug. 1.0
-data workspacePath
Il percorso dello spazio di lavoro in cui eseguire la piattaforma Eclipse. Il percorso dello spazio di lavoro rappresenta anche il percorso predefinito per i progetti. I percorsi relativi sono intesi come relativi alla directory da cui è stato avviato Eclipse. 1.0
-debug [optionsFile]
Attiva la modalità debug della piattaforma e carica le opzioni di debug dal file nel percorso dato, se specificato. Questo file indica i punti di debug disponibili per un plugin e se sono attivati o meno. Se non viene indicato alcun percorso file, la piattaforma tenterà di individuare il file ".options" nella directory in cui eclipse è stato avviato. Come percorso file è possibile specificare sia URL che percorsi del file system. 1.0
-dev [classpathEntries]
Mette la piattaforma in modalità di sviluppo. Le voci del percorso classi facoltative (un elenco separato da virgole) vengono aggiunte al percorso classi di runtime di ciascun plugin. Ad esempio, quando lo spazio di lavoro contiene i plugin in fase di sviluppo, specificando -dev bin verrà aggiunta una voce del percorso classi per ogni plugin contenuto nella directory del progetto bin, in modo che i file di classe appena generati possano essere individuati. Le voci del percorso classi ridondanti o inesistenti verranno eliminate. 1.0
-initialize
Inizializza la configurazione in esecuzione. Vengono aggiornate tutte le cache e le strutture dei dati relativi al runtime. Con le installazioni condivise, l'esecuzionedi Eclipse una volta con questa opzione da un account con privilegi di scrittura migliorerà le prestazioni di avvio. 3.0
-keyring keyringFilePath
Il percorso del database delle autorizzazioni (o file "key ring") sul disco. Questo argomento deve essere utilizzato insieme all'opzione -password. I percorsi relativi sono intesi come relativi alla directory da cui è stato avviato Eclipse. 1.0
-nl locale
Definisce il nome delle impostazioni internazionali con cui viene eseguita la piattaforma Eclipse. Tale piattaforma di solito calcola automaticamente l'impostazione ottimale. Se specificato, rappresenta il valore utilizzato dalla piattaforma Eclipse. Il valore specificato in questa sede è disponibile per i plugin come BootLoader.getNL(). Valori di esempio: "en_US" and "fr_FR_EURO". 2.0
-nosplash
Esegue la piattaforma senza visualizzare la schermata iniziale. 1.0
-os operatingSystem
Definisce il sistema operativo su cui viene eseguita la piattaforma Eclipse. Tale piattaforma di solito calcola l'impostazione ottimale utilizzando il valore prevalente della proprietà os.name di Java. Se specificato, rappresenta il valore utilizzato dalla piattaforma Eclipse. Il valore specificato in questa sede è disponibile per i plugin come BootLoader.getOS()e viene utilizzato per risolvere le occorrenze della variabile $os$ nei percorsi indicati nel file manifest del plugin. Valori di esempio: "win32", "linux", "hpux", "solaris", "aix". 1.0
-password password
Password per il database delle autorizzazioni. Utilizzata insieme all'opzione -keyring. 1.0
-perspective perspectiveId
Prospettiva da aprire nella finestra del workbench attiva all'avvio. Se questo parametro non viene specificato, verrà aperta la prospettiva attiva al momento della chiusura. 1.0
-plugincustomization
	  propertiesFile
Il percorso di un file delle proprietà che contiene le impostazioni predefinite per le preferenze di plugin. Tali impostazioni predefinite sovrascrivono quelle specificate nella funzione principale. I percorsi relativi vengono intesi come relativi alla directory da cui è stato avviato eclipse. 2.0
-product productId
L'ID del prodotto da eseguire. Il prodotto attribuisce all'istanza avviata di Eclipse la propria impostazione e determina le informazioni utilizzate per la personalizzazione. Sostituisce -feature, che è ancora supportata per la compatibilità. 3.0
-refresh 
Opzione per l'esecuzione di un aggiornamento completo dello spazio di lavoro all'avvio. In tal modo verranno applicate le modifiche effettuate nel file system dopo l'ultima esecuzione della piattaforma. 1.0
-showlocation [workspaceName]
Opzione per la visualizzazione del percorso dello spazio di lavoro sulla barra del titolo della finestra. Nella versione 2.0 questa opzione funzionava solo se utilizzata insieme all'argomento della riga comandi -data. In 3.2, è stato aggiunto un argomento di denominazione dello spazio di lavoro facoltativo che visualizza il nome specificato nella barra del titolo della finestra invece che nel percorso dello spazio di lavoro. 2.0
-vm vmPath
Il percorso del JRE (Java Runtime Environment) da utilizzare per eseguire la piattaforma Eclipse. Se non specificato, il JRE si trova in jre, di pari livello del file eseguibile di Eclipse. I percorsi relativi vengono intesi come relativi alla directory da cui è stato avviato eclipse. 1.0
-vmargs args
Quando passata a Eclipse, questa opzione viene utilizzata per personalizzare l'operazione del Java VM usato per eseguire Eclipse. Se specificata, questa opzione deve trovarsi alla fine della riga comandi. Gli argomenti dipendono dal VM in esecuzione. 1.0

Tutti gli argomenti che seguono (senza tuttavia includere) la voce -vmargs vengono passati direttamente attraverso la VM Java indicata come argomenti della virtual machine (ovvero, prima dell'esecuzione della classe). Nota: Se dopo l'argomento di Java vm (-vmargs) viene specificato un argomento di avvio Eclipse, ad esempio -data, Eclipse non verrà avviato e verrà ricevuto il messaggio "JVM terminato. Codice di chiusura=1" errore.