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éez un nouveau projet de code et solutions sous contrôle de version

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

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

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

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

• Fonctionne depuis l'invite de commandes

Autorisations requises

Vous devez être un des Collaborateurs pour votre projet d'équipe.Consultez Groupes, autorisations et rôles par défaut de Team Foundation Server.

Créez un nouveau projet de code et solutions 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 pouviez immédiatement apprécier tous les avantages du contrôle de version qui débute dès la première ligne de code que vous écrivez.

Pour créer un nouveau projet de code et solutions sous contrôle de version

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

2. Choisissez Fichier, Nouveau, Projet.

   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 apparaît, vérifiez que Créer une nouvelle solution est sélectionné.

6. Dans la liste Emplacement , spécifiez le chemin d'accès à bon dossier de travail local (tel que c : \code\SiteApp\Main \) dans l'espace de travail que vous avez créé lorsque vous configurez 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. Choisissez OK pour créer le projet de code, qui apparaît ensuite dans l'explorateur de solutions.

   

8. Dans Explorateur de solutions, ouvrez le menu contextuel de la solution que vous avez créé ou modifié puis choisissez Archiver à envoyez vos modifications en attente.

Définissez 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 solution dans votre espace de travail, puis ajoutez -les.

[!REMARQUE]

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

Pour mettre une solution existante et les projets de code sous contrôle de version

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

2. Choisissez Affichage, 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 à côté 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 de 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 ou solution, puis utilisez la boîte de dialogue Ouvrir un projet pour ouvrir la solution.

7. Dans l'explorateur de solutions, sélectionnez la solution, ouvrez le menu contextuel, puis cliquez Ajouter la solution au contrôle de code source.

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

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

10. Y a t-ils des Changements Détectés affichés dans la section Changements Exclus?

    • 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 dans votre solution.Si votre équipe aura besoin de ces fichiers, assurez -vous qu'ils soient sélectionnés puis choisissez Promouvoir pour les déplacer dans la section Modifications incorporés 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, envoyez 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ées par vos projets de code.

Conseil
Si vous créez un processus automatisé ou le 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, alors les nouveaux fichiers sont automatiquement détectés par la page Changements en Attente.

Pour ajouter automatiquement un ou plusieurs fichiers au contrôle de version

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

2. Choisissez Affichage, 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. Cliquez sur le lien en regard Chemin d'accès local pour ouvrir le dossier cible dans l'Explorateur Windows (ou l'Explorateur de fichiers).

   Déplacez vos fichiers et dossiers dans ce dossier.

   Que dois-je faire si le texte de lien est "Non Mappé"?

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

6. Dans la page Modifications en attente, dans la section Modifications exclues, choisissez Changements Détectés.

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 changements en attente.

Ajout manuel de fichiers au contrôle de version

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

Pour ajouter manuelement des fichiers au contrôle de version

1. Choisissez Affichage, 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 répertoires ou les fichiers de l'Explorateur Windows (ou de l'Explorateur de fichiers) dans le dossier dans 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 sélectionnez ensuite Incluez 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 incorporés .Choisissez Archiver.

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

De nombreuses équipes développent du code qui dépend des binaires qui ne sont pas générées par la solution dans laquelle ils gèrent leur code.Généralement ces fichiers binaires font partie d'une bibliothèque que l'équipe a autorisé d'un tiers.

Parfois ces fichiers binaires proviennent d'une autre équipe dans la même société.Par exemple, l'équipe A dépend des fichiers binaires produites par l'équipe B, et chaque équipe doit pour une raison quelconque travailler dans des collections de projets d'équipe.Par conséquent, l'équipe B livre des fichiers binaires pour team 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, alors 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 des versions historique de votre code.

La structure de répertoire 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.

Ajoutez les fichiers binaires dans votre dossier ou la structure en branche

Si vous définissez vos tiers binaires dans le même répertoire parent qui contient vos dossiers de solution, tous les projets de code dans 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 le dossier de bibliothèque avec votre dossier de solution.

Par exemple, la version 1 d'une application tire parti de 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.Mais les autres équipes ne sont pas encore prêtes à améliorer.Vous pouvez utiliser des branches pour gérer ce type de situation.

Utilisez un espace de travail pour mapper des binaires

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

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

Julia configure l'ordinateur de développement avec les deux espaces de travail pour deux efforts différents, qui mappent aux bibliothèques qu'elle a besoin :

Personnalisez 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 dans la page Modifications en attente dans Team Explorer.

• Lorsque vous essayez d'ajouter les fichiers ignorés à l'aide de l'ajouter à la boîte de dialogue 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éments exclus tableau.

Vous pouvez configurer quels types de fichiers sont ignorés en plaçant le fichier texte appelé .tfignore dans le dossier sur lequel 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éez et utilisez 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. Dans la page Modifications en attente, dans la section Modifications exclues, choisissez Changements Détectés.

   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 ou Ignorer par nom de fichier.

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.

Fonctionne 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