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.
Sans indication de votre part, Eclipse vous invitera à définir un répertoire d'espace de travail. L'emplacement par défaut de ce répertoire sera un enfant de votre répertoire principal appelé "workspace" (par exemple, c:\Documents and Settings\My Name\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. Outre la saisie simple d'un emplacement différent au moment de l'invite, vous pouvez également utiliser l'argument de ligne de commande -data.
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. 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]]
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 |
-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 |
-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 |
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 |
-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".
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