Dopo aver installato (decompresso) il programma di installazione Eclipse in una directory (ad esempio, c:\eclipse), il workbench viene avviato eseguendo il file eseguibile Eclipse che si trova nella directory di installazione di primo livello Il nome del file è eclipse.exe nei sistemi Windows e semplicemente eclipse nei sistemi Linux. La descrizione riportata di seguito fornisce informazioni sulla procedura di installazione nei sistemi Windows. L'installazione su Linux è analoga.
Se non viene specificato diversamente, la piattaforma crea una directory di area di lavoro predefinita di pari livello dell'eseguibile (ad esempio, c:\eclipse\workspace). Questa directory di area di lavoro viene utilizzata sia come area predefinita del contenuto dei progetti sia per contenere tutti i metadati richiesti. Per le installazioni condivise o con più aree di lavoro è necessario indicare esplicitamente la posizione dell'area di lavoro invece di utilizzare quella predefinita. Esistono due modi per controllare la posizione dell'area di lavoro: utilizzare la directory di lavoro corrente oppure l'argomento della riga di comando -data.
Il modo più facile per utilizzare la directory di lavoro corrente consiste nel creare un collegamento attraverso i seguenti passaggi:
È possibile ottenere lo stesso effetto utilizzando un prompt di comando che modifica la directory nella directory dell'area di lavoro ed esegue il file eclipse.exe.
Per utilizzare l'argomento della riga di comando -data, basta aggiungere -data <posizione dell'area di lavoro> (ad esempio, -data c:\myworkspace) alla riga "Destinazione:" del collegamento o includerla esplicitamente nella riga di comando del prompt di comando.
Il file eseguibile di Eclipse e la stessa piattaforma offrono un numero di opzioni di esecuzione di interesse per gli utenti che sviluppano o eseguono il debug di parti di Eclipse. Il formato più comune di esecuzione del file eseguibile di Eclipse è:
eclipse [opzioni di piattaforma] [-vmargs [argomenti Java VM]]
dove le opzioni di piattaforma valide sono rappresentate da:
-application <id app> | Identifica l'applicazione da eseguire. Se non è specificata, verrà eseguito il workbench di Eclipse. Le applicazioni vengono dichiarate dai plug-in che forniscono estensioni al punto di estensione delle applicazioni org.eclipse.core.runtime . |
-boot <percorso del codice di avvio> | Definisce il percorso del codice plug-in di avvio (ad esempio, boot.jar). Questa opzione risulta necessaria solo quando viene modificata la posizione relativa di startup.jar e boot.jar. |
-consolelog | Riflette il log degli errori della piattaforma sulla console utilizzata per eseguire Eclipse. |
-data <percorso dell'area di lavoro> | Definisce il percorso dell'area di lavoro nella quale eseguire la piattaforma. |
-debug [percorso del file di opzioni] | Mette la piattaforma in modalità debug e carica le opzioni di debug nel file specificato. Se non è determinato un percorso di file, la piattaforma cerca un file denominato ".options" nella directory di installazione della piattaforma e nella directory di metadati dell'area di lavoro. |
-dev [voci percorso classi] | Mette la piattaforma in modalità di sviluppo. Le voci percorso classi facoltative (un elenco separato da virgola) vengono aggiunte a ogni percorso classi del plug-in. Ad esempio, durante lo sviluppo dei plug-in, utilizzare "-dev bin" per aggiungere la directory bin degli strumenti Java per ciascun plug-in. Le voci percorso classi ridondanti o inesistenti verranno eliminate. |
-nosplash | Esegue la piattaforma senza visualizzare la schermata iniziale. |
-os <id-os> | Definisce il sistema operativo nel quale viene eseguita la piattaforma. Di solito la piattaforma è in grado di individuare il sistema operativo, ma alcune situazioni possono richiedere specifiche esplicite. Questo valore è correlato a Platform.getOS(). |
-vm <percorso vm> | Specifica la VM Java da utilizzare nell'esecuzione della piattaforma. Se non è specificata, una VM Java viene posizionata accanto al file eseguibile di Eclipse. |
-ws <id-ws> | Definisce il sistema Windows nel quale viene eseguita la piattaforma. Di solito la piattaforma è in grado di individuare il sistema Windows, ma alcune situazioni possono richiedere specifiche esplicite. Questo valore è correlato a Platform.getWS(). |
Tutti gli argomenti che seguono (senza tuttavia includere) la voce -vmargs vengono passati direttamente attraverso la VM Java indicata come argomenti della virtual machine (ad esempio, prima dell'esecuzione della classe). Tutti gli argomenti che precedono la voce -vmargs (ad eccezione di -vm e -nosplash) vengono passati, invece, direttamente attraverso la piattaforma per l'interpretazione.
eclipse.exe [argomenti eclipse] -vm <percorso di j9w.exe> -vmargs -ms:20 -jit -mo:32000 -mx:200000
NOTA: il flag -vmargs e gli argomenti vm effettivi devono essere inseriti al termine della riga.
Le impostazioni predefinite vm per Linux IBM JDK 1.3 sono efficaci per un'esplorazione iniziale, ma risultano insufficienti per uno sviluppo di maggiori proporzioni. Per uno sviluppo in larga scala è necessario modificare gli argomenti vm per disporre di un heap maggiore:
-vmargs -Xmx256M
consentirà all'heap Java di arrivare a 256MB.