✎ eclipse [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----
{{ :eclipse.png?200|Logo d'Eclipse}}
====== IDE : Eclipse ======

**Eclipse** est un [[wpfr>Environnement_de_d%C3%A9veloppement_int%C3%A9gr%C3%A9| IDE]] (environnement de développement intégré) écrit en Java, extensible par des greffons, multi-langages et multi-plates-formes, qui s'intègre particulièrement bien à [[:gnome|GNOME]].

Il est d'abord conçu pour le langage Java mais ses nombreux greffons en font un environnement de développement pour de nombreux autres langages de programmation (C/C++, Python, PHP, Ruby, ...).

Toutes les fonctions qu'on peut attendre de ce genre de logiciel sont présentes ou existent sous forme de greffons (coloration syntaxique, complétion, debugger, gestion de projets, intégration aux gestionnaires de versions, ...).

Les versions 4.3 (Kepler) et supérieures autorisent soit l'utilisation de la bibliothèque Gnome GTK 2 soit celle de la bibliothèque GTK 3. À partir de la version 4.5 (Mars)  GTK 3 est la bibliothèque par défaut.

===== Pré-requis =====

* Avoir une machine virtuelle [[:Java]] fonctionnelle (des différences de performances peuvent apparaître suivant la machine virtuelle java choisie) ;
  * Avoir les compilateurs et/ou interpréteurs ([[gcc|C/C++]], [[:python]], [[php|php]], [[:rubyonrails|ruby ou ruby on rails]],...) des langages choisis pour développer, installés et fonctionnels, et les outils complémentaires ([[:subversion|subversion]], [[:cvs]], [[:bzr]], [[:apache2|Apache]], [[:mysql|MySQL]], ...) que vous voudrez utiliser.

==== Installation par le nouvel outil "Eclipse Installer" ====
<note important>Cette solution est à privilégier pour avoir une version à jour </note>
[[Eclipse Installer]] est téléchargeable à l'adresse suivante [[https://eclipse.org/downloads/]]. Il se présente sous la forme d'une archive **tar.gz** (exemple : eclipse-inst-linux64.tar.gz) à décompresser dans le répertoire permanent de votre choix (par défaut : eclipse-installer) dans votre 'HOME'.
<code>
md5sum ~/Téléchargements/eclipse-inst-linux64.tar.gz
# Si la CheckSum est correcte :
cd..
tar xvfz  ~/Téléchargements/eclipse-inst-linux64.tar.gz
</code>
Le lancement peut se faire ainsi
<code>
cd eclipse-installer
./eclipse-inst
</code>
{{ :eclipse:oomph.png?nolink&400 |}}

Un point d'exclamation en haut à droite (sur le bouton "hamburger") indique que l'outil peut être mise à jour.

Suivre les instructions en faisant bien attention de retenir les répertoires que l'outil va créer sous votre répertoire $HOME/eclipse.
{{ :eclipse:oomphplateform.png?nolink&400 |}}

L'intérêt de cet outil étant de pouvoir installer plusieurs configurations d'éclipse (ici la configuration de base dans le répertoire **ide-latest**) tout en n'utilisant qu'un seul "pool" de plugins (conservés dans le répertoire **~/.p2**).

Pour chaque installation l'outil vous proposera un répertoire différent sous le répertoire $HOME/eclipse. Il est donc important de bien les retenir pour leur associer un lanceur ou éventuellement les supprimer.

===Launcher (.desktop) pour eclipse-inst===

Même s'il ne sert que pour les installations (voir le nouveau menu Eclipse  **Help / Perform Setup Task ...** pour les mises à jour) Il est utile de conserver cet outil, d'autant plus qu'il a son propre système de mise à jour. Pour cela créez un launcher (ex : eclipse-inst.launcher) que vous pourrez placer dans votre répertoire ~/.local/share/applications/ pour qu'il soit facilement récupérable par le dash [[unity]] ou la recherche [[gnome-shell]] :

<file>
[Desktop Entry]
Encoding=UTF-8
Version=1.0
Type=Application
Name=Eclipse Installer 
Icon=swt.png
Path=/home/????????/eclipse-installer
Exec=/home/????????/eclipse-installer/eclipse-inst
StartupNotify=false
StartupWMClass=SWT
</file>

Voir la page [[Eclipse Installer]] pour profiter au mieux de tous les apports de ce nouvel outil.
==== Installation par les dépôts officiels de l'ancienne version 3.8 ====

[[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **[[apt>eclipse|eclipse]]**. Si besoin, la machine Java OpenJDK sera automatiquement installée. Pour avoir directement les greffons pour le C/C++, installez plutôt le paquet **[[apt>eclipse-cdt|eclipse-cdt]]**.

=== Eclipse en français ===

<note warning>Déconseillé pour les outils de développement car tous les textes ne sont pas traduits. Ces traductions sont à réserver aux applications RCP (large public) bâties sur le framework Eclipse </note>

- Ouvrez Eclipse ;
  - Allez dans le menu **Help -> Install New Software…** ;
  - Cliquetez sur le bouton **Add…** ;
  - Donnez un nom au serveur (par exemple //Traduxion// ;-)) et copiez-collez l'adresse correspondant à votre version avant de valider le formulaire. La liste des archives disponibles est consultable à l'adresse suivante :  http://archive.eclipse.org/technology/babel/

^ Version Eclipse ^ Adresse ^
| Eclipse 4.4 (Luna) | http://archive.eclipse.org/technology/babel/update-site/R0.12.1/luna/  |
| Eclipse 4.3 (Kepler) | http://archive.eclipse.org/technology/babel/update-site/R0.12.0/kepler  |
| Eclipse 4 (Juno)  | http://archive.eclipse.org/technology/babel/update-site/R0.12.0/juno  |
| <del>Eclipse 3.7 et 3.8 (Indigo)</del>  | <del>http://download.eclipse.org/technology/babel/update-site/R0.12.0/indigo</del>  |
| <del>Eclipse 3.6 (Helios)</del>  | <del>http://download.eclipse.org/technology/babel/update-site/R0.10.1/helios</del>  |

<note warning>Eclipse 3.6, 3.7 et 3.8 ne sont plus supportés. Il est impératif de faire la mise à jour pour profiter du pack de langue français...</note>

Pour utiliser Eclipse en français, vous devez installer un pack de langue //babel// en ajoutant un serveur de mise à jour.
Si les adresses de serveur ne fonctionnent plus, il faudra peut-être remplacer le numéro de version (R0.11.0) par celui de la dernière version indiquée sur [[http://www.eclipse.org/babel/downloads.php|la page du projet Babel]].

Eclipse devrait vous afficher //pending...// puis au bout d'un moment, le menu d'installation des packs de langues apparaîtra. La traduction d'Eclipse est disponible sous l'intitulé « Babel Language Packs for eclipse » où vous pourrez choisir la langue appropriée. Après la fin de l'installation, la langue sera prise en charge automatiquement au redémarrage du logiciel.

==== Installation des dernières versions disponibles sans l'outil "Eclipse Installer" ====

Il s'agit de la façon traditionnelle et aussi la plus simple pour installer Eclipse.

Cette solution vous permet d'utiliser les toutes dernières versions d'Eclipse.

**Eclipse** étant développé en Java, il ne nécessite qu'une [[:java|machine virtuelle Java]] pour fonctionner.

* Téléchargez directement (et en ignorant "Eclipse Installer") la version et la configuration qui vous convient sur la page [[http://www.eclipse.org/downloads/|site officiel]], en effet des packs tout prêts suivant le langage de programmation que vous voudrez utiliser sont disponibles pour différentes plate-formes (x86, x86_64, PPC, ...), cherchez bien. Lisez la page comparative des différentes configurations [[https://www.eclipse.org/downloads/compare.php|Principales Configurations]] pour vous faire une idée.
  * Créez un dossier où vous voulez : **/opt/eclipse** ou pourquoi pas le dossier **.eclipse3.x** placé dans votre dossier personnel histoire qu'il "disparaisse" (__/!\__ //__attention__, évitez de nommer le dossier __.eclipse__ car il est utilisé par la version disponible dans les dépôts si vous comptez également utiliser cette dernière.//)
  * Décompressez l'archive précédemment téléchargée dans ce dossier (une remarque, les archives contiennent le dossier "eclipse" qui au final ne sert à rien si on choisit un autre nom pour le dossier où nous plaçons les fichiers)
  * Lancer Eclipse en le situant bien dans son répertoire d'installation : /opt/eclipse/eclipse ou ~/.eclipse3.X/eclipse. la commande "eclipse" vous invitera à installer le dépôt ou, si celui-ci est installé, lancera la version eclipse du dépôt.

===== Créer un lanceur =====
Pour les dernières versions il peut être utile de créer un lanceur pour lancer Eclipse depuis son bureau préféré.

Pour [[raccourci-lanceur|Créez un lanceur]] dans votre menu Application afin de lancer le fichier **eclipse**
 : [[:tutoriel:comment_modifier_un_fichier|créer le fichier]] **eclipse.desktop** ou en ligne de commande
**gksudo gedit /usr/share/applications/eclipse.desktop**

et copiez-y le texte suivant dans le fichier eclipse.desktop (en supposant que votre répertoire eclipse se trouve sous /opt)

[Desktop Entry]
  Name=Eclipse 
  Type=Application
  Exec=/opt/eclipse/eclipse
  Terminal=false
  Icon=/opt/eclipse/icon.xpm
  Comment=Integrated Development Environment
  NoDisplay=false
  Categories=Development;IDE
  Name[en]=Eclipse

<note important>Donnez les droits en lecture à tous les utilisateurs au fichier eclipse.desktop créé.

''sudo chmod a+r /usr/share/applications/eclipse.desktop'' </note>
Et voilà, c'est fait. Vous pouvez même avoir plusieurs versions et/ou configurations différentes sur votre machine sans aucun problème tant que vous séparez les espaces de travail (workspace).

Pour avoir le français (pour toutes les versions), téléchargez les packs de langue [[http://babel.eclipse.org/babel/|ici]] et décompressez-les de la même façon dans votre dossier d'installation.

Pour avoir le français (pour les versions 3.3.x), [[http://blog.developpez.com/java?title=installer_eclipse_en_francais|lisez cet article]].

===== Résolutions des problèmes =====
==== Lancement d'Eclipse ====
__Description__\\
Rien ne se passe...

__Solution__\\
Suivez [[java#je_souhaite_executer_un_programme_java|cette page]].

==== Erreur au lancement ====
=== Problème avec le Workspace ===
__Description__\\
Si, au lancement d'**Eclipse**, vous avez une erreur et en vérifiant votre rapport d'erreur à cet emplacement **workspace/.metadata/.log** vous voyez une phrase comme : "Failed to map segment to shared object: Operation not permitted".

__Solution__\\
Il faut vérifier que le système de fichiers où se trouve votre répertoire personnel (typiquement /home) est monté avec l'autorisation d'exécution pour les programmes. Pour cela tapez :
  mount | grep home
Si **/home** est monté avec l'option **noexec**, il faut [[:mount_fstab|modifier le fichier /etc/fstab]] et retirer cette option de la ligne /home du fichier.
===Problème de chargement d'une bibliothèque SWT ===
__Description__\\
Si, au lancement d'**Eclipse**, il y a une erreur et, en vérifiant le fichier de log, il est possible de lire quelque chose ressemblant à ceci :
<code>
java.lang.UnsatisfiedLinkError: Could not load SWT library. Reasons: 
        no swt-gtk-3740 in java.library.path
        no swt-gtk in java.library.path
        Can't load library: /home/<nom_utilisateur>/.swt/lib/linux/x86[_64]/libswt-gtk-3740.so
        Can't load library: /home/<nom_utilisateur>/.swt/lib/linux/x86[_64]/libswt-gtk.so
</code>

__Solution__\\
Il faut ajouter un lien symbolique vers les bibliothèques SWT contenues dans /usr/lib/jni/ vers le dossier :
  * /.swt/lib/linux/x86/ pour un système 32 bits ;
  * /.swt/lib/linux/x86_64/ pour un système 64 bits.
Ce qui vous donne :
  * Pour un système 64 bits.
<code bash>
ln -s /usr/lib/jni/libswt-* .swt/lib/linux/x86_64/
</code>
  * Pour un système 32 bits.
<code bash>
ln -s /usr/lib/jni/libswt-* .swt/lib/linux/x86/
</code>

==== Could not initialize… ====
__Description__ \\
Si au lancement d'**Eclipse**, vous obtenez l'erreur suivante: "Could not initialize the application's security component. The most likely cause is problems with files in your application's profile directory. Please check that this directory has no read/write restrictions and your hard disk is not full or close to full. It is recommended that you exit the application and fix the problem. If you continue to use this session, you might see incorrect application behaviour when accessing security features."

__Solution__\\
Il suffit de créer un dossier vide nommé eclipse dans le répertoire .mozilla de votre répertoire utilisateur. Pour cela, tapez :
  mkdir ~/.mozilla/eclipse

==== Bugs d'affichages Eclipse Mars et supérieurs ====
__Description__ \\
A partir d'Eclipse Mars, l'utilisation de la **bibliothèque GTK 3** pouvant provoquer des problèmes d'affichage, il est possible de démarrer Eclipse en utilisant la **bibliothèque GTK 2**

__Solution__\\
Avant de démarrer Eclipse, positionner la variable :
<code>
export SWT_GTK3=0
</code>

Il est aussi possible de définir cette option dans le fichier eclipse.ini en y ajoutant les deux lignes suivantes :

<code>
--launcher.GTK_version 
2
</code>

==== Bugs d'affichages ====
__Description__ \\
Dans les anciennes versions d'Ubuntu (Eclipse 3.5), un bug gênant peut apparaître. Lorsque vous ouvrez une boîte de dialogue, les boutons (Next, Finish, etc.) ne semblent pas répondre.

__Solution__\\
C'est un bug dû à un mauvais paramètre GDK. Vous pouvez démarrer Eclipse grâce au script suivant :
<code>
  #!/bin/sh
  export ECLIPSE_HOME="/chemin/vers/votre/dossier/dinstallation"
  export GDK_NATIVE_WINDOWS=1
  $ECLIPSE_HOME/eclipse $*
</code>

==== Problème de mémoire ====
__Description__ \\
Un problème de mémoire (java.lang.OutOfMemoryError: GC overhead limit exceeded) peut apparaître, par exemple lors d'installation de plugins (Help->"Install New Software"). La version 64 bits utilisée par le SDK d'Eclipse nécessite plus de mémoire que la version 32 bits.

__Solution__\\
Vérifier que vous avez une taille de mémoire suffisante définie dans le fichier eclipse.ini de votre répertoire d'installation (source : [[https://www.jfire.org/modules/phpwiki/index.php/Development Troubleshooting| site JFire]]):
  
  -Xms512m
  -Xmx1024m
  -XX:PermSize=64m
  -XX:MaxPermSize=256m

==== Transitions très lentes ====
__Description__ \\
Une latente très marquée est constatée lorsqu'on agrandit par exemple l'éditeur de code. Durant ces lenteurs, le taux d'utilisation du processeur marque un pic. Ce défaut se produit avec d'anciennes cartes vidéo ATI utilisant le pilote libre Radeon.

Rapport de bug: https://bugs.launchpad.net/ubuntu/+source/xserver-xorg-video-ati/+bug/363238

__Solution__\\
Modifier les paramètres du serveur X et plus particulièrement l'accélération 2D.
Se reporter à la page de documentation [[radeon#probleme_de_performance_sur_anciennes_carte_radeon|radeon]].

==== Les menus ne se déplient pas ou sont incomplets ====
__Description__\\
A partir d'Ubuntu 13.04 et la gestion du [[HUD]] et du menu global, divers problèmes concernant les menus Eclipse "File, Edit, Navigate, Search... etc" peuvent apparaître.

Exemple Ubuntu 13.04 : Les menus principaux sont présents dans la barre de fenêtre mais lorsque l'on clique dessus, ils ne se déplient pas.

Exemple Ubuntu 15.04 beta 1 : Les sous menus remplis dynamiquement  "New" et "View" ne contiennent que le minimum.

__Solution__\\
En attendant la correction du bug, pour pouvoir avoir des menus fonctionnels, un contournement consiste à modifier le lanceur de l'application comme suit :\\
Ouvrir le fichier lanceur :
<code bash>gksudo gedit /usr/share/applications/eclipse.desktop</code>

Changez la ligne :
<file>Exec=/opt/eclipse/eclipse</file>
Par :
<file>Exec=env UBUNTU_MENUPROXY= /opt/eclipse/eclipse</file>

==== Eclipse se ferme sans raison apparente ====
__Description__\\
Que ce soit avec la version disponible dans les dépôts ou avec celle téléchargée sur eclipse.org, il arrive qu'Eclipse se ferme sans raison apparente. Le bug est facilement reproductible : Si vous auto-complétez votre code (CTRL + ESPACE) et qu'Eclipse se ferme, vous êtes victime de ce bug.
Si le problème ne se produit plus quand vous lancez Eclipse à l'aide de la commande suivante :
<code>eclipse -vmargs -Dorg.eclipse.swt.browser.DefaultType=mozilla</code>
Vous pouvez modifier le fichier eclipse.ini et rajouter :
<file>-Dorg.eclipse.swt.browser.DefaultType=mozilla</file>
en dessous de <file>-vmargs</file>

Source : https://bugs.eclipse.org/bugs/show_bug.cgi?id=410739#c3
===== Les greffons supplémentaires =====

Que vous ayez choisi l'installation par les dépôts, ou l'installation manuelle, vous voudrez sûrement ajouter des fonctionnalités complémentaires à votre **Eclipse**.

__Ajout de greffons pour les versions les plus récentes__

La façon la plus simple pour installer des greffons externes est d'utiliser le site [[https://marketplace.eclipse.org/| Eclipse Market Place]].

Faite une recherche sur la fonctionnalité désirée, évaluez le produit à l'aide des commentaires, puis, pour l'installer, faites glisser le bouton "Install" depuis votre browser internet jusqu'à votre fenêtre principale Eclipse.

<note important>
Le nouvel outil **Eclipse Installer** a aussi pour fonction de vous aider à installer vos greffons préférés entre diverses versions et configurations.
</note>

__Ajout de greffons pour toutes les versions__

Ils s'agit de la façon la plus précise d'installer des greffons. Pour cela il faut utiliser le menu **Help > Install New Software** (//"Install and Update" pour les plus anciennes versions//) .

Là vous pourrez soit rechercher de nouveaux composants des sites de dépôts déjà configurés, soit ajouter de nouveaux sites de dépôts pour pouvoir en ajouter les greffons qu'ils proposent.

<note important>Attention : le système de mises à jour d'Eclipse ne fonctionne pas correctement derrière un proxy d'entreprise à cause de problèmes de formatage de l'authentification. Ceci est notamment vrai avec Java 1.5 et une authentification de réseau Windows.</note>

===== Développer pour Android =====

Voir la [[Android|page dédiée à Android]].

===== Principales Configurations =====
Vous pouvez configurer **Eclipse** ainsi que toutes ses extensions au même endroit en allant dans le menu //**Fenêtre > Préférences...**  (window > Préférences... en anglais)// qui se présente avec à gauche les différents éléments configurables (Général, Java, Ant, ...) sous forme d'une arborescence, et à droite les différentes options de configuration suivant l'élément sélectionné. Tous les greffons que vous installerez rajouteront leur page de configuration à cet endroit pour que vous puissiez y accéder facilement.

==== Eclipse pour Java ====
//(installation par les dépôts ou non déjà décrite plus haut)//

Pas besoin de rajouter de greffons pour faire du Java avec **Eclipse**, il suffit de choisir la bonne distribution sur le site officiel et de l'installer comme décrit plus haut.

Il y a 3 distributions officielles principales pour développer en Java:
  * **Eclipse IDE for Java Developers** contenant tout ce qu'il faut pour le développement Java.
  * **Eclipse IDE for Java EE Developers** destinée au développement avec le SDK Java Edition Entreprise pour le serveur d'application du même nom.
  * **Eclipse for RCP/Plug-in Developers** destinée au développement d'**Eclipse** et des greffons, mais de ce fait aussi très complète, avec les sources d'**Eclipse**.

=== Voir les sources de Java en faisant ctrl + clique gauche ===
[[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **sun-java6-source**

==== Eclipse pour C/C++ ====

(installation par les dépôts ou non déjà décrite plus haut)

Si vous souhaitez utiliser **Eclipse** uniquement pour développer en C/C++, et que vous installez Eclipse manuellement, nous vous recommandons de prendre directement la version **Eclipse IDE for C/C++ developpers** qui ne contient que l'essentiel sans surcharge, et qui contient surtout le greffon décrit ci-dessous.

Si vous souhaitez intégrer la prise en charge du langage C/C++ dans votre installation Eclipse, il vous faut le greffon **CDT: C/C++ Development Tooling**.

__Installation__

Dans **Help -> Install new software ...** : 
  * Sélectionner le site officiel de votre distribution (exemple : Mars - … download.eclipse.org/release/mars).
  * Filtrer la liste des greffons avec le mot clef **C++**, sélectionner **C/C++ Development Tools**, et lancer l'installation.
  * Relancer **Eclipse**

Il ne reste plus qu'à vérifier dans les préférences d'**Eclipse** que le greffon est configuré selon vos besoins, surtout la partie sur Make.

__Liens spécifiques__
  * [[http://www.eclipse.org/cdt|Site Officiel (en)]]
  * [[http://c.developpez.com/|C sur developpez.com (fr)]]
  * [[http://cpp.developpez.com/|C++ sur developpez.com (fr)]]

==== Eclipse pour Perl ====

Il existe un plugin d'Eclipse pour Perl, disponible sur [[http://www.epic-ide.org/]]. Pour l'installer, ajouter l'url http://e-p-i-c.sf.net/updates (ou http://e-p-i-c.sf.net/updates/testing pour la version en développement) à la liste sites de mise à jour (Help > Install New Software...), et choisissez le plugin à installer.

__Liens spécifiques__
 * [[http://www.epic-ide.org/|Site Officiel (en)]]
 * [[http://www.epic-ide.org/download.php|Instructions pour l'installation (en)]]
==== Eclipse pour Python ====

Pydev ne faisant pas partie des configurations officielles d'Eclipse il peut être entièrement installé à partir du site officiel : [[http://www.pydev.org/download.html| Pydev Standalone Install]].
Une autre façon d'installer et d'utiliser Pydev est d'installer le pack [[https://www.liclipse.com/index.html|LiClipse]] (qui intègre Eclipse et Pydev) au lieu d'installer et configurer Eclipse

__Installation Drag&Drop de Pydev sur une configuration Eclipse existante__ :

Aller sur le Market Place d'Eclipse :[[https://marketplace.eclipse.org/content/pydev-python-ide-eclipse|Greffon Pydev]] Faire glisser le bouton **Install** du browser internet vers la fenêtre principale d'éclipse.

__Installation manuelle de Pydev sur une configuration Eclipse existante__ :

**Installation manuelle du greffon PyDev**
  * Ajouter un **Nouveau Site Distant...** :
    * Aide (help)
    * Installer un nouveau logiciel (install a new software)
    * Ajouter (Add)
      * Name = **PyDev** ou un autre nom que vous choisissez
      * Location = http://www.pydev.org/updates* Sélectionner ce nouveau site et lancer la recherche en appuyant sur terminé.
  * Sélectionner **PyDev for Eclipse** et lancer l'installation.
  * Relancer **Eclipse** et c'est fini :)

Il ne reste plus qu'à vérifier dans les préférences d'**Eclipse** que le greffon PyDev est configuré selon vos besoins. Vérifier surtout que les chemins vers les interpréteurs (**/usr/bin/python** et **/usr/share/java/jython.jar** si vous voulez utiliser jython) sont correctement définis.

Il faut aussi penser à ajouter la perspective PyDev pour un accès plus rapide à celle-ci.

__Liens spécifiques__
  * [[:python|Python sur ce wiki (fr)]]
  * [[http://pydev.org/|PyDev (en)]]
  * [[http://www.python.org/|Site Officiel Python (en)]]
  * [[http://python.developpez.com/|Python sur Developpez.com (fr)]]
==== Eclipse pour PHP  ====

=== PDT: PHP Development Tools ===

(Installation par les dépôts ou non déjà décrite plus haut)

Eclipse PDT est désormais une configuration officielle d'Eclipse. Elle peut être téléchargée du : [[https://eclipse.org/downloads/|site de téléchargement officiel]]

__Liens spécifiques__
  * [[http://www.eclipse.org/pdt/|Site officiel (en)]]

==== Eclipse pour Ruby/RubyOnRails ====
Selon que vous vouliez développer en Ruby seul, ou avec l'aide du framework Rails très prisé pour ses qualités dans le développement web, vous avez le choix entre deux configurations différentes, à vous de choisir celle qui vous convient le mieux (n'installer pas les deux, cela ne sert à rien et peut entraîner des conflits).

=== Ruby grâce à Eclipse DLTK ===

Le projet DLTK (Dynamic Languages Toolkit) offre plusieurs implémentations exemplaires des plus célèbres langages dits "dynamiques" :  Tcl, Ruby ...

L'intégration du langage Ruby se fait avec le greffon officiel **Dynamic Langage Toolkit: Ruby Development Tool** qui permet de ne pas surcharger votre IDE.

__Installation__
  * Dans le menu **Help -> Install new Software**
  * Sélectionner le site officiel de votre distribution (exemple : Mars - ... download.eclipse.org/release/mars).
  * Filtrer les greffons disponibles avec, par exemple, la recherche "Dyna"
  * Sélectionner le greffon **Dynamic Langage Toolkit: Ruby Development Tool** et lancer l'installation.
  * Relancer Eclipse.

Aller ensuite dans les préférences pour configurer selon vos besoins **Window -> Preferences -> Ruby -> Interpreters **

=== Ruby/Ruby on Rails par Aptana ===
Pour travailler avec [[:rubyonrails| Ruby On Rails]] Le greffon RadRails vous est proposé par [[#eclipse_et_aptana|Aptana]] (ainsi que le greffon RDT ci-dessus) et lui est particulièrement lié. Nous allons voir ici comment l'installer sans toute l'artillerie du greffon Aptana. Toutefois, la méthode la plus simple reste l'installation d'[[#eclipse_et_aptana|Aptana]] qui est décrite plus bas et qui intègre un mécanisme d'installation de ce greffon simplifiée.

__Installation__
  * Dans le menu **Help -> Install new Software**
  * Ajouter un **Nouveau Site Distant...** (New Remote Site)  <file> http://download.aptana.com/studio3/plugin/install</file>
  * Sélectionnez ce site et installez : ** Aptana Studio ... Plugin**
  * Relancer Eclipse

Cette installation peut paraître compliquée, de plus il vous faudra aller dans les préférences comme d'habitude pour configurer selon vos besoins, et indiquer les chemins vers l'interpréteur ruby (**/usr/bin/ruby**) facultatif car jruby (interpréteur ruby écrit en java) est aussi installé et le framework rails.

__Liens spécifiques__
  * [[:rubyonrails| Ruby on Rails sur le wiki (fr)]]
  * [[http://www.aptana.com/|Site officiel d'Aptana (en)]]

==== Eclipse pour le Web ====

Pour travailler plus facilement avec des fichiers html, css, js, xml, ... que l'on rencontre généralement dans le développement d'applications web, Eclipse met à notre disposition des greffons regroupés sous le projet **WTP : Web Tools Platform**. La plupart de ces greffons sont d'ailleurs déjà intégrés dans certaines configurations d'Eclipse (comme "Eclipse for Java EE").

__Installation__

Dans **Help -> Install new software ...** : 
  * Sélectionner le site officiel de votre distribution (exemple : Mars - … download.eclipse.org/release/mars).
  * Déplier en fin de la liste le groupe de greffons "Web, Xml , JavaEE and OSGI Enterprise ..."
  * Installer **Eclipse Web Developer Tools**, **Javascript Development Tool** et tout ce qui vous fait envie.
  * Redémarrer Eclipse.

Le meilleurs moyen pour faire connaissance avec ces nouveaux plugins est, sans aucun doute, d'ouvrir la liste des assistants qu'ils ont apportés dans le menu **File -> New -> Others ... ** ou la liste de nouvelles vues qu'ils offrent dans "Window -> show view -> Others ..."

=== Web 2.0 avec AJAX ===
Pour ceux qui veulent aller plus loin et faire de belles pages utilisant de l'AJAX grâce aux bibliothèques existantes actuellement (Dojo, Scriptaculous, ...), le projet [[http://sourceforge.net/projects/jseditor/|Eclipse ATF]]  étant moribond, les solutions Macromedia/Adobe ayant disparues ... le greffon Aptana décrit plus bas est sans doute encore une solution si vous ne trouvez pas votre bonheur avec la configuration officielle https://eclipse.org/webtools/.

__Liens spécifiques__
  * [[http://www.eclipse.org/webtools/|Site Officiel d'Eclipse WTP (en)]]

==== Eclipse pour Latex ====

Le plug-in Texlipse permet d'éditer un fichier Latex dans Eclipse : [[http://texlipse.sourceforge.net/|http://texlipse.sourceforge.net/]]

Pour l'installer, ajouter http://texlipse.sourceforge.net/ au gestionnaire de mise à jour d'Eclipse.

==== Eclipse et Aptana ====
<note important>Aptana peut créer des conflits avec certains greffons, notamment ceux couvrant des domaines qu'il couvre également (Web, PHP, Ruby...)</note>

Aptana est avant tout un IDE basé sur Eclipse, néanmoins une version sous forme de greffon existe afin de vous permettre d'intégrer tous les greffons développés par Aptana dans votre configuration Eclipse actuelle.

Aptana est orienté vers le développement internet, il dispose de ce qu'il faut pour écrire vos applications web, avec l'intégration de la plupart des bibliothèques AJAX. Il offre de plus la possibilité d'ajouter très facilement le support de PHP et de [[:rubyonrails|Ruby On Rails]] ainsi que de [[:subversion|Subversion]] dans votre IDE, et dispose en plus de quelques greffons qui pourront vous faire plaisir.

__Installation du greffon__
  * Dans le menu **Help -> Install new Software**
  * Ajouter un **Nouveau Site Distant...** (New Remote Site)  <file> http://download.aptana.com/studio3/plugin/install</file>
  * Sélectionnez ce site et installez : ** Aptana Studio ... Plugin**
  * Relancer Eclipse

Allez ensuite dans les préférences pour finir de configurer selon vos besoins. Profitez-en pour afficher aussi "Aptana start page" qui se trouve dans le menu aide, vous aurez ainsi accès à une présentation claire des greffons complémentaires disponibles chez Aptana.

__Liens spécifiques__
  * [[http://www.aptana.com/|Site officiel (en)]]

<note help>Aptana Studio étant un IDE complet, si vous ne voulez que faire du développement web, vous pouvez l'installer de façon autonome sans passer par l'installation préalable d'Eclipse : [[:aptana_studio|Page sur Aptana Studio]]</note>

==== Eclipse et FTP ====

Pour pouvoir modifier directement vos fichiers se situant sur un FTP (un peu comme l'éditeur Quanta+ de KDE), vous pouvez installer DSDP ([[http://wiki.eclipse.org/DSDP/TM]]).

__Installation__

Dans **Help -> Install new software ...** : 
  * Sélectionner le site officiel de votre distribution (exemple : Mars - … download.eclipse.org/release/mars).
  * Filtrer les greffons à l'aide du mot clef "Remote".
  * Installer Remote System Explorer End-User Runtime.

Après l'avoir installé, il vous faut vous rendre dans **Windows -> Show View -> Others**  puis **Remote Systems -> Remote Systems**.

Dans le nouvel onglet qui apparaît, cliquez droit puis faites **New Connection** pour ajouter un FTP.

==== Eclipse et Visual Editor (Obsolète) ====
[[https://wiki.eclipse.org/Visual_Editor_Project|Visual Editor]] est un plugin Eclipse qui vous permet de dessiner graphiquement votre interface graphique en générant à la volée le code correspondant.
<note warning>
Le projet **Visual Editor** a été abandonné au profit du projet [[https://eclipse.org/windowbuilder/| Eclipse Window Builder]] qui peut être installé à partir des configurations officielles (cf. "Install new software ...")
</note>

==== Eclipse et WindowBuilder ====
WindowBuilder est un projet qui offre un outil graphique pour la création d'interfaces utilisateurs. La version 1.8.0 (Eclipse Mars) offre la possibilité de créer des interfaces GUI pour :
  * SWT, JFace et RCP : les bibliothèques du framework d'Eclipse.
  * SWING : La bibliothèque officielle JAVA en cours d'être supplantée par JavaFX.
  * GWT : Google Web Toolkit via **GWT Designer** qui semble abandonné.

__Installation__

Dans **Help -> Install new software ...** : 
  * Sélectionner le site officiel de votre distribution (exemple : Mars - … download.eclipse.org/release/mars).
  * Filtrer les greffons à l'aide du mot clef "Designer".
  * Installer  **Swing Designer** et ou **SWT Designer** .
  * Redémarrer Eclipse.

Ensuite vous n'avez plus qu'à créer l'objet de vos désirs à l'aide des assistants **File -> New -> others -> WindowBuilder ...** en gardant à l'esprit que cet outil n'est absolument pas nécessaire pour créer de beaux interfaces utilisateurs.

===== Eclipse en équipe =====

==== Eclipse et CVS ====
Eclipse intègre la gestion CVS pour gérer vos différentes versions et travailler en collaboration avec d'autres utilisateurs.

Vous n'avez donc rien de plus à installer pour utiliser CVS, la configuration générale se fait dans les préférences dans la rubrique **Equipe** (Team en anglais), et la configuration par projet se fait en cliquant avec le bouton droit sur le nom du projet et vous verrez également le menu **Equipe** pour pouvoir configurer votre accès à un serveur CVS.

__Liens Spécifiques__
  * [[:cvs|CVS sur ce wiki (fr)]]
  * [[:cvs_server|Installer un serveur CVS (fr)]]

==== Eclipse et Subversion ====

Subversive et Subclipse sont tous deux des greffons pour Eclipse permettant de se connecter à un dépôt SVN.

=== 1. Subversive ===

Voir le tutoriel spécifique : [[eclipse_subversive|Subversive]]

=== 2. Subclipse ===

Voir le tutoriel spécifique : [[eclipse_subclipse|Subclipse]]

==== Eclipse et Bazaar ====
//FIXME à faire, Ubuntu étant sur bazaar autant en parler aussi ici, surtout qu'il existe un plugin récent pour ça//

==== Eclipse et Git ====

EGit est désormais intégré aux configurations officielles. Il est donc disponible sur les plus récentes versions.

Pour les versions d'Eclipse plus anciennes, le plug-in Egit existe pour permettre de travailler avec Git : [[http://www.eclipse.org/egit/|http://www.eclipse.org/egit/]] .

Il suffit de le chercher dans le dépôt de votre version d'Eclipse, par exemple : http://download.eclipse.org/releases/mars , rubrique Collaboration.

S'il n'est pas disponible dans le dépôt principal, vous pouvez aussi ajouter ce dépôt : http://download.eclipse.org/egit/updates .

Pour cloner un projet existant, aller dans Fichier -> Importer

=====Eclipse et MDA=====
L'architecture dirigée par les modèles ou MDA (pour l'Anglais Model Driven Architecture) est une démarche de conception de logiciel, proposée et soutenue par l'OMG. Un exemple typique est la génération automatique de code source  à partir d'une modélisation UML.

Introduction :
   * [[http://pparrend.developpez.com/tutoriel/mda-intro/|Introduction à MDA : Principe]]
   * [[http://pparrend.developpez.com/tutoriel/mda-pratique/|Introduction à MDA par la pratique]]

Des solutions libres :
   * [[Acceleo]] ([[http://www.acceleo.org/pages/accueil/fr|site]]) est un générateur de code qui permet de transformer des modèles vers du code (approche MDA ).

Acceleo est simple à utiliser, dispose de générateurs prêts à l'emploi (JEE, .Net, Php...) et d'éditeurs de templates de génération sous Eclipse.

* [[EMF]] (Eclipse Modeling Framework) ([[http://download.eclipse.org/tools/emf/scripts/downloads.php|site]]), l'environnement de la plate-forme Eclipse dédié au MDA,
   * GMT Project ([[http://www.eclipse.org/gmt/|site]])
   * ATL (Atlas Transformation Language), disponible sous forme de plugg-in pour Eclipse, qui permet de réaliser des transformations quelconques sur des données au format XMI,
   * Poséidon ([[http://www.gentleware.com/products/download.php4|site]]), qui existe également sous forme de plugin Eclipse (en version payante), mais qui est utilisé ici dans sa version Communauté, en libre accès.
   * JMI, Java Metadata Interface, permet d'accéder à une base de données de métamodèle et de les manipuler

===== Désinstallation =====

==== Version des dépôts ====
Si vous avez utilisé les dépôts Ubuntu, pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer les paquets]] installés. La configuration de l'application sera conservée ou supprimée selon la méthode de désinstallation que vous choisirez.

Vérifier également que le dossier **.eclipse** de votre dossier personnel ait bien été supprimé pour qu'aucune trace de votre configuration d'Eclipse ne perdure.

==== Version installée manuellement ou par Eclipse Installer ====
Si vous avez installé manuellement Eclipse, supprimez tout simplement le dossier dans lequel vous l'avez installé, sans oublier le lanceur du menu Application si vous en avez créé un.

==== Désinstaller un Greffon ====
Pour faire cela tout ce passe dans le menu //**Aide > Mise à jour de logiciels > Gérer la configuration...**// (en anglais //Help > Software updates > Manage configuration//).

Là vous verrez une arborescence des divers éléments et greffons installés, qu'il vous faut **Désactiver** (disable) avant de les **Désinstaller** (uninstall) (pensez à afficher les éléments désactivés gràce au boutons prévu à cet effet).

Attention, la désinstallation de certains éléments peut entraîner des problèmes de dépendances qui risquent de rendre inopérationnel votre IDE. Faites très attention !

===== Utilisation/Liens =====

Eclipse étant un IDE complet et multi-langages, décrire comment le configurer ou l'utiliser mériterait une multitude de pages, voire même plusieurs livres, et ce n'est pas le but de ce wiki.

==== Astuces ====

__Soyez prévoyants__\\
Une fois votre installation manuelle réalisée, vos greffons installés, et votre configuration personnalisée, pensez à compresser votre dossier d'installation pour le sauvegarder dans un coin, comme ceci vous n'aurez pas à refaire tout ce travail de réinstallation si il vous arrive un pépin. Une simple décompression de votre distribution personnelle suffira.

__Afficher les numéros de ligne__\\
Deux solutions:
  * Dans les préférences d'Eclipse (rappel: Window –> Preferences...) aller sur **General –> Editors –> Text Editors** et cochez **Show line numbers**, puis validez.
  * Dans l'éditeur, effectuez un clic avec le bouton droit de la souris sur la barre vertical grise/orangée à gauche de la zone d'édition et cochez **Show Line Numbers** dans ce menu contextuel.

==== Plugins & Co ====

**[[eclipse_php_xdebug|Eclipse & PHP XDebug]]**\\
Configuration et utilisation de PHP-XDebug avec Eclipse (PDT)

**[[eclipse_papyrus| Eclypse Papyrus]]**\\
Création de diagrammes UML [[http://www.eclipse.org/papyrus/]]
==== Liens ====
Nous vous recommandons de visiter des sites plus appropriés à vos besoins (fonctionnement d'Eclipse, recherche de greffons, distributions personnalisées, ...). Vous pouvez commencer par ceux que nous vous proposons ci-dessous.
  * [[http://www.eclipse.org/|Site Officiel (en)]]
  * [[http://www.eclipse.org/documentation/|Documentation Officielle (en)]]
  * [[http://www.eclipsetotale.com/|EclipseTotale.com (fr)]]
  * [[http://easyeclipse.org/|EasyEclipse (en)]] des distributions Eclipse prêtes à l'emploi suivant vos besoins.
  * [[https://marketplace.eclipse.org/|Eclipse Market Place (en)]] pour trouver facilement le greffon qu'il vous faut et l'installer par un simple Drag & Drop.
  * [[wpfr>Eclipse_(logiciel)|Wikipedia (fr)]]
  * [[http://eclipse.developpez.com/cours/|Cours sur developpez.com (fr)]]
N'hésitez pas à rajouter vos liens.

===== Voir aussi =====
  * [[LiClipse]]
----

//Contributeurs : Basé sur le [[http://placelibre.ath.cx/keyes/index.php/2006/09/05/107-eclipse-pour-le-developpement-web-php-et-python-sous-dapper|blogue de Keyes]], avec les contributions de [[utilisateurs:P-Hell]], de [[utilisateurs:Ronan]] et d'ajouts mineurs de la part de [[utilisateurs:martin.sam]]. Refonte complète par [[utilisateurs:yoboy|YoBoY]]. Contribution de [[utilisateurs:quent57|quent57]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : Q D D S A Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported