Periodically, you should ensure that changes done by others get incorporated in your local working copy. The process of getting changes from the server to your local copy is known as updating. Updating may be done on single files, a set of selected files, or recursively on entire directory hierarchies. To update, select the files and/or directories you want, right click and select → in the explorer context menu. A window will pop up displaying the progress of the update as it runs. Changes done by others will be merged into your files, keeping any changes you may have done to the same files. The repository is not affected by an update.
La boîte de dialogue de progression utilise un code couleur pour mettre en évidence les diverses actions de la mise à jour
- Pourpre
Nouvel élément ajouté à votre CdT.
- Rouge foncé
Élément redondant supprimé de votre CdT, ou élément manquant remplacé dans votre CdT.
- Vert
Changements du référentiel fusionnés avec vos changements locaux avec succès.
- Rouge clair
Changements du référentiel fusionnés avec des changements locaux, aboutissant à des conflits que vous devez résoudre.
- Noir
Élément inchangé dans votre CdT mis à jour par une version plus récente du référentiel.
C'est la combinaison de couleur par défaut, mais vous pouvez personnaliser ces couleurs en utilisant la boîte de dialogue de configuration. Lisez la section intitulée « Configuration des couleurs de TortoiseSVN » pour plus d'informations.
Si vous avez des conflits pendant une mise à jour (cela peut arriver si d'autres ont changé les mêmes lignes dans le même fichier que vous et que ces changements ne correspondent pas) alors la boîte de dialogue montre ces conflits en rouge. Vous pouvez double-cliquer sur ces lignes afin démarrer l'outil externe de fusion pour résoudre les conflits.
Quand la mise à jour est terminée, la boîte de dialogue de progression affiche sous la liste des fichiers un résumé du nombre d'éléments mis à jour, ajoutés, supprimés, en conflit, etc. Ce résumé d'information peut être copié dans le presse-papiers en utilisant Ctrl+C.
The standard Update command has no options and just updates your working copy to the HEAD revision of the repository, which is the most common use case. If you want more control over the update process, you should use → instead. This allows you to update your working copy to a specific revision, not only to the most recent one. Suppose your working copy is at revision 100, but you want it to reflect the state which it had in revision 50 - then simply update to revision 50. In the same dialog you can also choose the depth at which to update the current folder. The terms used are described in la section intitulée « Profondeur d'extraction ». The default depth is Working copy, which preserves the existing depth setting. You can also choose whether to ignore any external projects in the update (i.e. projects referenced using svn:externals).
Attention
If you update a file or folder to a specific revision, you should not make changes to those files. You will get « out of date » error messages when you try to commit them! If you want to undo changes to a file and start afresh from an earlier revision, you can rollback to a previous revision from the revision log dialog. Take a look at la section intitulée « Annuler des révisions dans le référentiel » for further instructions, and alternative methods.
can occasionally be useful to see what your project looked like at some earlier point in its history. But in general, updating individual files to an earlier revision is not a good idea as it leaves your working copy in an inconsistent state. If the file you are updating has changed name, you may even find that the file just disappears from your working copy because no file of that name existed in the earlier revision. You should also note that the item will show a normal green overlay, so it is indistinguishable from files which are up-to-date.
Si vous voulez simplement une copie locale d'une version ancienne d'un fichier, il est mieux d'utiliser la commande → depuis la fenêtre de commentaire de ce fichier.
Plusieurs fichiers / répertoires
Si vous choisissez plusieurs fichiers et plusieurs dossiers dans l'explorateur et sélectionnez ensuite , tous ces fichiers/dossiers sont mis à jour un par un. TortoiseSVN s'assure que tous les fichiers/dossiers qui sont du même référentiel sont mis à jour à la même révision exacte ! Même si une autre livraison se produit entre ces mises à jour.
Le fichier local existe déjà
Parfois quand vous essayez de mettre à jour, la mise à jour échoue avec un message disant qu'il y a déjà un fichier local du même nom. Cela arrive typiquement quand Subversion essaye d'extraire un fichier nouvellement versionné et constate qu'un fichier non versionné du même nom existe déjà dans votre dossier de travail. Subversion n'écrasera jamais un fichier non versionné - il pourrait contenir quelque chose sur lequel vous travaillez, qui a par hasard le même nom de fichier qu'un autre développeur a utilisé pour son fichier nouvellement livré.
Si vous obtenez ce message d'erreur, la solution est simplement de renommer le fichier local non versionné. Une fois la mise à jour terminée, vous pouvez vérifier si le fichier renommé est toujours nécessaire.
Si vous continuez à obtenir des messages d'erreur, utilisez → pour lister tous les fichiers à problème à la place. De cette façon vous pouvez tous les traiter d'un coup.