Ajouter des fichiers au serveur de contrôle de version

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

L’ajout de fichiers au contrôle de version est souvent automatique lorsque vous utilisez l’Explorateur de solutions Visual Studio et que votre projet est sous contrôle de version. Toutefois, dans certains cas, vous devez prendre des mesures supplémentaires pour ajouter des fichiers et des projets au contrôle de version.

Prerequisites

Catégorie	Spécifications
Permissions	Membre du groupe Contributeurs pour votre projet.

Pour plus d’informations, consultez Autorisations TFVC par défaut.

Important

Ces procédures s’appliquent uniquement lorsque vous utilisez un espace de travail local. Lorsque vous utilisez un espace de travail local, de nouveaux fichiers sont automatiquement détectés en tant que modifications en attente. À l’inverse, les fichiers que vous enregistrez dans un espace de travail serveur s'ajoutent et s'archivent sans apparaître comme modifications en attente.

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

Vous pouvez créer un projet Visual Studio et l’ajouter au contrôle de version afin que vous et votre équipe puissiez profiter immédiatement des avantages du contrôle de version à partir de la première ligne de code que vous écrivez.

1. Dans Visual Studio, connectez-vous à votre projet Azure DevOps.

2. SélectionnezNouveau projet de >, ou appuyez sur Ctrl+Maj+N.

3. Dans l’écran Créer un projet , sélectionnez le type de projet de code que vous souhaitez créer, puis sélectionnez Suivant.

   

4. Dans l’écran Configurer votre nouveau projet , sous Nom du projet, entrez un nom pour le projet.

5. Sous Emplacement, spécifiez le chemin d’accès à un dossier de travail local, tel que c :\code\SiteApp\Main\, dans l’espace de travail que vous avez créé lors de la configuration de votre ordinateur de développement.

6. Laissez le reste des paramètres tels qu’ils le sont, puis sélectionnez Suivant.

   

7. Dans l’écran Informations supplémentaires , modifiez les paramètres en fonction des besoins, puis sélectionnez Créer.

8. Une fois le projet créé, affichez-le dans l’Explorateur de solutions, que vous pouvez ouvrir en appuyant sur Ctrl+Alt+L.

   

9. Cliquez avec le bouton droit sur le nom de la solution dans l’Explorateur de solutions, puis sélectionnez Ajouter une solution au contrôle de code source dans le menu contextuel.

10. Basculez vers la fenêtre Team Explorer et sélectionnez Valider pour valider le projet dans le contrôle de version.

Placer des solutions existantes et des projets de code sous contrôle de version

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

1. Dans Visual Studio, connectez-vous à votre projet Azure DevOps.

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

3. Dans l’Explorateur de contrôles de code source, accédez à un dossier parent logique pour votre solution, tel que $/SiteApp/Main, où SiteApp est le nom de votre projet. Pour en savoir plus sur l’affectation de noms à des dossiers locaux, consultez Optimiser les noms de vos dossiers.

4. Sélectionnez le lien en haut de la fenêtre en regard du chemin d’accès local pour ouvrir le dossier parent dans l’Explorateur de fichiers Windows. Si le lien indique Non mappé, consultez Créer et utiliser des espaces de travail pour plus d’informations sur le mappage de votre espace de travail.

5. Dans l’Explorateur de fichiers, déplacez le dossier qui contient votre solution dans le dossier parent.

6. Dans Visual Studio, choisissez Fichier>Ouvrir un projet, puis accédez à la solution et ouvrez-la.

7. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nom de la solution, puis sélectionnez Ajouter une solution au contrôle de code source dans le menu contextuel.

8. Cliquez à nouveau avec le bouton droit sur le nom de la solution, puis sélectionnez Valider dans le menu contextuel.

9. Dans la page Modifications en attente dans Team Explorer, si vous voyez un lien détecté dans la section Modifications exclues , sélectionnez le lien.

10. La boîte de dialogue Promouvoir les modifications candidates répertorie les fichiers qui ne sont référencés par aucun projet de code dans votre solution. Sélectionnez l’un de ces fichiers que vous souhaitez archiver, désélectionnez les fichiers que vous ne souhaitez pas archiver, puis sélectionnez Promouvoir pour déplacer les fichiers sélectionnés dans Modifications incluses. Si vous ne souhaitez pas archiver les fichiers répertoriés, sélectionnez Annuler pour fermer la boîte de dialogue.

11. Sélectionnez Enregistrer.

Pour plus d'informations, consultez soumets vos modifications en attente.

Ajouter un ou plusieurs fichiers au contrôle de version

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

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

1. Dans Visual Studio, connectez-vous à votre projet Azure DevOps.

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

3. Dans l’Explorateur de contrôles de code source, accédez au dossier dans lequel vous souhaitez ajouter les fichiers ou le dossier.

4. Sélectionnez le lien à côté du chemin local en haut de la fenêtre Explorateur de contrôle de code source pour ouvrir le dossier cible dans l’Explorateur de fichiers Windows. Si le lien indique Non mappé, consultez Créer et utiliser des espaces de travail et mapper votre espace de travail.

5. Dans l’Explorateur de fichiers, déplacez vos fichiers ou dossiers dans le dossier cible.

6. Dans Visual Studio Team Explorer, dans la page Modifications en attente , si vous voyez un lien détecté sous Modifications exclues, sélectionnez le lien.

7. Dans la boîte de dialogue Promouvoir les modifications des candidats, sélectionnez uniquement les fichiers que vous souhaitez valider, puis sélectionnez Promouvoir. Sélectionnez Annuler si vous ne souhaitez pas valider les fichiers répertoriés.

8. Sélectionnez Enregistrer.

