Exécution d'Eclipse

Une fois que vous avez installé le kit SDK Eclipse dans un répertoire, vous pouvez démarrer le plan de travail à l'aide du fichier exécutable Eclipse inclus dans la version (vous avez également besoin d'un JRE 1.4.2, qui n'est pas fourni avec le SDK Eclipse). Sous Windows, le fichier exécutable s'appelle eclipse.exe et réside dans le sous-répertoire d'installation eclipse. S'il est installé dans le répertoire c:\eclipse-SDK-3.2-win32, le fichier exécutable est c:\eclipse-SDK-3.2-win32\eclipse\eclipse.exe. Remarque : L'installation est identique sur la plupart des systèmes d'exploitation. Des instructions spécifiques à Mac OS X figurent ci-dessous.

Allocation suffisante de mémoire et résolution des erreurs de mémoire insuffisante

Par défaut, Eclipse alloue jusqu'à 256 mégaoctets de segment de mémoire Java. Cela est suffisant pour toutes les tâches de développement ordinaires. Cependant, selon l'environnement d'exécution Java dont vous disposez, le nombre de plug-ins supplémentaires utilisés et le nombre de fichiers que vous traitez, vous pouvez tout à fait augmenter cette taille. Eclipse permet de transmettre des arguments directement à la machine virtuelle Java à l'aide de l'argument de ligne de commande -vmargs, qui doit respecter tous les autres arguments spécifiques d'Eclipse. Ainsi, pour augmenter la taille du segment de mémoire, vous devez utiliser la syntaxe suivante :

eclipse -vmargs -Xmx<memory size>

avec la valeur <memory size> définie sur un nombre supérieur à "256M" (256 mégaoctets, la valeur par défaut).

Si vous utilisez une VM Sun, vous pouvez également être amené à augmenter la taille de la mémoire de génération permanente. La valeur par défaut maximale est 64 mégaoctets, mais une taille plus importante peut s'avérer nécessaire, selon la configuration de votre plug-in et son utilisation. La taille de génération permanente peut être augmentée à l'aide de l'argument -XX:MaxPermSize=<memory size> :

eclipse -vmargs -XX:MaxPermSize=<memory size>

Cet argument peut ne pas être disponible pour toutes les versions VM et les plateformes. Pour plus d'informations, consultez la documentation de votre machine virtuelle.

Sachez que la définition de tailles de mémoire sur des valeurs plus importantes que la capacité de mémoire physique disponible peut entraîner un "ralentissement" de Java. En effet, en effectuant de nombreuses copies depuis et vers la mémoire virtuelle, ce paramètre dégrade ainsi considérablement les performances de votre système.

Sélection d'un espace de travail

Lorsque le plan de travail est lancé, le premier élément qui s'affiche est une boîte de dialogue qui permet de sélectionner l'emplacement de l'espace de travail. Celui-ci correspond au répertoire dans lequel votre travail va être stocké. Sans indication de votre part, Eclipse créera l'espace de travail dans votre répertoire. Ce répertoire workspace est utilisé comme zone de contenu par défaut pour vos projets et pour toutes les métadonnées requises. Dans le cas d'installations partagées ou contenant plusieurs espaces de travail, vous devez indiquer de manière explicite l'emplacement de votre espace de travail à l'aide de la boîte de dialogue (ou via l'argument de ligne de commande "-data").

Voici une ligne de commande Eclipse : 

eclipse -vm c:\jdk1.4.2\jre\bin\javaw

Astuce : Il est recommandé d'indiquer quelle machine virtuelle Java utiliser avec Eclipse. Pour cela, on utilise l'argument de ligne de commande "-vm", comme dans l'exemple précédent. . Si vous n'utilisez pas "-vm", Eclipse recherchera dans le répertoire du système d'exploitation. Les installations d'autres produits Java peuvent modifier le chemin de répertoire du système d'exploitation. Ceci explique pourquoi Eclipse peut utiliser une JVM différente après une telle installation.

Pour créer un raccourci Windows pour un système Eclipse :

  1. 1. Accédez au fichier eclipse.exe dans l'explorateur Windows et sélectionnez Créer un raccourci dans le menu contextuel.
  2. 2. Sélectionnez le raccourci et modifiez ses propriétés. Dans la zone Cible :, ajoutez les arguments de ligne de commande.

