Esecuzione di Eclipse

Dopo aver installato (decompresso) il driver Eclipse in una directory (ad esempio, c:\eclipse), avviare il workbench avviando il file eseguibile Eclipse che si trova nella directory di installazione di primo livello. Il file eseguibile è denominato eclipse.exe nei sistemi Windows e eclipse nei sistemi Linux. Nota: la descrizione riportata di seguito illustra la configurazione su sistemi Windows. La configurazione su Linux è analoga.

Se non viene specificata altrimenti, Eclipse richiede di specificare una directory per lo spazio di lavoro. Il percorso predefinito di tale directory è un elemento secondario della directory principale dell'utente denominata "workspace" (ad esempio, c:\Documents and Settings\My Name\workspace). Questa directory dello spazio di lavoro viene utilizzata come area di contenuto predefinita per i progetti e per contenere tutti i metadati necessari. Per le installazioni condivise o con più spazi di lavoro è necessario indicare esplicitamente il percorso dello spazio di lavoro piuttosto che utilizzare quello predefinito. Oltre a immettere semplicemente un percorso diverso al prompt, è possibile anche utilizzare l'argomento di riga comandi -data.

Impostazione di un percorso specifico per lo spazio di lavoro mediante -data

Per utilizzare l'argomento della riga comandi -data, aggiungere -data percorso_spazio_di_lavoro (ad esempio, -data c:\users\robert\workspaceutente) al campo Destinazione nelle proprietà del collegamento o includerlo esplicitamente nella riga comandi.

Impostazione della VM Java mediante -vm

Si consiglia di specificare esplicitamente la Java VM da utilizzare durante l'esecuzione di Eclipse. Questa operazione può essere eseguita mediante l'argomento della riga comandi -vm (ad esempio, -vm c:\jre\bin\javaw.exe). Non specificando -vm, Eclipse utilizzerà la prima Java VM presente nel percorso O/S. L'installazione di altri prodotti potrebbe modificare il percorso specificato, quindi al successivo avvio di Eclipse potrebbe essere utilizzata una Java VM diversa.

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
-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
-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 
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. 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.

Esecuzione su diverse VM 

Esecuzione di Eclipse su J9

Quando si esegue Eclipse su J9 versione 1.5, si consiglia di utilizzare le seguenti opzioni VM:

eclipse.exe [argomenti eclipse] -vm path_to_j9w.exe 
            -vmargs -ms:32 -mm:2048 -mo:32768 -moi:32768 -mca:32 -mco:128 -mx:2000000

Quando si esegue Eclipse su J9 versione 2.0, gli argomenti predefiniti scelti da J9W dovrebbero essere adatti. Tuttavia, per sostituire i parametri automaticamente impostati internamente dal file eseguibile di Eclipse è necessario specificare -vmargs senza alcun argomento, nel modo seguente:

eclipse.exe [argomenti eclipse] -vm path_to_j9w.exe -vmargs

Per ulteriori informazioni, consultare la documentazione VM J9 e la Guida.

Esecuzione Eclipse sul kit sviluppatore IBM, Java(TM) Technology Edition VM

Le impostazioni predefinite VM per il kit sviluppatore IBM, Linux Java(TM) Technology Edition 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. Ad esempio, la seguente impostazione consentirà all'heap Java di arrivare a 256MB: 

-vmargs -Xmx256M