Pour obtenir une copie de travail vous devez faire une extraction à partir d'un référentiel.
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 → , qui affiche la boîte de dialogue suivante :
Si vous entrez un nom de dossier qui n'existe pas encore, alors un répertoire sera créé avec ce nom.
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.
Si vous n'extrayez qu'une portion de l'arboresence (en décochant la case récursivement), vous pouvez lister d'autres sous répertoires via l'explorateur de référentiel (la section intitulée « l'explorateur de référentiel ») ou la fenêtre de vérification des modifications (la section intitulée « Statut local et distant »).
Dans l'explorateur de référentiel, faites un click droit sur le répertoire extrait, puis utilisez → pour afficher l'explorateur de référentiel. Trouvez le sous répertoire que vous souhaitez ajouter à votre version de travail, et utilisez → . Ce menu ne sera visible que si les éléments sélectionnés n'existent pas dans votre copie de travail, et que l'élément parent y est.
Dans la fenêtre de vérification des modifications, cliquez d'abord sur le bouton . La fenêtre affichera tous les fichiers et répertoires du référentiel mais que vous n'avez pas exporté comme étant ajouté à distance. Faites un Click droit sur le(s) répertoire(s) que vous voudriez ajouter à votre CdT, puis utilisez → .
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 :
Extrait le répertoire parent avec la profondeur « Juste cet élément » Vous avez maintenant un répertoire de haut niveau vide.
Sélectionnez le nouveau répertoire et utilisez la commande → pour voir le contenu du référentiel.
Faites un click droit sur
Project03et → . Laissez les paramètres par défaut et cliquez sur . Ce répertoire est a présent complet.Répéter le même processus pour
Project25..Allez dans
Project76/SubProjet faites de même. Cette fois ci, notez que le répertoireProject76est 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
Une fois que vous avez extrait une copie de travail à une certaine profondeur vous pouvez modifier cette profondeur à postériori en utilisant → .
Utilisant un serveur ancien
Les serveurs de version inférieure à 1.5 ne supportent pas la notion de profondeur de la copie de travail, ils n'interprêtent donc pas efficacement les requêtes l'utilisant. Les commande fonctionneront, mais un vieux serveur retournera toutes les données, laissant le client filtrer ce qui n'est pas requis, ce qui augmentera le traffic sur le réseau. Si possible, vous devriez mettre à jour votre serveur.
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 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 → instead of → . 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 référentiel 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.