Créer une demande de tirage (pull request) dans Visual Studio

  • Article

Si vous êtes authentifié auprès de GitHub ou d’Azure DevOps et que vous avez envoyé des modifications à votre référentiel distant, vous pouvez créer une demande de tirage sans quitter Visual Studio. Les demandes de tirage (pull request) sont un outil essentiel dans GitHub et Azure DevOps pour la révision du code. Ces révisions aident à détecter les problèmes liés aux nouvelles fonctionnalités et permettent aux collègues de partager leur expérience avec différentes régions de codebase, ce qui améliore l’intégrité du codebase dans l’ensemble.

Remarque

Pour tester la fonctionnalité, assurez-vous qu’elle est activée dans Outils>Options>Fonctionnalités d’évaluation>demande de tirage (pull request)

Pour créer une demande de tirage (pull request), procédez comme suit :

  1. Avant de pouvoir créer une demande de tirage, vous devez créer une branche pour vos modifications. Cette branche conserve vos modifications distinctes de la branche primaire jusqu’à ce qu’elles soient prêtes à être fusionnées.

  2. Ensuite, vous pouvez valider et envoyer (push) vos modifications comme vous le feriez normalement dans la fenêtre Modifications Git.

  3. Sélectionnez le lien dans la bannière de notification pour Créer dans Visual Studio ou Créer dans le navigateur.

    Capture d’écran de la fenêtre Modifications Git avec la barre d’informations « Envoi réussi de QP à l’origine. Demande de tirage : Créer dans Visual Studio ou créer dans le navigateur. » dans Visual Studio 2022.

    Vous pouvez également créer une demande de tirage (pull request) à partir d’une branche distante en accédant à la fenêtre nouvelle demande de tirage via le menu de niveau supérieur Git>GitHub ou Azure DevOps>nouvelle demande de tirage. Vous pouvez également cliquer avec le bouton droit sur une branche dans la fenêtre référentiel Git.

    Le menu de niveau supérieur de Git avec GitHub sélectionné et le texte « Nouvelle demande de tirage » mis en surbrillance dans Visual Studio 2022.

    Vous pouvez également sélectionner une branche dans la fenêtre Référentiel Git pour ouvrir le menu contextuel et sélectionner Nouvelle demande de tirage (pull request).

    Fenêtre Référentiel Git avec le texte du lien sortant/entrant mis en surbrillance dans Visual Studio 2022.

  4. Sélectionnez la branche dans laquelle vous souhaitez fusionner et donnez à votre demande de tirage (pull request) une description et un titre descriptifs. Vous pouvez utiliser la syntaxe Markdown pour mettre en forme votre description de demande de tirage à partir de Visual Studio. Essayez-le en tapant les symboles markdown dans la zone Description et affichez un aperçu de votre markdown en sélectionnant le bouton Aperçu.

    Conseil

    Avec Visual Studio 2022 version 17.10 préversion 2 et versions ultérieures, et les extensions GitHub Copilot, vous pouvez utiliser l’IA pour générer une description détaillée de la demande de tirage qui décrit vos modifications. Appuyez sur l’icône de stylet lumineux pour demander que GitHub Copilot génère une description de demande de tirage. Pour plus d’informations sur l’installation de GitHub Copilot, consultez Installer et gérer GitHub Copilot dans Visual Studio.

    Capture d’écran de l’icône de stylet lumineux pour demander que GitHub Copilot génère une description de demande de tirage.

    Fenêtre de nouvelle demande de tirage avec le texte du bouton d’aperçu mis en surbrillance dans Visual Studio 2022.

  5. L’aperçu des différences vous permet de voir toutes les modifications apportées aux fichiers qui ont été validées dans le cadre de votre demande de tirage. Consultez Comparer les fichiers – vue diff.

    Conseil

    L’option d’affichage du résumé des différences vous permet de passer en revue uniquement les sections modifiées du code.

    Fenêtre de nouvelle demande de tirage avec le texte du bouton résumé mis en surbrillance dans Visual Studio 2022.

  6. Vous pouvez lier des éléments de travail en les référençant à la recherche de problèmes, en tapant # dans la zone de description ou en appuyant sur le bouton # dans le coin inférieur droit. Vous pouvez également ajouter vos réviseurs en tapant leur nom d’utilisateur GitHub ou leur identité Azure DevOps ou leur e-mail.

    Nouvelle demande de tirage avec le numéro dans la zone de description et la liste des problèmes GitHub associés et des demandes de tirage affichée dans Visual Studio 2022.

  7. Une fois que vous avez cliqué sur Créer sur votre demande de tirage, d’autres développeurs peuvent passer en revue vos modifications et fournir des commentaires.

Étapes suivantes

Pour continuer votre parcours, consultez la page Récupérer, extraire et synchroniser dans Visual Studio.

Voir aussi