Pour plus d'informations, consultez soumets 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. Dans Visual Studio, choisissez Afficher>Autres fenêtres>Explorateur de contrôle de code source.

2. Dans l’Explorateur de contrôles de code source, accédez au dossier dans lequel vous souhaitez ajouter les fichiers.

   Important

   Vérifiez que ce dossier est validé. Si vous créez un dossier, cliquez dessus avec le bouton droit et sélectionnez Archiver, puis archivez le nouveau dossier avant de continuer.

3. Faites glisser les fichiers de l’Explorateur de fichiers Windows dans la fenêtre de l’Explorateur de contrôles de code source Visual Studio.

4. Dans la page Modifications en attente dans Team Explorer, vérifiez que les éléments inclus répertorient tous les fichiers que vous souhaitez ajouter, puis sélectionnez Valider.

Utiliser des fichiers binaires que votre code n’inclut pas

De nombreuses équipes dépendent des fichiers binaires qui existent en dehors de leurs solutions de code. En règle générale, ces fichiers binaires font partie d’une bibliothèque que l’équipe a concédé sous licence à partir d’un tiers, ou les fichiers binaires proviennent d’une autre équipe de la même entreprise. Par exemple, l’équipe A dépend des fichiers binaires produits par l’équipe B, et chaque équipe travaille dans différentes collections de projets. L’équipe B fournit des fichiers binaires à l’équipe A, qui les vérifie dans le contrôle de version.

Conseil / Astuce

Les packages NuGet peuvent faciliter la gestion des dépendances par votre équipe et maintenir les fichiers binaires à jour. Vous pouvez stocker des packages NuGet dans Azure DevOps Server ou Azure DevOps Services à l’aide d’Azure Artifacts.

La structure de dossier et d’espace de travail que vous devez utiliser pour stocker des fichiers binaires externes 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 placez des fichiers binaires externes dans le même dossier parent qui contient vos dossiers de solution, tous vos projets de code dans toutes les solutions peuvent référencer les bibliothèques avec le même chemin relatif. Par exemple, une équipe peut utiliser la structure de dossiers suivante :

Chaque projet de code peut ensuite référencer le dossier des bibliothèques à l’aide du chemin ../../Librelatif.

Si votre équipe doit isoler des efforts distincts nécessitant différentes versions des fichiers binaires, vous pouvez brancher 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. Comme certains développeurs travaillent sur la version suivante, ils utilisent la version 2, mais d’autres développeurs ne sont pas prêts à effectuer la mise à niveau. Vous pouvez utiliser des branches pour gérer ces situations.

Utiliser un espace de travail pour mapper les fichiers binaires

Certaines entreprises doivent gérer des dépendances plus complexes sur des bibliothèques externes. Par exemple, plusieurs projets peuvent contenir des solutions qui ont des dépendances différentes sur un ensemble commun de bibliothèques. Dans ces cas, vous pouvez stocker des bibliothèques externes dans un projet dédié. Les contributeurs aux différents projets sont mappés dans les dossiers qui contiennent les bibliothèques dont ils ont besoin.

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

Les développeurs peuvent configurer des machines de développement avec deux espaces de travail pour deux efforts différents, chacun d’entre eux mappe dans les bibliothèques dont il a besoin :

Personnaliser quels fichiers le contrôle de version ignore

Par défaut, le contrôle de version ignore certains types de fichiers, tels que les fichiers.dll . Lorsque vous ajoutez des fichiers ignorés à des dossiers mappés dans un espace de travail local ou que vous faites glisser les fichiers ignorés dans l’Explorateur de contrôles de code source, les fichiers apparaissent sous Éléments exclus dans la page Modifications en attente dans Team Explorer.

Vous pouvez configurer les types de fichiers à ignorer en plaçant un fichier texte .tfignore dans le dossier dans lequel vous souhaitez appliquer la configuration. Les effets du fichier .tfignore sont récursifs, mais les fichiers .tfignore dans les sous-dossiers remplacent les fichiers .tfignore dans les dossiers parents.

Règles pour les fichiers .tfignore

Les règles suivantes s’appliquent aux fichiers .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, sauf si préfixée par le \ caractère.
• ! annule une spécification de fichier, de sorte que les fichiers qui correspondent au modèle ne sont pas ignorés.

Exemple de fichier .tfignore

######################################
# Ignore .cpp files in the ProjA subfolder 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
#
# Don't ignore .dll files in this folder nor in any of its subfolders
!*.dll

Créer et utiliser un fichier .tfignore

Vous pouvez créer manuellement un fichier texte .tfignore qui utilise les règles précédentes, ou générer automatiquement un fichier .tfignore lorsque la page Modifications en attente détecte une modification exclue.

1. Dans Team Explorer, dans la page Modifications en attente , sélectionnez le lien Détecté dans la section Modifications exclues .
2. Dans la boîte de dialogue Promouvoir les modifications des candidats , cliquez avec le bouton droit sur un fichier que vous souhaitez ignorer et sélectionnez Ignorer cet élément local, Ignorer par extension, Ignorer par nom de fichier ou Ignorer par dossier dans le menu contextuel.
3. Sélectionnez Annuler pour fermer la boîte de dialogue.
4. Un fichier .tfignore apparaît 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 ajouté en tant que modification en attente incluse. Par conséquent, les règles que vous créez s’appliquent automatiquement à la personne qui obtient le fichier.

Travailler à partir de l’invite de commandes

Pour les processus automatisés ou si vous souhaitez utiliser une invite de commandes, vous pouvez utiliser la tf.exe ajouter une commande au lieu des procédures décrites dans cet article. La add commande charge les fichiers d’un espace de travail sur un ordinateur local sur le serveur.

Articles connexes

• Choisir entre l’utilisation d’un espace de travail local ou d’un serveur