I. Introduction


Subversion (SVN) est l'évolution de Concurrent Versions System (CVS), ses avantages font que son utilisation commence prendre sérieusement le pas sur son prédécesseur.
On trouve de plus en plus de modules parmi les EDI pour se connecter à cette nouvelle référence en matière de gestion de projet.
Netbeans ne fait pas exeption à la règle, bien que son intégration fut plus tardive que dans Eclipse, toutes les commandes fondamentales de Subversion sont supportées parle module.

II. Installation

II.1. NetBeans


Il vous faut une version de Netbeans, 5.5.

Télécharger : www.netbeans.orgSite officiel Netbeans

Suivez les consignes pour l'installation.


Une fois le logiciel installé, accédez au menu de mise à jour des modules :

Image non disponible

Sélectionnez "NetBeans Update Center" :

Image non disponible

Allez chercher le module SubVersion.
D'autres modules seront ajoutés à la liste car ils sont nécessaires à son bon fonctionnement.

Image non disponible

"Lisez" et acceptez les licences :

Image non disponible

Et validez!

Image non disponible

Rien de plus ici, c'est un des avantages de NetBeans.

En savoir plus sur les modules NetBeans :
Article de Vincent Brabant

II.2. SubVersion


Il vous faut une version de Subversion, 1.3 ou plus.

Télécharger : http://subversion.tigris.org

Suivez les consignes pour l'installation.


Pour plus de détail sur SVN :
Installer Subversion sous Windows par Eric Reboisson
Installer et utiliser Subversion sous Windows par hugo123


Erreurs Connues :

Image non disponible

Si vous rencontrez cette erreur, c'est sans doute car Subversion n'est pas installé.

Si celui-ci est bien installé c'est que la variable d'environnement "PATH" de votre système n'a pas été correctement complétée. Allez la vérifier et au besoin ajoutez le chemin vers les exécutables de Subversion.

Si cela ne marche toujours pas, modifiez le chemin et ajoutez le paramètre suivant à l'exécution de NetBeans:

 
Sélectionnez

-J-Dsubversion.path=/path/to/subversion/bin

III. Importer


Pour mettre à disposition notre projet il faut l'envoyer sur le serveur SVN.
la procédure ressemble à un envoi en FTP avec quelques compléments d'informations.
La première chose dont on aura besoin pour notre projet et donc la commande d'import.


Accéder au menu d'import SVN :

Image non disponible

Préciser les paramètres Adresse, Utilisateur et Mot de passe :

Image non disponible

Faites attention au choix du répertoire afin de garder l'arborescence d'usage pour les projets SVN :

Image non disponible

Choisissez les fichiers à envoyer. Dans le cas des projets de développement, évitez d'inclure le/les dossier(s) contenant les logiciels compilés.

Image non disponible

Un point noir du module est celui-ci :
vous ne pouvez pas voir l'état d'avancement de l'import.

Image non disponible

Cette étape est plus ou moins longue selon votre connexion et le volume de fichiers.
Attendez que l'import soit terminé.

Image non disponible

IV. Checkout


Vos collaborateurs vont maintenant pouvoir récupérer le projet sur le serveur.
Pour le récupérer on va utiliser la commande Checkout de Subversion.


Accéder au menu Checkout SVN :

Image non disponible

Préciser les paramètres Adresse, Utilisateur et Mot de passe :

Image non disponible

Préciser le dossier à récupérer, le dossier où il sera importé et si besoin la version que vous désirez :

Image non disponible

Même point noir que pour l'import, on ne sait pas l'avancement de la récupération.
Attendez que tout soit téléchargé.

V. Mise à jour


Une fois que vous avez fini d'éditer vos pages de codes, vous pouvez envoyez votre travail en faisant un "Commit".
Ne faites pas des commit fichier par fichier si vous en avez modifié plusieurs. Effectuer la validation au niveau de la racine commune, cela permettra d'avoir un seul changement de version pour tous vos changements, et non pas une par fichier.

Image non disponible

Il est important de préciser au minimum les modifications que vous avez faites dans le message. Cela afin de pouvoir remonter à une version antérieure en cas de problème.

Image non disponible

Validez et attendez la fin de la mise à jour.

VI. Les Différences


Avec l'avancement du projet il viendra des moments où il sera nécéssaire de comparer différentes versions,
- aussi bien pour corriger des conflits,
- que pour récupérer une version antérieur.

VI.1. Vue d'ensemble


Il peut être intéressant de savoir ce qui a été modifié entre la version du serveur et la vôtre.

Pour accéder à la liste des modifications sélectionnez le dossier à comparer et faites un clic droit.

Image non disponible


Après quelques secondes on obtient la liste des différences :

Image non disponible

VI.2. Détail sur les sources


Plutôt que d'avoir une vue générale des fichiers qui ont changé ou afin de résoudre des conflits entre les versions, on utilise le menu "diff".

Image non disponible


Une double page va permettre de comparer les différences de code :

Image non disponible

1 Permet de confronter la dernière version du code source du serveur en comparaison avec votre version.
2 Permet de confronter le code avant modification et votre version.
3 Permet de confronter la nouvelle version du code source du serveur et votre version.

A Choisir la classe à visionner.
B Faire une mise à jour des sources.
C Faire un "Commit" de votre version.

VII. Liens



NetBeans
Site officiel Netbeans : www.netbeans.org
Section française de Netbeans : http://fr.netbeans.org


SubVersion
Site officiel Subversion : http://subversion.tigris.org
WIKI Subversion : Wiki

Installer Subversion sous Windows par Eric Reboisson
Installer et utiliser Subversion sous Windows par hugo123


Liens Developpez.com
Page NetBeans Developpez.com : http://netbeans.developpez.com
Forum NetBeans Developpez.com : Forum
Définition Subversion : SubVersion

VIII. Remerciements

Compléments d'informations :
vbrabant : Responsable NetBeans, Developpez.com
Ricky81 : Responsable Java, Developpez.com
Relecture orthographique :
Zedros : Rédacteur, Developpez.com