Ajouter des fichiers au serveur

Ajouter un fichier au contrôle de version est souvent automatique lorsque vous utilisez l'Explorateur de solutions et que votre projet est sous contrôle de version. Toutefois, dans certains cas, vous devez prendre des mesures supplémentaires pour ajouter le projet au contrôle de version.

Conseil

Avant d'ajouter des fichiers au contrôle de version, vous devez d'abord installer l'espace de travail sur votre ordinateur de développement.

Que voulez-vous faire ?

• Créer un projet de code et une solution sous contrôle de version

• Définir une solution existante et les projets de code sous contrôle de version

• Ajouter un ou plusieurs fichiers au contrôle de version

• Utiliser des tiers binaires que votre code ne génère pas

• Personnaliser les fichiers à ignorer par le contrôle de version

• Travailler depuis l'invite de commandes

Créer un projet de code et une solution sous contrôle de version

Vous pouvez simultanément créer un projet d'équipe et l'ajouter au contrôle de version afin que vous et votre équipe puissiez immédiatement apprécier tous les avantages du contrôle de version dès la première ligne de code que vous écrivez.

1. Dans Visual Studio, si vous ne l'avez pas déjà fait, connectez-vous au projet d'équipe.

2. Choisissez Fichier, Nouveau, Projet (raccourci : Ctrl + Maj + N).

   La boîte de dialogue Nouveau projet s'affiche.

3. Sélectionnez le type de projet de code que vous souhaitez créer.

4. Dans la zone Nom, spécifiez le nom du projet de code.

5. Si la liste Solution s'affiche, vérifiez que Créer une nouvelle solution est sélectionné.

6. Dans la liste Emplacement, spécifiez le chemin d'accès au bon dossier de travail local (tel que c:\code\SiteApp\Main\) dans l'espace de travail que vous avez créé lorsque vous avez configuré votre ordinateur de développement.

   Vérifiez que les cases à cocher Créer le répertoire pour la solution et Ajouter au contrôle de code source sont sélectionnées.

7. Sélectionnez OK pour créer le projet de code que vous pouvez ensuite afficher dans l'Explorateur de solutions (raccourci : Ctrl + Alt + L).

   

8. Dans l'Explorateur de solutions, ouvrez le menu contextuel de la solution que vous avez créée ou modifiée, puis choisissez Archiver pour soumettre vos modifications en attente.

Définir une solution existante et les projets de code sous contrôle de version

Pour ajouter une solution existante dans le contrôle de version, déplacez tous les fichiers de la solution dans votre espace de travail, puis ajoutez-les.

Notes

Évitez d'utiliser la boîte de dialogue Ajouter la solution au contrôle de code source pour télécharger votre solution dans le contrôle de version.Utilisez plutôt les procédures suivantes.

1. Dans Visual Studio, si vous ne l'avez pas déjà fait, connectez-vous au projet d'équipe.

2. Choisissez Afficher, Autres fenêtres, Explorateur du contrôle de code source.

3. Dans l'Explorateur du contrôle de code source, accédez à un dossier parent logique de votre solution, tel que $/SiteApp/Main, où SiteApp est le nom de votre projet d'équipe. Pourquoi est-ce un bon dossier parent ?

