Exécution d'Eclipse

Une fois l'installation (décompression) du pilote Eclipse dans un répertoire (par exemple, c:\eclipse), démarrez le plan de travail en exécutant le fichier exécutable Eclipse qui se trouve dans le répertoire d'installation de niveau supérieur. Le fichier exécutable est intitulé eclipse.exe sous Windows et eclipse sur les systèmes Linux. Remarque : La section ci-dessous décrit la configuration sur les systèmes Windows. La configuration sous Linux est similaire.

Sauf indication contraire de votre part, la plateforme crée un répertoire workspace (espace de travail) par défaut comme élément apparenté à l'exécutable (par exemple, c:\eclipse\workspace). Ce répertoire workspace est utilisé comme zone de contenu par défaut pour vos projets et pour toutes les métadonnées requises. Pour les installations d'espaces de travail partagés ou multiples, vous devez explicitement indiquer l'emplacement de votre espace de travail plutôt que d'utiliser la valeur par défaut. Il existe deux façons pour contrôler l'emplacement de votre espace de travail : utilisation du répertoire de travail en cours ou utilisation de 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 :

  1. Localisez eclipse.exe dans l'Explorateur Windows et, en cliquant sur le bouton droit de la souris, créez un raccourci pour cet exécutable.
  2. Modifiez les propriétés du raccourci de sorte que la zone Démarrer en : indique l'emplacement de votre espace de travail (par ex., c:\monespacetravail).
  3. Fermez la boîte de dialogue des propriétés et cliquez deux fois sur le raccourci.

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, il suffit d'ajouter -data emplacement_votre_espace_travail (par exemple, -data c:\monespacetravail) dans la zone Cible des propriétés de raccourci ou d'entrer explicitement ces informations sur la ligne de commande.

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. 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  
-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-ins 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
-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
-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, lorsque l'espace de travail contient des plug-ins en cours de développement, la spécification de -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 qui viennent d'être générés. Les entrées de chemin de classe en double ou inexistantes sont supprimées. 1.0
-feature IDdispositif
ID du dispositif principal. Le dispositif principal donne à l'instance lancée d'Eclipse sa personnalité de produit et détermine les informations de personnalisation de produit utilisées. 2.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
-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
-application IDapplication
Application à exécuter. Les applications sont déclarées par des plug-ins 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
-boot URLJaramorçage
(Déconseillé ; remplacé par -configuration ; pris en charge pour la compatibilité 1.0). Emplacement du code de plug-in d'amorçage de la plateforme Eclipse (c'est-à-dire, boot.jar), exprimé sous la forme d'une URL. S'il est indiqué, il sert à définir le chemin de classe du chargeur de classe qui charge le chargeur de classe d'amorçage de la plateforme Eclipse. Nécessaire uniquement lors de la modification de l'emplacement relatif de startup.jar et boot.jar. Il est à noter que les URL relatives ne sont pas autorisées. *1.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
-debug [URLFichieroptions]
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". Il est à noter que les URL relatives ne sont pas autorisées. 1.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
-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
-plugins URLFichierplugins
(Déconseillé ; remplacé par -configuration ; pris en charge pour la compatibilité 1.0). Emplacement (exprimé sous la forme d'une URL) du fichier qui indique le répertoire dans lequel la plateforme Eclipse trouve des plug-ins. Le fichier est au format de fichier de propriétés où les clés sont des noms arbitraires définis par l'utilisateur et les valeurs des chemins d'accès explicites (séparés par des virgules)aux fichiers plugin.xml ou des chemins d'accès aux répertoires contenant des plug-ins. Il est à noter que les URL relatives ne sont pas autorisées. Cette option, si elle est spécifiée, permet la création d'une configuration provisoire appropriée. *1.0
-showsplash params
Option interne permettant l'affichage de l'écran d'accueil (via le programme de lancement de plateforme Eclipse exécutable). La syntaxe et la sémantique de cette option sont différents dans divers endroits de la chaîne de traitement de l'écran d'accueil. 2.0
-endsplash params
Option interne supprimant l'écran d'accueil lorsque la plateforme Eclipse est en cours d'exécution. La syntaxe et la sémantique de cette option sont différents dans divers endroits de la chaîne de traitement de l'écran d'accueil. 2.0
-nosplash
Exécute la plateforme sans lancer l'écran d'accueil. 1.0
-noregistrycache
Ignore la lecture et l'écriture d'un fichier cache de registre de plug-in interne. 2.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-ins 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-ins. Exemples de valeurs : "win32", "linux", "hpux", "solaris", "aix". 1.0
-ws systèmefenêtrage
Définit le système de fenêtrage 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-ins sous forme de BootLoader.getWS(), utilisée pour la configuration de SWT et pour la conversion des occurrences de la variable $ws$ en chemins mentionnés dans le fichier manifeste des plug-ins. Exemples de valeurs : "win32", "motif", "gtk". 1.0
-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-ins sous forme de BootLoader.getOSArch(). Exemples de valeurs : "x86", "sparc", "PA-RISC", "ppc". 2.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-ins sous forme de BootLoader.getNL(). Exemples de valeurs : "en_US" et "fr_FR_EURO". 2.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).

Exécution sur différentes VM 

Exécution d'Eclipse sur J9

Lorsque vous exécutez Eclipse sur J9 version 1.5, il est préférable d'utiliser les options VM suivantes :

eclipse.exe [arguments eclipse] -vm chemin_accès_j9w.exe
            -vmargs -ms:32 -mm:2048 -mo:32768 -moi:32768 -mca:32 -mco:128 -mx:2000000

Lors de l'exécution d'Eclipse sur J9 version 2.0, les arguments par défaut choisis par J9W doivent être appropriés. Cependant, pour remplacer les paramètres qui sont automatiquement définis en interne par l'exécutable Eclipse, vous devez indiquer -vmargs non suivi d'arguments :

eclipse.exe [arguments eclipse] -vm chemin_accès_j9w.exe -vmargs

Pour obtenir de l'aide et plus d'informations, reportez-vous à la documentation VM J9.

Exécution d'Eclipse dans IBM Developer Kit, Java Technology Edition VM

Les paramètres VM par défaut pour IBM Developer Kit, Java Technology Edition 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. Par exemple, le paramétrage suivant porte la mémoire dynamique Java à 256 Mo :

-vmargs -Xmx256M 

 
Copyright IBM Corporation and others 2000, 2002