Wednesday, 17 January 2018

Utilisation de SVN

From Image

Jump to: navigation, search

Introduction

Subversion (en abrégé svn) est un système de gestion de versions, distribué sous licence Apache et BSD. [1] C'est un logiciel client-serveur qui facilite grandement le travail communautaire ainsi que la gestion de backups temporels.

Utilisation pour le cours PROJ-H-503: Pratique de la programmation

Serveur

Le serveur est hébergé par le laboratoire Lisa et sera le seul serveur à être utilisé pour ce cours.
L'adresse ainsi que les identifiants et mots de passe seront communiqués une fois que les groupes seront formés et inscrits sur cette page.

Client

Remarques générales

  • Comme SVN réalise des backups temporels (et qu'il est donc possible de revenir à une version précédente), il n'est jamais mauvais de faire un commit.
  • Avant de commencer à travailler, faire toujours un update pour être sûr de travailler sur la bonne version.
  • N'hésitez pas à contacter l'assistant en cas de problème.

Windows

TortoiseSVN

Il existe plusieurs logiciels de type client SVN sous Windows. Un de plus utilisés est TortoiseSVN. Une fois installée, il s'intègre à l'explorateur Windows.

Créer un nouveau répertoire sur le serveur
  • Faire un clic-droit dans n'importe quel répertoire.
  • Choisir TortoiseSVN -> Repo-browser.
  • Indiquer l'adresse du serveur.
  • Dans la nouvelle fenêtre, faire un clic-droit sur la racine (svn:...) et choisir Create Folder.

Vous pouvez créer autant de répertoire que nécessaire (généralement 1 par projet).

Mettre à jour les fichiers sur le serveur
  • Créer un répertoire sur le disque dur qui contiendra les fichiers du projet.
  • Faire un clic-droit dans ce répertoire et choisir SVN Checkout
  • Dans URL of repository, indiquer l'adresse du serveur (en y ajoutant le répertoire créer à l'étape précédente) et laisser tout le reste avec les valeurs par défaut. Cliquer sur OK.
  • Créer maintenant les fichiers normalement (.cpp, .java...)
  • Dans l'explorateur Windows, faire un clic-droit sur ces nouveaux fichiers et choisir Add dans le menu TortoiseSVN. Un petit "plus" bleu apparait sur l'icône de chaque fichier qui va être envoyé au serveur.
  • Pour envoyer les fichiers sur le serveur, faire un clic-droit dans le répertoire et choisir SVN Commit. Les fichiers sont envoyés sur le serveur après confirmation par l'utilisateur. Il est conseillé d'ajouter un commentaire à chaque commit. A chaque fois qu'un fichier local diffère de celui du serveur, un petit point d'exclamation rouge est superposé à l'icône du fichier.
Récupérer la dernière version sur le serveur
  • Après avoir lié votre répertoire local avec celui du serveur (voir SVN Checkout dans la section précédente), faire un SVN Update. Il est possible de récupérer une version précédente (voir bouton Show log).
Remarques sur TortoiseSVN
  • Il s'agit ici des fonctions de base de TortoiseSVN. Les autres fonctions peuvent être découvertes par soi-même et/ou consultant le manuel.
  • S'il est nécessaire d'exporter un répertoire et de le désolidariser du serveur svn, il faut déplacer l'icône du répertoire avec un clic-droit et choisir l'option SVN Export Here.
  • Il peut être utile de faire un Clean Up de temps en temps si des problèmes sont rencontrés.

EDI

Il est possible de directement intégrer SVN dans l'EDI (Eclipse, Qt Creator...). Voir la documentation de l'EDI utilisé.

Références

  1. Subversion sur Wikipedia