Utilisation de SVN

Sommaire

1. Suivi de document
1.1. A quoi ça sert?
1.2. Adresse du serveur
1.3. Créer un mirroir local du serveur
1.4. Récuperer la dernière version du serveur
1.5. Ajouter un ou plusieurs fichiers au projet

1.Suivi de document

Version actuelle:V 1.00
Nom du document:SVN_facile
Diffusée le: 13/03/2010

Version du	Numéro de version	Objet	Auteur	Etat
14/03/2010	1.1	Précise qu'il faut bien synchroniser avant de commiter	Pierre VITTET	En cours
13/03/2010	1.0	Création de document pour expliquer svn	Pierre VITTET	En cours

1.1.A quoi ça sert?

L'objectif est d'avoir un serveuruniquequi contient les sources du projet. Cela permet de s'assurer que l'on travaille tous sur la même version et que chacun ne développement pas un truc redondant ou incompatible de son coté. De plus l'historique des fichiers (et de leur version) sur le serveur est conservé.

1.2.Adresse du serveur

Pour notre projet de framework l'adresse à utiliser par le client svn est:http://svn2.assembla.com/svn/FrameworkTransport.

1.3.Créer un mirroir local du serveur

C'est la première opération à faire lorsque l'on veut récuperer un projet hébergé sur un svn. C'est un import total de la dernière révision du serveur.

En ligne de commande on utilise la commandesvn checkoutde la manière suivante:

cd mon_repertoire

svn checkout http://svn2.assembla.com/svn/FrameworkTransport

Un compte utilisateur et un mot de passe pourrontêtre demandé. On récupère ainsi la totalité du projet dans le répertoire. Normalement on n'a besoin de faire cette commande qu'une fois.

1.4.Récuperer la dernière version du serveur

Avant de commencer à travailler sur les sources, il faut s'assurer d'avoir la dernière version du projet. Pour cela on utilise la commandesvn update. Cette commande compare la version actuel du projet sur le serveur et en local pour savoir si il y a une mise à jour à faire et sur quels fichiers elle doitêtre faîtes. Si il y a un risque de conflit (par exemple on à modifié un fichier local puis on fait un un update, le logiciel nous avertie et permet de choisir le fichier que l'on souhaite conserver).

Voila un exemple d'utilisation

cd mon_repertoire

svn update

Il n'est pas nécéssaire de rajouter l'adresse du dépot. SVN utilise le répertoire pour conserver celle ci ainsi que le compte utilisateur/mdp.

1.5.Ajouter un ou plusieurs fichiers au projet

Imaginons que je souhaite créer un nouveau fichiers (ou dossier) qui soit rattaché au projet. Pour l'ajouter au projet on utilise la commande add:

$ svn add exemple_boost/

Ici, en ajoutant un répertoire, j'ajoute récursivement tous les fichiers contenus dedans.

!!!

Cela les ajoute au projet local, pour les ajouter au serveur svn, il faut ensuite faire un svn commit que l'on a voir dans la section suivante

Mettre à jour le serveur distant

Pour enregistrer les modifications locales dans le dépôt distant, on utilise la commandesvn commit. Celle ci crée une nouvelle révision (la précédente est conservé en historique) du projet. Le commit se fait sur l'ensemble des fichiers du projet que l'on a modifiés si l'on ne précise pas de fichiers/dossiers particulier:

svn commit -m "Mise en place d'un premier fichier d'exemple pour boost"

Si l'on souhaite ne mettre un jour que quelques fichiers:

svn commit -m "Mise à jour de fichier1 et fichier2" rep/fichier1 repfichier2

!!!

1) Il faut toujours s'assurer de disposer de la dernière révision grâce à un udapte avant d'effectuer un commit

2) Le logiciel svn en ligne de commande impose par défaut d'utiliser l'option -m pour passer une description sur la mise à jour qui est faite.

Conclusion

C'est très pratique et sécurisant, par contre faite attention à garder un dépot local propre(ex: je modifie des fichiers sans les commiter, je fais des commit sans avoir fait d'update....).

Davantage d'info et commandes: http://fr.wikipedia.org/wiki/Subversion_%28logiciel%29 , http://www.tuteurs.ens.fr/logiciels/subversion/