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