4. Cliquez sur le lien en regard de Chemin d'accès local pour ouvrir le dossier parent dans l'Explorateur Windows (ou l'Explorateur de fichiers sous Windows 8).

   Que dois-je faire si le texte du lien est « Non Mappé » ?

5. Déplacez le dossier qui contient votre solution dans le dossier parent.

6. Dans Visual Studio, choisissez Fichier, Ouvrir, Projet/Solution, puis utilisez la boîte de dialogue Ouvrir un projet pour ouvrir la solution.

7. Dans l'Explorateur de solutions (raccourci : Ctrl + Alt + L), sélectionnez la solution, ouvrez le menu contextuel, puis choisissez Ajouter la solution au contrôle de code source.

8. Dans l'Explorateur de solutions, sélectionnez la solution, ouvrez le menu contextuel, puis choisissez Archiver.

9. Dans Team Explorer, la page Modifications en attente s'affiche.

10. Y a-t-il des modifications détectées affichées dans la section Modifications exclues ?

    • Non : passez à l'étape suivante.

    • Oui : sélectionnez le lien Modifications détectées. La boîte de dialogue Promouvoir les modifications candidates s'affiche. Les fichiers listés dans cette boîte de dialogue ne sont référencés par aucun projet de code de votre solution. Lorsque votre équipe aura besoin de ces fichiers, assurez-vous qu'ils sont sélectionnés, puis choisissez Promouvoir pour les déplacer vers la section Modifications incluses de la page Modifications en attente. Pour plus d'informations, consultez Archiver votre contribution au code base de l'équipe.

11. Lorsque vous êtes prêt, soumettez vos modifications en attente.

Ajouter un ou plusieurs fichiers au contrôle de version

Lorsque vous utilisez l'Explorateur de solutions pour ajouter un fichier à votre projet de code, le système l'ajoute automatiquement au contrôle de version. Toutefois, vous pouvez également ajouter des fichiers qui ne sont pas référencés par vos projets de code.

Conseil

Si vous créez un processus automatisé ou préférez utiliser l'invite de commandes, vous pouvez utiliser Add, commande au lieu des procédures suivantes.

Ajouter automatiquement un ou plusieurs fichiers au contrôle de version

Si vous utilisez un espace de travail local, les nouveaux fichiers sont automatiquement détectés par la page Modifications en attente.

1. Dans Visual Studio, si vous ne l'avez pas déjà fait, connectez-vous au projet d'équipe.

2. Choisissez Afficher, Autres fenêtres, Explorateur du contrôle de code source.

3. Dans l'Explorateur du contrôle de code source, accédez au dossier auquel vous souhaitez ajouter des fichiers ou dossiers.

4. Choisissez le lien en regard de Chemin d'accès local pour ouvrir le dossier cible dans l'Explorateur Windows (ou l'Explorateur de fichiers sous Windows 8).

   Déplacez vos fichiers et dossiers dans ce dossier.

   Que dois-je faire si le texte du lien est « Non Mappé » ?

5. Dans Visual Studio, sous Team Explorer, choisissez Modifications en attente.

6. Sur la page Modifications en attente, dans la section Modifications exclues, choisissez Modifications détectées.

7. Dans la boîte de dialogue Promouvoir les modifications candidates, vérifiez que seuls les fichiers à archiver sont sélectionnés, puis sélectionnez Promouvoir.

8. Soumettez vos modifications en attente.

Ajouter manuellement des fichiers au contrôle de version

Vous pouvez également ajouter manuellement des fichiers au contrôle de version.

1. Choisissez Afficher, Autres fenêtres, Explorateur du contrôle de code source.

2. Dans l'Explorateur du contrôle de code source, accédez au dossier dans lequel vous voulez placer vos fichiers.

   Important

   Assurez-vous que ce dossier est archivé avant de continuer.Si vous créez le dossier maintenant, ouvrez le menu contextuel et choisissez Archiver, puis archivez le nouveau dossier avant de continuer.

3. Faites glisser les dossiers ou les fichiers de l'Explorateur Windows (ou de l'Explorateur de fichiers) vers le dossier de l'Explorateur du contrôle de code source.

4. Lorsque la boîte de dialogue Ajouter au contrôle de code source apparaît, vérifiez que tous les fichiers que vous souhaitez ajouter sont sélectionnés, puis choisissez Inclure les éléments.

5. Choisissez Terminer.

6. Dans Team Explorer, lorsque la page Modifications en attente apparaît, vérifiez que les fichiers binaires que vous souhaitez ajouter apparaissent dans la section Modifications incluses. Choisissez Archiver.

Utiliser des tiers binaires que votre code ne génère pas

De nombreuses équipes développent du code qui dépend de binaires qui ne sont pas générés par la solution dans laquelle ils gèrent leur code. Généralement, ces fichiers binaires font partie d'une bibliothèque dont l'équipe a obtenu les droits d'accès auprès d'un tiers.

Parfois, ces fichiers binaires proviennent d'une autre équipe de la même société. Par exemple, l'équipe A dépend des fichiers binaires produits par l'équipe B, et chaque équipe doit pour une raison quelconque travailler dans différentes collections de projets d'équipe. Par conséquent, l'équipe B livre les fichiers binaires à l'équipe A, qui les vérifie ensuite dans le contrôle de version.

Conseil

Si vos ordinateurs de développement et serveurs de builds peuvent accéder à Internet, NuGet peut facilement gérer les dépendances et garder vos fichiers binaires à jour pour votre équipe.Même si vous décidez d'utiliser NuGet, vous devez éventuellement ajouter les fichiers binaires au contrôle de version afin de pouvoir reproduire et générer les versions historiques de votre code.

La structure des dossiers et d'espace de travail que vous devez utiliser pour stocker les tiers binaires dépend de la façon dont vos solutions dépendent de ces bibliothèques.

Ajouter les fichiers binaires dans votre dossier ou structure de branche

Si vous définissez vos binaires tiers dans le même dossier parent que celui qui contient vos dossiers de solution, tous les projets de code de toutes les solutions peuvent référencer les bibliothèques avec le même chemin d'accès relatif.

Par exemple, une équipe utilise cette structure de dossiers :

Chaque projet de code peut ensuite référencer le dossier de bibliothèques avec le chemin d'accès relatif suivant : ../../Lib

Si, plus loin dans votre projet, votre équipe doit isoler les efforts distincts qui requièrent différentes versions des fichiers binaires, vous pouvez créer une branche du dossier de bibliothèque avec votre dossier de solution.

Par exemple, la version 1 d'une application s'appuie sur la version 1 d'une bibliothèque. Lorsque certains développeurs de l'équipe d'accès aux données travaillent sur la version suivante, ils tirent parti de la version 2. En revanche, les autres équipes ne sont pas encore prêtes à procéder à la mise à niveau. Vous pouvez utiliser des branches pour gérer ce type de situation.

Utilisez un espace de travail pour mapper les binaires

Certaines sociétés doivent gérer des dépendances plus complexes des bibliothèques tierces. Par exemple, plusieurs projets d'équipe contiennent des solutions avec différentes dépendances sur un ensemble commun de bibliothèques. Dans des cas comme celui-ci, vous pouvez stocker vos bibliothèques tierces dans le projet d'équipe dédié. Les collaborateurs aux divers projets d'équipe mappent les dossiers qui contiennent les bibliothèques dont ils ont besoin.

Par exemple, FabrikamFiber met en place le projet d'équipe, la branche et la structure de dossiers suivants :

Raisa configure l'ordinateur de développement avec les deux espaces de travail pour deux efforts différents, chacun d'entre eux mappe aux bibliothèques dont elle a besoin :

Personnaliser les fichiers à ignorer par le contrôle de version

Par défaut, certains types de fichiers (par exemple, fichiers .dll) sont ignorés par le contrôle de version. Par conséquent :

• Lorsque vous ajoutez des fichiers ignorés aux dossiers mappés dans un espace de travail local, ils n'apparaissent pas sur la page Modifications en attente dans Team Explorer.

• Lorsque vous essayez d'ajouter des fichiers ignorés à l'aide de la boîte de dialogue Ajouter au contrôle de code source (par exemple en les faisant glisser dans l'Explorateur du contrôle de code source), ils s'affichent automatiquement dans l'onglet Éléments exclus .

Vous pouvez configurer quels types de fichiers sont ignorés en plaçant le fichier texte appelé .tfignore dans le dossier auquel vous souhaitez appliquer des règles. Les effets du fichier .tfignore sont récursifs. Toutefois, vous pouvez créer des fichiers .tfignore dans les sous-dossiers pour remplacer les effets d'un fichier .tfignore dans un dossier parent.

Règles du fichier .tfignore

Les règles suivantes s'appliquent au fichier .tfignore.

• # commence une ligne de commentaire

• Les caractères génériques * et ? sont pris en charge.

• Une spécification de fichier est récursive tant qu'elle n'est pas préfixée par le caractère \.

• ! annule une spécification de fichier (les fichiers correspondant au modèle ne sont pas ignorés)

Exemple de fichier .tfignore

######################################
# Ignore .cpp files in the ProjA sub-folder and all its subfolders
ProjA\*.cpp
# Ignore .txt files in this folder 
\*.txt
# Ignore .xml files in this folder and all its sub-folders
*.xml
# Ignore all files in the Temp sub-folder
\Temp
# Do not ignore .dll files in this folder nor in any of its sub-folders
!*.dll

Créer et utiliser un fichier .tfignore

Si vous pouvez créer manuellement un fichier texte .tfignore à l'aide des règles ci-dessus, vous pouvez également en générer automatiquement un lorsque la page Modifications en attente a détecté une modification.

Pour générer automatiquement un fichier .tfignore

1. Sur la page Modifications en attente, dans la section Modifications exclues, sélectionnez le lien Modifications détectées.

   La boîte de dialogue Promouvoir les modifications candidates s'affiche.

2. Sélectionnez un fichier, ouvrez le menu contextuel, puis choisissez Ignorer cet élément local, Ignorer par extension, Ignorer par nom de fichier ou Ignorer par dossier.

3. Choisissez OK ou Annuler pour fermer la boîte de dialogue Promouvoir les modifications candidates.

4. Un fichier .tfignore s'affiche dans la section Modifications incluses de la page Modifications en attente. Vous pouvez ouvrir ce fichier et le modifier pour répondre à vos besoins.

Le fichier .tfignore est automatiquement ajouté comme une modification en attente incorporée afin que les règles que vous avez créées s'appliquent à chaque membre de l'équipe qui définit le fichier.

Travailler depuis l'invite de commandes

• Add, commande charge les fichiers depuis l'espace de travail sur votre machine de développement vers votre serveur.

Voir aussi

Autres ressources

Décider d'utiliser un espace de travail local ou de serveur