Dopo aver installato (decompresso) il driver Eclipse in una directory (ad esempio, c:\eclipse), avviare il Workbench eseguendo 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 specificato diversamente, la piattaforma crea una directory predefinita per l'area di lavoro di pari livello dell'eseguibile (ad esempio, c:\eclipse\workspace). Questa directory dell'area 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ù aree di lavoro è necessario indicare esplicitamente la posizione dell'area di lavoro piuttosto che utilizzare quella predefinita. Esistono due modi per controllare la posizione dell'area di lavoro: utilizzare la directory di lavoro corrente o 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:
E 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 your_workspace_location
(ad esempio, -data c:\myworkspace
)
al campo Destinazione nelle proprietà del collegamento o includerla esplicitamente nella riga di comando.
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. Il formato più comune di esecuzione del file eseguibile di Eclipse è:
eclipse [opzioni di piattaforma] [-vmargs [argomenti Java VM]]
Comando | Descrizione | |
---|---|---|
-configuration configurationFileURL |
Posizione per il file di configurazione della piattaforma Eclipse, espresso come URL. Il file di configurazione determina la posizione della piattaforma Eclipse, l'insieme di plug-in disponibili e la funzione principale. Non sono consentiti gli URL relativi. Il file di configurazione viene inserito in questa posizione quando la piattaforma Eclipse viene installata o aggiornata. | 2.0 |
-data workspacePath |
Percorso dell'area di lavoro nella quale eseguire la piattaforma Eclipse. La posizione dell'area di lavoro rappresenta anche la posizione predefinita per i progetti. I percorsi relativi vengono intesi come relativi alla directory da cui è stato avviato Eclipse. | 1.0 |
-dev [classpathEntries] |
Mette la piattaforma in modalità di sviluppo. Le voci percorso classi facoltative (un elenco separato da virgola) vengono aggiunte al percorso classi di run-time di ogni plug-in. Ad esempio, quando l'area di lavoro contiene i plug-in in corso di sviluppo, specificando -dev bin si aggiungerà una voce percorso classi per ogni plug-in contenuto nella directory del progetto denominata bin , in modo da consentire il reperimento dei file di classe appena generati. Le voci percorso classi ridondanti o inesistenti verranno eliminate. |
1.0 |
-feature featureId |
ID della funzione principale. La funzione principale attribuisce all'istanza avviata di Eclipse la propria impostazione di prodotto e determina le informazioni utilizzate per la personalizzazione del prodotto. | 2.0 |
-plugincustomization propertiesFile |
Posizione di un file delle proprietà contenente impostazioni predefinite per le preferenze di plug-in. 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 |
-vm vmPath |
Posizione del JRE (Java Runtime Environment) da utilizzare per eseguire la piattaforma Eclipse. Se non specificata, 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 |
-application applicationId |
Applicazione da eseguire. Le applicazioni vengono dichiarate dai plug-in 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 |
-boot bootJarURL |
(Danneggiato; sostituito da -configuration; supportato per la compatibilità 1.0). Posizione del codice plug-in di avvio della piattaforma Eclipse (cioè, boot.jar), espresso come URL. Se specificata, viene utilizzata per impostare il percorso classi del caricatore di classe che carica il caricatore delle classi bootstrap della piattaforma Eclipse. Risulta necessaria solo quando viene modificata la posizione relativa di startup.jar e boot.jar. Non sono consentiti gli URL relativi. | *1.0 |
-consolelog |
Riflette il log degli errori della piattaforma Eclipse sulla console utilizzata per eseguire Eclipse. Utile se combinato con -debug . |
1.0 |
-debug [optionsFileURL] |
Mette la piattaforma in modalità debug e carica le opzioni di debug dal file all'URL, se specificato. Questo file indica i punti di debug disponibili per un plug-in e se sono attivati o meno. Se non è determinato un percorso di file, la piattaforma cerca un file denominato ".options" nella directory in cui è stato avviato eclipse. Non sono consentiti gli URL relativi. | 1.0 |
-keyring keyringFilePath |
Posizione sul disco del database delle autorizzazioni (o file "key
ring"). 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 |
-password password |
Password per il database delle autorizzazioni. Utilizzata insieme all'opzione -keyring . |
1.0 |
-plugins pluginsFileURL |
(Danneggiato; sostituito da -configuration; supportato per la compatibilità 1.0). Posizione del file che specifica il luogo in cui la piattaforma Eclipse trova i plug-in, espressi come URL. Il file è nel formato del file di proprietà, nel quale le chiavi rappresentano nomi arbitrari definiti dall'utente e i valori rappresentano elenchi separati da una virgola di percorsi espliciti di file plugin.xml o di percorsi di directory contenenti plug-in. Non sono consentiti gli URL relativi. Se specificata, questa opzione provoca la creazione di una configurazione temporanea adatta. | *1.0 |
-showsplash params |
Opzione interna per visualizzare la schermata iniziale (effettuata dall'utilità di avvio eseguibile della piattaforma Eclipse). Questa opzione è dotata di sintassi e semantica differenti nei vari punti della catena di elaborazione della schermata iniziale. | 2.0 |
-endsplash params |
Opzione interna per chiudere la schermata iniziale quando la piattaforma Eclipse è attiva e in esecuzione. Questa opzione è dotata di sintassi e semantica differenti nei vari punti della catena di elaborazione della schermata iniziale. | 2.0 |
-nosplash |
Esegue la piattaforma senza visualizzare la schermata iniziale. | 1.0 |
-noregistrycache |
Ignora la lettura e la scrittura del file di cache del registro di un plug-in interno. | 2.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 plug-in come BootLoader.getOS()e viene utilizzato per risolvere le occorrenze della variabile $os$ nei percorsi indicati nel file manifest del plug-in. Valori di esempio: "win32", "linux",
"hpux", "solaris", "aix". |
1.0 |
-ws windowSystem |
Definisce il sistema Windows nel quale 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 plug-in come BootLoader.getWS(), utilizzato per configurare SWT, e viene utilizzato per risolvere le occorrenze della variabile $ws$ nei percorsi indicati nel file manifest del plug-in. Valori di esempio: "win32", "motif", "gtk". |
1.0 |
-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 plug-in come BootLoader.getOSArch().
Valori di esempio: "x86", "sparc", "PA-RISC", "ppc". |
2.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 plug-in come BootLoader.getNL(). Valori di esempio: "en_US" and "fr_FR_EURO". | 2.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).
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 devono 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