Cliquez sur ce raccourci pour lancer Eclipse. (Vous pouvez faire glisser le raccourci sur le bureau Windows pour qu'il soit plus accessible.)

Mac OS X

Sous Mac OS X, vous démarrez Eclipse en cliquant deux fois sur l'application Eclipse. Si vous devez transmettre des arguments à Eclipse, vous devrez modifier le fichier eclipse.ini situé dans le bundle d'application Eclipse. Sélectionnez l'icône correspondant au bundle tout en maintenant la touche Ctrl enfoncée. Cette commande affiche un menu en incrustation. Sélectionnez "Show Package Contents" (Afficher le contenu) dans le menu. Recherchez le fichier eclipse.ini dans le sous-dossier Contents/MacOS, puis ouvrez-le à l'aide de l'éditeur de texte de votre choix afin de modifier les options de ligne de commande.

Si vous devez lancer Eclipse à partir de la ligne de commande, vous pouvez utiliser le lien "eclipse" situé dans le dossier Eclipse de niveau supérieur. Il désigne l'exécutable eclipse situé dans le bundle de l'application et utilise les mêmes arguments que "eclipse.exe" sur d'autres plateformes.

Sous Mac OS X 10.4 et les versions suivantes, vous pouvez observer un ralentissement lorsque vous utilisez un nombre de ressources important si vous autorisez Spotlight à indexer votre espace de travail. Pour éviter cette situation, démarrez les Préférences système, sélectionnez l'icône Spotlight, puis l'onglet Confidentialité. Cliquez ensuite sur le bouton Ajouter ("+") et recherchez le répertoire de votre espace de travail dans la boîte de dialogue qui apparaît.

Installation partagée

La vitesse de démarrage d'une installation partagée peut être améliorée si les informations de mémoire cache résident dans la zone d'installation partagée. Pour ce faire, une fois la distribution Eclipse décompressée, exécutez Eclipse avec l'option "-initialize" à partir d'un compte possédant un accès en écriture au répertoire d'installation.

Informations avancées concernant l'exécution d'Eclipse

L'exécutable Eclipse et la plateforme offrent un certain nombre d'options d'exécution présentant un intérêt pour les personnes développant ou déboguant des parties d'Eclipse. Il s'agit de la liste des options couramment utilisées ; pour obtenir une liste complète, reportez-vous à la page des options d'exécution Eclipse dans le document Platform Plug-in Developer Guide. Le format général de l'exécution de l'exécutable Eclipse est le suivant :

eclipse [options de plateforme] [-vmargs [arguments VM Java]]
Paramètres de démarrage d'Eclipse
Commande Description Depuis
-arch architecture
Définit l'architecture de processeur sur laquelle la plateforme Eclipse est exécutée. La plateforme Eclipse calcule généralement le paramètre optimal à l'aide de la valeur en cours de la propriété Java os.arch. Si cette valeur est indiquée ici, elle correspond à la valeur utilisée par la plateforme Eclipse. La valeur indiquée ici est accessible aux plug-in sous forme de BootLoader.getOSArch(). Exemples de valeurs : "x86", "sparc", "PA-RISC", "ppc". 2.0
-application IDapplication
Application à exécuter. Les applications sont déclarées par des plug-in qui fournissent les extensions au point d'extension org.eclipse.core.runtime.applications. Cet argument n'est généralement pas requis. Si la valeur est spécifiée, celle-ci remplace la valeur fournie par la configuration. Si elle n'est pas spécifiée, le plan de travail Eclipse est exécuté. 1.0
-clean
Nettoie les données mises en cache utilisées par la structure OSGi et l'environnement d'exécution Eclipse. Tentez d'exécuter Eclipse avec cette option si vous observez des erreurs de démarrage après l'installation, la mise à jour ou l'utilisation d'une configuration partagée. 3.0
-configuration URLFichierconfiguration
Emplacement du fichier de configuration de plateforme Eclipse, exprimé sous la forme d'une URL. Le fichier de configuration détermine l'emplacement de la plateforme Eclipse, l'ensemble de plug-in disponibles et le dispositif principal. Il est à noter que les URL relatives ne sont pas autorisées. Le fichier de configuration est enregistré dans cet emplacement lorsque la plateforme Eclipse est installée ou mise à jour. 2.0
-consolelog
Crée un disque miroir du journal des erreurs de la plateforme Eclipse sur la console utilisée pour l'exécution d'Eclipse. Pratique lorsqu'il est associé à -debug. 1.0
-data Cheminespacetravail
Chemin d'accès à l'espace de travail sur lequel la plateforme Eclipse doit s'exécuter. L'emplacement de l'espace de travail correspond également à l'emplacement par défaut des projets. Les chemins d'accès relatifs sont interprétés par rapport au répertoire à partir duquel Eclipse a été démarré. 1.0
-debug [fichierOptions]
Ce paramètre, lorsqu'il est spécifié, place la plateforme en mode débogage et charge les options de débogage à partir du fichier à l'URL indiquée. Ce fichier détermine les points de débogage qui sont disponibles pour un plug-in et indique s'ils sont activés ou non. Si aucun chemin de fichier n'est indiqué, la plateforme recherche, dans le répertoire à partir duquel Eclipse a été démarré, un fichier intitulé ".options". Les URL et les chemins de système de fichiers sont autorisés comme emplacements du fichier. 1.0
-dev [Entréescheminclasse]
Place la plateforme en mode développement. Les entrées de chemin de classe facultatives (liste séparée par des virgules) sont ajoutées dans le chemin de classe d'exécution de chaque plug-in. Par exemple, quand l'espace de travail contient des plug-in en cours de développement, la spécification -dev bin ajoute une entrée de chemin de classe pour le répertoire de chaque projet de plug-in intitulé bin, ce qui permet d'y trouver des fichiers de classe venant d'être générés. Les entrées de chemin de classe en double ou inexistantes sont supprimées. 1.0
-initialize
Initialise la configuration exécutée. Toutes les structures de données liées à l'environnement d'exécution et toutes les caches sont actualisées. Pratique, avec les installations partagées, l'exécution d'Eclipse avec cette option à partir d'un compte possédant des privilèges d'écriture améliore les performances de démarrage. 3.0
-keyring CheminFichierclés
Emplacement de la base de données des droits d'accès (ou fichier de "clés") sur le disque. Cet argument doit être utilisé en association avec l'option -password. Les chemins d'accès relatifs sont interprétés par rapport au répertoire à partir duquel Eclipse a été démarré. 1.0
-nl environnementlocal
Définit le nom de l'environnement local sur lequel la plateforme Eclipse est exécutée. En général, la plateforme Eclipse calcule automatiquement le paramètre optimal. Si cette valeur est indiquée ici, elle correspond à la valeur utilisée par la plateforme Eclipse. La valeur indiquée ici est accessible aux plug-in sous forme de BootLoader.getNL(). Exemples de valeurs : "en_US" et "fr_FR_EURO". 2.0
-nosplash
Exécute la plateforme sans lancer l'écran d'accueil. 1.0
-os systèmeexploitation
Définit le système d'exploitation sur lequel la plateforme Eclipse est exécutée. La plateforme Eclipse calcule généralement le paramètre optimal à l'aide de la valeur en cours de la propriété Java os.name. Si cette valeur est indiquée ici, elle correspond à la valeur utilisée par la plateforme Eclipse. La valeur indiquée ici est accessible aux plug-in sous forme de BootLoader.getOS() et utilisée pour la conversion des occurrences de la variable $os$ en chemins mentionnés dans le fichier manifeste des plug-in. Exemples de valeurs : "win32", "linux", "hpux", "solaris", "aix". 1.0
-password motdepasse
Mot de passe de la base de données des droits d'accès. Utilisé en association avec l'option -keyring. 1.0
-perspective idPerspective
Perspective à ouvrir dans la fenêtre active du plan de travail lors du démarrage. En l'absence de ce paramètre, la perspective qui était active lors de l'arrêt sera ouverte. 1.0
-plugincustomization
	  Fichierpropriétés
Emplacement d'un fichier de propriétés contenant les paramètres par défaut des préférences de plug-in. Ces paramètres par défaut remplacent ceux indiqués dans le dispositif principal. Les chemins d'accès relatifs sont interprétés par rapport au répertoire à partir duquel Eclipse a été démarré. 2.0
-product ID_produit
ID du produit à exécuter. Le produit donne à l'instance lancée d'Eclipse sa personnalité et détermine les informations de personnalisation de produit utilisées. Cela remplace -feature, qui est toujours pris en charge à des fins de compatibilité. 3.0
-refresh 
Option de régénération totale de l'espace de travail lors du démarrage. Ceci permet de valider les modifications apportées dans le système de fichiers depuis la dernière exécution de la plateforme. 1.0
-showlocation [workspaceName]
Option d'affichage de l'emplacement de l'espace de travail dans la barre de titre de la fenêtre. Dans la version 2.0, cette option ne fonctionnait qu'avec l'argument de ligne de commande -data. Dans la version 3.2, un argument de nom d'espace de travail facultatif permettant d'afficher le nom indiqué dans la barre de titre de la fenêtre au lieu de l'emplacement de l'espace de travail a été ajouté. 2.0
-vm Cheminvm
Emplacement du module JRE (Java Runtime Environment) à utiliser pour l'exécution de la plateforme Eclipse. S'il n'est pas spécifié, le module JRE se trouve dans jre, élément apparenté de l'exécutable d'Eclipse. Les chemins d'accès relatifs sont interprétés par rapport au répertoire à partir duquel Eclipse a été démarré. 1.0
-vmargs args
Lorsque cette option est transmise à Eclipse, elle sert à personnaliser l'opération de la machine virtuelle Java qui est utilisée pour l'exécution d'Eclipse. Si cette option est spécifiée, elle doit être placée à la fin de la ligne de commande. Les arguments donnés sont fonction de la machine virtuelle qui est en cours d'exécution. 1.0

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). Remarque : Si un argument de démarrage Eclipse, tel que -data, est fourni après les arguments vm Java (-vmargs), Eclipse ne peut pas démarrer, ce qui génère le message d'erreur "JVM terminated. Exit code=1".