Extraire une copie de travail

Pour obtenir une copie de travail vous devez faire une extraction à partir d'un dépôt.

Choisissez un répertoire dans l'explorateur Windows où vous voulez placer votre copie de travail. Faites un clic droit pour afficher le menu contextuel et choisissez la commande TortoiseSVNExtraire..., qui affiche la boîte de dialogue suivante :

Figure 4.7. La boîte de dialogue Extraire

La boîte de dialogue Extraire


Si vous entrez un nom de dossier qui n'existe pas, alors il sera créé.

Important

Dans les réglages par défaut, la commande récupérer n'est pas située dans le sous-menu TortoiseSVN mais est affichée dans le menu tout en haut de l'explorateur. Les commandes de TortoiseSVN qui ne sont pas dans le sous-menu ont le terme SVN literal> pr SVN Rguimenuitem> menuchoice>

Profondeur d'extraction

Vous pouvez choisir la profondeur que vous voulez extraire, ce qui vous permet de spécifier la profondeur de récursion dans les sous répertoires. Si vous voulez juste une partie d'une grosse arborescence , Vous pouvez n'extraire que le répertoire de plus haut niveau, et mettre à jour les sous répertoires petit à petit.

Totalement récursive

Extraire l'arborescence complète, incluant récursivement tous les sous répertoires.

Descendants directs, y compris les répertoires

Extrait le répertoire spécificé, tous les fichiers et sous répertoires compris, mais ne remplit pas les sous répertoires.

Juste les fichiers

Extrait le répertoire spécifie, y compris les fichiers mais n'extrait aucune sous répertoire.

Uniquement cet élément.

Extraire juste le répertoire. Ne pas le remplir avec les répertoires et fichiers enfants.

Copie de travail

Se souvenir de la profondeur dans la version de travail. Cette option n'est pas utilisée dans la fenêtre d'extraction, mais c'est la valeur qui sera utilisée par éfaut pour toutes les autres fenêtres ayant cette option.

Exclure

Utilisé pour réduire la profondeur de la copie de travail déjà rempli. Cette option n'est disponible que dans la fenêtre Mettre à jour à la révision.

Pour facilement sélectionner uniquement les éléments que vous voulez pour le checkout et forcer la copie de travail à garder uniquement ces éléments, cliquez sur le bouton Choisir les éléments ... . Ceci ouvre une nouvelle boîte de dialogue où vous pouvez vérifier tous les éléments que vous voulez dans votre copie de travail et décochez toutes les éléments que vous ne voulez pas. La copie de travail qui en résulte est alors connu comme un sparse checkout . Une mise à jour d'une telle copie de travail ne récupérera pas les fichiers et dossiers manquants, mais mettra à jour seulement ceux que vous avez déjà dans votre copie de travail.

If you check out a sparse working copy (i.e., by choosing something other than fully recursive for the checkout depth), you can easily add or remove sub-folders later using one of the following methods.

Sparse Update using Update to Revision

Right click on the checked out folder, then use TortoiseSVNUpdate to Revision and select Choose items.... This opens the same dialog that was available in the original checkout and allows you to select or deselect items to include in the checkout. This method is very flexible but can be slow as every item in the folder is updated individually.

Sparse Update using Repo Browser

Right click on the checked out folder, then use TortoiseSVNRepo-Browser to bring up the repository browser. Find the sub-folder you would like to add to your working copy, then use Context MenuUpdate item to revision....

Sparse Update using Check for Modifications

In the check for modifications dialog, first shift click on the button Check repository. The dialog will show all the files and folders which are in the repository but which you have not checked out as remotely added. Right click on the folder(s) you would like to add to your working copy, then use Context menuUpdate.

Cette fonctionnalité est très utile lorsque vous ne voulez récupérer qu'une partie d'une grosse arborescence, tout en gardant le côté pratique d'une mise à jour d'un seul élément. Supposez que vous avez une grosse arborescence avec des sous répertoires nommés Projet01 à Projet99, et que vous ne vouliez récupérer que Projet03, Projet25 et Projet76/SousProj. Suivez ces étapes :

  1. Extrait le répertoire parent avec la profondeur « Juste cet élément » Vous avez maintenant un répertoire de haut niveau vide.

  2. Sélectionnez le nouveau répertoire et utilisez la commande TortoiseSVNExplorateur de dépôt pour voir le contenu du dépôt.

  3. Faites un click droit sur Project03 et Menu contextuelMettre à jour à la révision.... Laissez les paramètres par défaut et cliquez sur OK. Ce répertoire est a présent complet.

    Répéter le même processus pour Project25..

  4. Allez dans Project76/SubProj et faites de même. Cette fois ci, notez que le répertoire Project76 est vide excepté SubProj, lequel est complètement rempli. Subversion a créé pour vous les répertoires intermédiaires sans les remplir.

Modifier la profondeur de la copie de travail

Once you have checked out a working copy to a particular depth you can change that depth later to get more or less content using Context menuUpdate item to revision.... In that dialog, be sure to check the Make depth sticky checkbox.

Utilisant un serveur ancien

Pre-1.5 servers do not understand the working copy depth request, so they cannot always deal with requests efficiently. The command will still work, but an older server may send all the data, leaving the client to filter out what is not required, which may mean a lot of network traffic. If possible you should upgrade your server to at least 1.5.

Si le projet contient des références à des projets externes que vous ne voulez pas extraire en même temps, utilisez la case à cocher Omettre les références externes .

Important

If Omit externals is checked, or if you wish to increase the depth value, you will have to perform updates to your working copy using TortoiseSVNUpdate to Revision... instead of TortoiseSVNUpdate. The standard update will include all externals and keep the existing depth.

Il est recommandé de n'extraire que la partie trunk de l'arborescence de répertoire, ou un de ses sous répertoires. Si vous spécifiez le chemin parent de l'arborescence de répertoire dans l'URL alors vous pourriez vous retrouver avec un disque dur rempli puisque vous obtiendrez une copie de l'arborescence du dépôt en entier incluant chaque branche et chaque étiquette de votre projet !

Exporter

Parfois vous pouvez avoir envie de créer une copie locale sans aucun de ces répertoires .svn, pour créer un paquet zippé de vos sources par exemple. Lisez la section intitulée « Exporter une copie de travail Subversion » pour savoir comment le faire.