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.
Dans ce scénario, l'emplacement de l'espace de travail est un sous-répertoire workspace du répertoire de travail en cours.
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
, il suffit d'ajouter -data emplacement_votre_espace_travail
(par exemple, -data c:\users\robert\monespacetravail
) dans la zone Cible des propriétés de raccourci ou d'entrer explicitement ces informations sur la ligne de commande.
Il est recommandé d'indiquer quelle machine virtuelle Java utiliser avec Eclipse. Pour cela, on utilise l'argument de ligne de commande -vm
(-vm c:\jre\bin\javaw.exe
, par exemple). Si vous n'utilisez pas -vm
, Eclipse adoptera la première machine virtuelle Java trouvée dans le répertoire du système d'exploitation. Les installations d'autres produits 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.
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]]
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 |
-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 |
-classloaderproperties [fichier] |
Active les enrichissements du chargeur de classes de la plateforme à l'aide du fichier de propriétés du chargeur de classes à un emplacement précis. L'argument du fichier peut être un répertoire ou une URL. Il est à noter que les URL relatives ne sont pas autorisées. Cliquez ici pour plus de détails. | 2.0.2 |
-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 |
-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 |
-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 |
-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 |
-nolazyregistrycacheloading |
Désactive l'optimisation de charge du cache du registre de plug-in de plateforme. Par défaut, les éléments de configuration des extensions seront chargés à la demande à partir du cache du registre (quand il est disponible), réduisant ainsi l'utilisation de la mémoire. Cette option force le chargement complet du cache du registre au démarrage. | 2.1 |
-noregistrycache |
Ignore la lecture et l'écriture d'un fichier cache de registre de plug-in interne. | 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 |
-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-in. 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 de 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-in. 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 |
-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 |
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, cet option ne fonctionnait qu'avec l'argument de ligne de commande -data. | 2.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 |
-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 |
-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-in 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-in. Exemples de valeurs :
"win32", "motif", "gtk". |
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 terminate. Exit code=1" error.
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.
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