TortoiseSVN

De EduTech Wiki
Aller à : navigation, rechercher

TortoiseSVN est un client pour Subversion

1 Installation

Rendez-vous sur cette page : [1] et téléchargez la version la plus récente. Notez que le logiciel est aussi disponible dans une version localisée (traduite). La description des commandes ci-dessous sera faites selon leur appellation anglophone.

Installez ensuite le fichier téléchargé, il est nécessaire de redémarrer Windows après l'installation.

2 Utilisation

Menu contextuel

TortoiseSVN se lance depuis l'interface de l'Explorateur de fichiers de Windows. Il s'agit de faire un clic droit sur un fichier ou un répertoire pour avoir les commandes disponibles depuis le menu contextuel.

3 Distinction importante

Il est important de noter la différence entre les commandes disponibles pour un répertoire de fichiers et un fichier. Certaines commandes telles Création d'un dépôt ne sont disponibles que pour un répertoire.

3.1 Quelques définitions

Dépôt (ou repository)
Il s'agit d'un serveur de fichiers, chacune des versions de chaque fichier y sera enregistré.
Il est toutefois plus pratique de les considérer comme le répertoire principal des fichiers du projet, dans sa globalité.
Copie primaire
C'est la seule et unique version des fichiers présents sur le dépôt (repository).
C'est la base de tout !C'est à partir de cette copie que chacun pourra avoir une mise à jour du travail des autres.
Elle n'est présente que sur le serveur de fichiers.
Copie de travail
Cette copie est possédé par tous ceux qui veulent participer au développement d'un projet.
Cette copie existe sur l'ordinateur de tous les programmeurs actifs.
La tâche leur incombe de la mettre à jour avant de travailler dessus.
Copie de bêta-testeur
C'est une copie des projets en évolution que certains projets mettent à disposition de tout un chacun. Cette copie ne pourra qu'être téléchargé sur l'ordinateur personnel et les modifications apportés aux projets ne pourront être mises à jour sur la copie primaire.


4 Description des commandes disponibles

Les commandes les plus importantes sont marquée en vert
Checkout...
Récupérer le contenu d'un dépôt de fichiers particuliers.
S'emploie sur un répertoire.
A utiliser la première fois que vous voulez importer le contenu d'un dépôt de fichiers.
Utilisation : clic-droit sur le répertoire dans lequel vous désirez importer le contenu du dépôt.
Update
Mettre à jour sa version de travail avec la version primaire
À utiliser lors de projet de groupe avant de faire toute modification !
Utilisation : clic-droit sur le répertoire ou le fichier à mettre à jour.
Commit...
Mettre à jour la version primaire avec les modifications apportées
À utiliser après chaque période de travail ou pour créer un point de sauvegarde des fichiers.
Utilisation : clic-droit sur le répertoire ou le(s) fichiers(s) modifié(s).
NB. Les modifications peuvent être des changements à l'intérieur de fichiers et des modifications de l'arborescence du projet (ajout, suppression de fichiers, etc.)
  • Diff
  • Show log
  • Check for modifications
  • Revision graph
  • Repo-browser
  • Edit conflicts
  • Resolved...
  • Update to revision...
Rename...
Renommer un fichier ou un répertoireSubversion
À utiliser lorsqu'on veut modifier l'arborescence. Il s'agit d'une opération particulière qui permet au dépôt primaire de conserver un lien entre l'ancien nom de fichier et le nouveau.
Delete
À utiliser lors de la suppression définitive de fichiers ou de répertoire. Sans cela, les fichiers reviendront dans vos répertoire après une mise à jour depuis la copie primaire.
Notez que les fichiers supprimés seront toujours accessibles depuis la copie primaire si vous remontez l'historique des versions.
  • Revert...
  • Clean up
  • Get lock...
  • Branch/tag...
  • Switch...Subversion
  • Merge...
  • Export...
  • Relocate...
Create repository here...
Créer un dépôt primaire depuis ce répertoire.
Vous devez disposer d'un espace SVN pour créer un espace.
Utilisation : clic-droit sur le répertoire que vous voulez lier avec une copie primaire.
Notez que votre répertoire deviendra une copie de travail et qu'il possèdera une copie primaire à l'adresse que vous aurez spécifié.
Add...Subversion
Pour ajouter des fichiers ou répertoire à la copie primaire.
Utilisation : à mesure que votre projet grossit, vous devez spécifier quels fichiers seront rajoutés à la copie primaire.
Notez que vous devez faire un Commit à la suite pour enregistrer les fichiers sur la copie primaire.
  • Import...
  • Add to ignore list
  • Create patch...
  • Apply patch...
  • Properties
  • Help
  • Settings
  • About