Jacques BAPST

Technologies de l'information
et de la communication (TIC)

16 aot 2012

4.2

INSTALLATION ET CONFIGURATION

INSTALLATION
Pour utiliser Eclipse, une machine virtuelle Java doit tre disponible sur la machine cible. Il faut donc
pralablement installer un environnement d'excution ( JRE) ou un kit de dveloppement Java (SDK)
tlcharger sur le site de Oracle : www.oracle.com/technetwork/java/javase/downloads (slectionner JDK 7 Update 5
[ou suprieur]).
Le logiciel Eclipse (Latest Release 4.2.0, Juno, ~ 150MB) peut tre tlcharg sur le site download.eclipse.org
(choisir Eclipse IDE for Java Developers) version 32 bit ou 64 bit selon votre systme d'exploitation.
Il suffit ensuite de dcomprimer le fichier zip dans un rpertoire (une branche \eclipse\ sera cre
avec l'ensemble des fichiers ncessaires). Attention conserver l'arborescence lors de l'extraction.
Aucune installation supplmentaire du logiciel Eclipse n'est ncessaire (pour la dsinstallation, on peut
donc se contenter de supprimer tous les fichiers du rpertoire d'installation).

PREMIER LANCEMENT
L'application Eclipse est lance en excutant le fichier eclipse.exe qui se trouve dans le rpertoire
racine \eclipse\ l'emplacement o vous avez dcomprim (extrait) les fichiers.
Au premier lancement, Eclipse demande d'indiquer o doit tre cr le Workspace . Le Workspace est
l'emplacement o seront enregistrs les informations de configuration, les projets et les ressources
associes (packages, fichiers sources,
fichiers binaires, documentation, etc.).
Sur Windows, Eclipse propose, par
dfaut, de crer cet environnement
dans le rpertoire
C:\Users\UserName\workspace\ ce
qui n'est pas forcment l'emplacement
idal (il est souvent prfrable de
regrouper les projets Java dans un
rpertoire d'un disque de donnes).
Slectionner un rpertoire vide en
utilisant le bouton Browse et
complter ventuellement le chemin d'accs (le rpertoire sera automatiquement cr si ncessaire)
Pour simplifier le lancement d'Eclipse, il est conseill de crer (par exemple sur le bureau) un raccourci
qui pointe vers le fichier \eclipse\eclipse.exe et/ou de l'ancrer dans la barre de tches.
Attention bien crer un raccourci et ne pas dplacer ou copier le fichier excutable sur le bureau !
Remarques : Les projets qui seront crs ne devront pas obligatoirement tre placs dans le rpertoire dfini
comme Workspace courant, mais c'est cet emplacement qui sera propos par dfaut lors de la
cration de nouveaux projets.
Il est possible de travailler avec plusieurs Workspaces diffrents que l'on peut choisir au lancement
d'Eclipse ou aprs coup, en passant par le menu File Switch Workspace

D:\Data\EIA\Cours\PR1\Eclipse4.2_Install_Config.docx

EIA-FR / Jacques BAPST

Si plusieurs machines virtuelles ont t installes, on peut (et parfois on doit) prciser, en utilisant le
qualificateur -vm dans le raccourci de lancement, l'emplacement de la machine virtuelle qu'Eclipse doit
utiliser (car Eclipse est une application Java).
Exemple :

. . . -vm "C:\Program Files\Java\jdk1.7.0_05\bin\javaw"

Aprs avoir, si ncessaire, cr le Workspace, Eclipse affiche un cran de bienvenue qui permet de
dcouvrir diffrents aspects de l'environnement de dveloppement (vue d'ensemble des diffrents
composants, didacticiels, exemples, nouveauts, etc.).
Le lancement de l'environnement de dveloppement proprement dit s'effectue en cliquant sur l'icne
reprsentant une flche droite de l'cran (Workbench) ou en fermant l'onglet Welcome.

CONFIGURATION
Aprs avoir lanc Eclipse, il est possible de configurer l'environnement de dveloppement en utilisant les
options du menu Windows Preferences.
Les options configurables sont trs nombreuses et il est toujours possible, par domaine, de revenir la
configuration par dfaut grce au bouton Restore Defaults .

Sauvegarde et restauration de jeux de configuration

Il est possible de sauvegarder et restaurer (exporter et importer) des jeux de configurations en passant
par le menu File Export General Preferences ( Export all), respectivement File Import
General Preferences ( Import all), en indiquant l'emplacement et le nom du fichier de configuration.
Ces fonctions sont trs utiles pour copier la configuration entre deux machines diffrentes ou entre deux
Workspaces diffrents.

Configuration standard EIA-FR

Une configuration standard est propose aux tudiants de l'cole. Elle a t enregistre dans le fichier
Etu_Std.epf qui est disponible l'adresse :
jacques.bapst.home.hefr.ch/resources/eclipse
Il suffit de tlcharger le fichier Etu_Std.epf et de le copier sur votre disque local puis, ensuite, depuis
Eclipse de l'importer par le menu File Import General Preferences ( Import all).
Attention : il est prfrable d'importer cette configuration avant la cration du premier projet.

D:\Data\EIA\Cours\PR1\Eclipse4.2_Install_Config.docx

EIA-FR / Jacques BAPST

ACCS LA DOCUMENTATION CONTEXTUELLE DES API

[ Shift+F2 ]

L'environnement Eclipse permet d'afficher contextuellement la documentation des API de la plate-forme

Java (ou de n'importe quelle autre librairie) en positionnant le curseur, dans l'diteur, sur l'lment
concern (classe, champ, mthode, ) puis en pressant sur Shift+F2.
La documentation sera affiche dans la fentre d'un navigateur web.
Par dfaut Eclipse consulte la documentation disponible en ligne sur le site de Sun (une connexion
internet est ncessaire dans ce cas) mais il est possible d'indiquer un autre emplacement par exemple si
la documentation a t installe localement (voir ci-aprs) ou si l'on veut utiliser un site miroir.
L'emplacement de la documentation d'un projet ou d'une librairie peut tre dfini dans les proprits de
ce projet ou librairie (menu contextuel Properties dans la vue Package Explorer).

Installation locale de la documentation

Par dfaut, la documentation de la plate-forme Java n'est pas installe avec le SDK, il faut la tlcharger
depuis le site de Sun (java.sun.com/javase/downloads) et l'installer localement en dcomprimant le fichier
ZIP dans le rpertoire du JDK (par exemple dans C:\Program Files\Java\jdk1.7.0_05) un sous-rpertoire
\docs\ sera cr avec toute une arborescence contenant les fichiers de documentation.
Pour associer cette documentation l'environnement de dveloppement Eclipse, il faut aller dans la vue
Package Explorer, ouvrir la branche JRE System Library, slectionner la librairie rt.jar puis activer le
menu contextuel Properties de cette librairie.
Dans le champ Javadoc location path, dfinir l'emplacement (URL) o se trouve le rpertoire api de la
documentation.
Par exemple :

file:/C:/Program Files/Java/jdk1.7.0_05/docs/api/

Remarque : Cette installation locale n'est effectuer que si vous travaillez la majorit du temps horsconnexion et avez besoin de consulter frquemment la documentation de la plate-forme
Java (sinon c'est inutile de le faire).

D:\Data\EIA\Cours\PR1\Eclipse4.2_Install_Config.docx

EIA-FR / Jacques BAPST

TENDRE LES FONCTIONNALITS D'ECLIPSE L'AIDE DE PLUGINS

Le logiciel Eclipse est constitu par un assemblage de briques logicielles appeles Plugins. Cette
architecture a l'avantage d'tre extensible et permet d'ajouter facilement de nouvelles fonctionnalits
l'application (par chargement dynamique).
Il existe actuellement un trs grand nombre de Plugins qui sont disponibles pour tendre, dans diffrents
domaines, les fonctionnalits de base d'Eclipse (par exemple : Visual GUI Designer, UML, XML, J2ME,
J2EE, Tomcat, etc.). Ces Plugins peuvent tre en open-source, gratuits, payants, avec toutes les
formes de licences et de tarification imaginables.
Diffrents sites rpertorient et classifient les Plugins pour Eclipse, par exemple :
marketplace.eclipse.org

(site officiel de la fondation Eclipse)

www.improve-technologies.com/pages/Java/IDE/Eclipse/Plug-ins

(site en franais)

Installation d'un Plugin

Les Plugins sont gnralement distribus sous forme de fichiers ZIP qui peuvent contenir plusieurs
fichiers mais o l'on trouve pratiquement toujours un ou plusieurs fichiers JAR ainsi qu'un fichier XML
important nomm plugin.xml qui dcrit le composant et qui sera interprt par Eclipse lors de son
lancement.
Certains Plugins disposent d'une URL permettant de les installer directement l'aide du gestionnaire de
mise jour (Update Manager) d'Eclipse. Dans ce cas, il suffit de passer par le menu
Help Software Install New Software... , d'ajouter cette URL dans le champ Work with et cliquant sur le
bouton Add... , puis de slectionner les composants installer et de suivre l'assistant Next >
Pour les Plugins qui ne disposent pas d'un environnement adapt au gestionnaire de mise jour, il suffit
gnralement de dcomprimer le fichier ZIP dans le sous rpertoire \plugins\ qui se trouve en dessous
du rpertoire \eclipse\ l'endroit o l'on a install le logiciel Eclipse. Le Plugin sera automatiquement
charg et activ lors du prochain dmarrage d'Eclipse. Attention bien conserver l'arborescence des
fichiers lors de la dcompression.
Avant l'installation d'un Plugin, il est fortement conseill de consulter la documentation d'installation et
d'utilisation que l'on trouve gnralement sur le site d'o l'on tlcharge le composant.
Attention :

L'installation de certains Plugins mal conus peut rendre instable le fonctionnement de

l'environnement Eclipse. Pour les cas simples, il suffit gnralement de supprimer la ou les
branches cres dans le rpertoire \plugins\ pour dsactiver le Plugin coupable.
Consulter pralablement la documentation pour voir s'il y a une procdure de dsinstallation
qui a t prvue.

Subclipse (client SVN)

Pour le travail en quipe, un client SVN nomm Subclipse peut tre install en utilisant le gestionnaire de
mise jour.
Il suffit d'ajouter l'URL http://subclipse.tigris.org/update_1.6.x et de procder l'installation de tous
les modules (selon procdure dcrite ci-dessus).
Remarque : Ce client SVN n'est pas ncessaire pour les cours de premire anne.

D:\Data\EIA\Cours\PR1\Eclipse4.2_Install_Config.docx

EIA-FR / Jacques BAPST

RSUM DES TAPES

Installer le SDK Java (J2SE, version actuelle 1.7). Suivre les indications de l'assistant d'installation.
Installer Eclipse en dcomprimant le fichier zip dans un rpertoire d'installation
(par exemple C:\Program Files\).
Crer, sur le bureau, un raccourci pointant vers l'excutable \eclipse\eclipse.exe
(par exemple C:\Program Files\eclipse\eclipse.exe).
Lancer Eclipse partir du raccourci et dfinir l'emplacement du Workspace (l'infrastructure ncessaire
sera cre si le rpertoire ne correspond pas un Workspace existant).
Penser placer votre Workspace dans un emplacement que vous sauvegardez priodiquement
(par exemple D:\Eclipse_Projects\).
Configurer Eclipse en important (menu File Import General Preferences) le fichier de
configuration standard ( copier localement) Etu_Std.epf disponible l'adresse :
jacques.bapst.home.hefr.ch/resources/eclipse
Utiliser l'environnement de dveloppement (cration d'un projet Java, cration de classes, dition des
fichiers sources, compilation, excution, utilisation du debugger, ).

INFORMATIONS COMPLMENTAIRES
Pour l'utilisation de l'environnement de dveloppement Java, vous trouverez une introduction dans le
document "Eclipse 4.2 - Dveloppement Java - Premiers pas" disponible l'adresse :
jacques.bapst.home.hefr.ch/pr1/doc/eclipse4.2_premiers_pas.pdf
Quelques liens utiles concernant l'environnement Eclipse sont disponibles sur la page :
jacques.bapst.home.hefr.ch/links/index.htm#IDE
Le logiciel Eclipse n'est soumis aucune licence d'utilisation. Il peut donc tre install et utilis en
toute lgalit sur n'importe quelle machine.

D:\Data\EIA\Cours\PR1\Eclipse4.2_Install_Config.docx

EIA-FR / Jacques BAPST