Configurer et utiliser EGit, une extension Git pour Eclipse

EGit est une extension pour Eclipse qui permet d’utiliser Git. Pour rappel, Git est un logiciel de gestion de versions qui permet à chaque utilisateur d’avoir une copie complète et l’historique d’un dépôt localement et de le distribuer.

Voici un tutoriel qui explique comment installer EGit afin d’importer un projet depuis un dépôt distant, faire un commit et distribuer le projet. J’utiliserai pour cet exemple le service web GitHub.

1- INSTALLATION

Il faut premièrement installer Mylyn qui est nécessaire pour Egit. Lancez Eclipse puis rendez vous dans la fenêtre d’ajout d’extensions (help > Install New Software), utilisez http://download.eclipse.org/mylyn/releases/latest comme adresse et installez MyLyn Features.

Vous pouvez maintenant installer Egit, utilisez http://download.eclipse.org/egit/updates comme adresse et installez Eclipse Git Team Provider.

EDIT

Il n'est pas nécessaire d'installer MyLyn dans le cas d'une
utilisation basique de EGit. Installez simplement EGit en utilisant
http://download.eclipse.org/egit/updates comme adresse
et installez uniquement Eclipse EGit.  

SECOND EDIT

Si vous obtenez l'erreur suivante: 
"Missing requirement: EGit Import Support 2.0.0.201206130900-r 
(org.eclipse.egit.import.feature.group 2.0.0.201206130900-r) 
requires 'org.eclipse.team.core 3.6.100' but it could not be found"

Essayez d'installer une autre version d'Egit. 
Pour voir la liste des autres versions, rendez vous sur cette page:
http://wiki.eclipse.org/EGit/FAQ#Where_can_I_find_older_releases_of_EGit.3F

Pour voir la liste des versions d'Egit compatibles avec votre version d'Eclipse:
http://wiki.eclipse.org/EGit/FAQ#What_versions_of_Eclipse_does_EGit_target.3F

Pour connaître la version d'Eclipse que vous utilisez rendez-vous ici

2 – IMPORTER UN PROJET DEPUIS GITHUB

Avant toute chose, il faut générer une clef SSH afin de vous
authentifier auprès de Github. Pour cela, rendez vous sur
la page suivante: https://help.github.com/articles/generating-ssh-keys

Dans Eclipse, cliquez sur File > Import. Dans la fenêtre qui s’ouvre choisissez Git > Projects from Git , cliquez sur suivant , sélectionnez URI et cliquez sur suivant. Récupérez l’adresse SSH de votre projet sur GitHub  (ou l’adresse Git si vous n’avez qu’un accès en lecture seule)  et remplissez la fenêtre comme dans l’exemple suivant:

Cliquez ensuite sur suivant pour sélectionner les branches souhaitées et à nouveau sur suivant pour sélectionner la destination du projet:

Cliquez à nouveau sur suivant et sélectionnez Use the new project wizard afin de créer un projet avec comme dossier source le dossier précédemment utilisé. Vous devriez maintenant voir le projet importé dans Eclipse.

 3 – FAIRE UN COMMIT

Voici comment faire un commit sur votre dépôt local:

Faites un clique droit sur le dossier à commit, sélectionnez Team > Commit . Dans la fenêtre qui s’ouvre tapez votre message et sélectionnez les fichiers à commit.

 4 – DISTRIBUER LE PROJET

Nous allons voir ici comment envoyer les modifications de votre dernier commit sur GitHub:

Faites un clique droit sur votre projet et sélectionnez Team > Remote > Push. Utilisez le dépôt configuré par défaut et cliquez sur finish. Les modifications ont maintenant été envoyés sur GitHub.

N’hésitez pas à répondre à cet article si vous rencontrez des difficultés 😉