Ajouter des fichiers au serveur
Publication: mars 2016
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.
.jpeg "Boîte de dialogue Nouveau projet")
Dans Visual Studio, si vous ne l'avez pas déjà fait, connectez-vous au projet d'équipe.
Choisissez Fichier, Nouveau, Projet (raccourci : Ctrl + Maj + N).
La boîte de dialogue Nouveau projet s'affiche.
Sélectionnez le type de projet de code que vous souhaitez créer.
Dans la zone Nom, spécifiez le nom du projet de code.
Si la liste Solution s'affiche, vérifiez que Créer une nouvelle solution est sélectionné.
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.
Sélectionnez OK pour créer le projet de code que vous pouvez ensuite afficher dans l'Explorateur de solutions (raccourci : Ctrl + Alt + L).
.jpeg "Nouveau projet de code dans l'Explorateur de solutions")
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.
Dans Visual Studio, si vous ne l'avez pas déjà fait, connectez-vous au projet d'équipe.
Choisissez Afficher, Autres fenêtres, Explorateur du contrôle de code source.
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 ?
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).
Déplacez le dossier qui contient votre solution dans le dossier parent.
Dans Visual Studio, choisissez Fichier, Ouvrir, Projet/Solution, puis utilisez la boîte de dialogue Ouvrir un projet pour ouvrir la solution.
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.
Dans l'Explorateur de solutions, sélectionnez la solution, ouvrez le menu contextuel, puis choisissez Archiver.
Dans Team Explorer, la page Modifications en attente s'affiche.
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.
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 que vous préférez utiliser l'invite de commandes, vous pouvez utiliser la 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.
Dans Visual Studio, si vous ne l'avez pas déjà fait, connectez-vous au projet d'équipe.
Choisissez Afficher, Autres fenêtres, Explorateur du contrôle de code source.
Dans l'Explorateur du contrôle de code source, accédez au dossier auquel vous souhaitez ajouter des fichiers ou dossiers.
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.
Dans Visual Studio, sous Team Explorer, choisissez Modifications en attente.
Sur la page Modifications en attente, dans la section Modifications exclues, choisissez Modifications détectées.
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.
Ajouter manuellement des fichiers au contrôle de version
Vous pouvez également ajouter manuellement des fichiers au contrôle de version.
Choisissez Afficher, Autres fenêtres, Explorateur du contrôle de code source.
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.
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.
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.
Choisissez Terminer.
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 vos 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 :
.jpeg "Dossier de bibliothèque au sein d'un dossier parent principal")
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.
.jpeg "Dossier de bibliothèque au sein d'une structure de branche")
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 :
.jpeg "Bibliothèques stockées dans un projet d'équipe dédié")
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 :
.jpeg "Les espaces de travail mappent dans les bibliothèques")
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
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.
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.
Choisissez OK ou Annuler pour fermer la boîte de dialogue Promouvoir les modifications candidates.
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 : télécharger des fichiers depuis l'espace de travail sur votre machine de développement vers votre serveur.