Une fois Eclipse installé (décompressé) dans un répertoire (par ex., c:\eclipse), le plan de travail démarre en lançant l'exécutable Eclipse du répertoire d'installation de niveau supérieur. Cet exécutable est le fichier eclipse.exe sur les systèmes Windows et simplement eclipse sur les systèmes Linux. Les paragraphes qui suivent décrivent en détail l'installation sous Windows. L'installation sous Linux est analogue.
Sauf spécification contraire, la plateforme crée un répertoire de travail (workspace) par défaut apparenté à l'exécutable (par ex., c:\eclipse\workspace). Ce répertoire est utilisé comme zone de contenu par défaut des projets et des métadonnées requises. Dans les installations partagées ou dotés de plusieurs espaces de travail, vous devez préciser l'emplacement de votre espace de travail au lieu d'utiliser l'espace par défaut. Vous pouvez contrôler l'emplacement de votre espace de travail de deux manières : en utilisant le répertoire de travail en cours ou l'argument de ligne de commande -data.
La méthode la plus simple pour utiliser le répertoire de travail en cours consiste à créer un raccourci de la manière suivante :
Bien sûr, vous obtenez le même résultat en remplaçant à l'invite le répertoire indiqué par celui de votre espace de travail, puis en exécutant eclipse.exe.
Pour utiliser l'argument de ligne de commande -data, ajoutez simplement -data <emplacement de votre espace de travail> (par ex., -data c:\monespacetravail) à la ligne "Cible :" du raccourci ou entrez explicitement ces informations sur la ligne de commande de votre invite.
Eclipse et la plateforme proposent un grand nombre d'options d'exécution destinées aux personnes chargées de développer ou de déboguer des composants d'Eclipse. En général, Eclipse s'exécute comme suit :
eclipse [options de plateforme] [-vmargs [arguments VM Java]]
où les options de plateforme admises sont :
-application <id app> | Identifie l'application à exécuter. En l'absence de spécification, le plan de travail Eclipse s'exécute. Les applications sont déclarées par des plug-ins fournissant des extensions au point d'extension org.eclipse.core.runtime.applications. |
-boot <chemin code d'amorçage> | Définit le chemin d'accès au code de plug-in d'amorçage (par ex., boot.jar). Nécessaire uniquement si vous modifiez l'emplacement relatif de startup.jar et boot.jar. |
-consolelog | Crée un disque miroir du journal des erreurs de la plateforme sur la console utilisée pour l'exécution d'Eclipse. |
-data <chemin espace de travail> | Définit le chemin d'accès à l'espace de travail sur lequel exécuter la plateforme. |
-debug [chemin fichier d'options] | Fait passer la plateforme en mode débogage et charge les options de débogage du fichier spécifié. En l'absence de chemin de fichier, la plateforme recherche dans son répertoire d'installation et dans le répertoire des métadonnées de l'espace de travail un fichier ".options". |
-dev [entrées chemin d'accès aux classes] | Fait passer la plateforme en mode développement. Les entrées optionnelles de chemin d'accès aux classes (liste d'éléments séparés par des virgules) sont ajoutées à chaque chemin d'accès aux classes de plug-in. Par exemple, lors du développement de plug-ins, utilisez "-dev bin" pour ajouter le répertoire bin des outils Java à chaque plug-in. Les entrées de chemin d'accès aux classes redondantes ou inexistantes sont éliminées. |
-nosplash | Exécute la plateforme sans afficher l'écran d'accueil. |
-os <id-se> | Définit le système d'exploitation sous lequel s'exécute la plateforme. En général, la plateforme le détecte, mais certaines situations nécessitent qu'il soit explicitement spécifié. La valeur entrée ici est associée à Platform.getOS(). |
-vm <chemin vm> | Indique la machine virtuelle (VM) Java à utiliser pour exécuter la plateforme. En l'absence de spécification, il s'agit d'une VM Java localisée en fonction de l'exécutable Eclipse. |
-ws <id-sf> | Définit le système de fenêtrage sous lequel s'exécute la plateforme. Dans la plupart des cas, la plateforme peut le détecter, mais certaines situations nécessitent qu'il soit explicitement désigné. La valeur entrée ici est associée à Platform.getWS(). |
Tous les arguments qui suivent (mais hormis) l'entrée -vmargs sont directement transmis à la VM Java désignée en tant qu'arguments de machine virtuelle (c-à-d., avant la classe à exécuter). Tous les arguments qui précédent l'entrée -vmargs (exceptés -vm et -nosplash) sont directement transmis à la plateforme pour interprétation.
eclipse.exe [arguments eclipse] -vm <chemin d'accès à j9w.exe> -vmargs -ms:20 -jit -mo:32000 -mx:200000
REMARQUE : l'indicateur -vmargs et les arguments vm doivent figurer en fin de ligne.
Les paramètres vm par défaut IBM JDK 1.3 Linux sont parfaits pour une exploration initiale, mais insuffisants pour un développement à plus grande échelle. Pour un développement de grande envergure, vous devez modifier comme suit vos arguments vm afin de disposer de plus de mémoire dynamique :
-vmargs -Xmx256M
porte la mémoire dynamique Java à 256 Mo.