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 diversamente specificato, la piattaforma crea una directory predefinita per lo spazio di lavoro di pari livello dell'eseguibile (ad esempio, c:\eclipse\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. Esistono due modi per controllare il percorso dello spazio di lavoro: utilizzare la directory di lavoro corrente o l'argomento della riga comandi -data.
In questo scenario, il percorso dello spazio di lavoro sarà rappresentato dalla directory workspace interna alla directory di lavoro corrente.
Il modo più facile per ottenere tale percorso, consiste nel creare un collegamento attenendosi alle seguenti istruzioni:
È possibile ottenere lo stesso risultato utilizzando un prompt di comandi, passando alla directory nella directory principale dello spazio di lavoro ed eseguendo il file eclipse.exe.
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. 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 plug-in come BootLoader.getOSArch().
Valori di esempio: "x86", "sparc", "PA-RISC", "ppc". |
2.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 |
(Obsoleto; sostituito da -configuration; supportato per la compatibilità 1.0). Percorso del codice plug-in di avvio della piattaforma Eclipse (boot.jar), espresso come URL. Se specificato, viene utilizzato per impostare il percorso classi del caricatore di classe che carica il caricatore delle classi bootstrap della piattaforma Eclipse. Risulta necessario solo quando viene modificato il percorso relativo di startup.jar e boot.jar. Non sono consentiti gli URL relativi. | *1.0 |
-classloaderproperties [file] |
Attiva il potenziamento del programma di caricamento della classe della piattaforma utilizzando il relativo file delle proprietà nell'ubicazione indicata, se specificato. L'argomento può essere un percorso o un URL. Non sono consentiti gli URL relativi. Per ulteriori dettagli, fare clic qui. | 2.0.2 |
-configuration configurationFileURL |
Percorso del il file di configurazione della piattaforma Eclipse, espresso come URL. Il file di configurazione determina il percorso 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 questo percorso quando la piattaforma Eclipse viene installata o aggiornata. | 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 |
Percorso dello spazio di lavoro nel quale 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 plug-in 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
plug-in. Ad esempio, quando lo spazio di lavoro contiene i plug-in in fase di sviluppo,
specificando -dev bin verrà aggiunta una voce del percorso classi per ogni plug-in 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 |
-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 |
-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 |
-keyring keyringFilePath |
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 plug-in come BootLoader.getNL(). Valori di esempio: "en_US" e "it_IT_EURO". | 2.0 |
-nolazyregistrycacheloading |
Disattiva la funzione di ottimizzazione per il caricamento della cache del registro di plug-in della piattaforma. Per impostazione predefinita, gli elementi di configurazione delle estensioni verranno caricati dalla cache del registro (se disponibile) solo su richiesta, riducendo il carico di memoria. Questa opzione fa sì che la cache del registro venga caricata completamente all'avvio. | 2.1 |
-noregistrycache |
Ignora la lettura e la scrittura del file di cache del registro di un plug-in interno. | 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 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 |
-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 |
Percorso 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 |
-plugins pluginsFileURL |
(Obsoleto; sostituito da -configuration; supportato per la compatibilità 1.0). Percorso del file che specifica il luogo in cui la piattaforma Eclipse trova i plug-in, espressi come URL. Il formato del file è di tipo proprietà, in cui le chiavi rappresentano nomi arbitrari definiti dall'utente e i valori rappresentano elenchi separati da virgole contenenti i percorsi espliciti dei file plugin.xml o 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 |
-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 |
-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 |
-vm vmPath |
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 |
-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 |
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 devono essere appropriati. 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