Créer une demande de tirage (pull request) dans Visual Studio
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 :
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.
Ensuite, vous pouvez valider et envoyer (push) vos modifications comme vous le feriez normalement dans la fenêtre Modifications Git.
Sélectionnez le lien dans la bannière de notification pour Créer dans Visual Studio ou Créer dans le navigateur.
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.
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).
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.
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.
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.
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. Ou, avec Visual Studio 17.12 et versions ultérieures, cliquez sur la liste déroulante et choisissez Créer en tant que brouillon.
Avec Visual Studio 17.12 et versions ultérieures, vous pouvez activer la fonctionnalité Modèles de demande de tirage (dans les fonctionnalités d’évaluation de l’environnement>d’outils>>) afin que votre modèle de demande de tirage par défaut dans votre dépôt soit utilisé lors de la création d’une nouvelle demande de tirage pour GitHub et Azure DevOps. Découvrez comment ajouter un modèle de demande de tirage (pull request) à votre référentiel dans la documentation GitHub et la documentation Azure DevOps.
Afficher les commentaires sur une demande de tirage dans l’éditeur
À partir de Visual Studio 17.11, vous pouvez afficher les commentaires et les suggestions des réviseurs sans changer de contexte vers le navigateur.
Pour activer cette fonctionnalité, ouvrez Outils>Options>Fonctionnalités en préversion et assurez-vous que Commentaires sur les demandes de tirage est bien sélectionné.
Pour afficher les commentaires d’une demande de tirage, extrayez n’importe quelle branche contenant une branche de demande de tirage active et sélectionnez Afficher les commentaires dans des fichiers dans la barre d’informations. Vous pouvez également sélectionner le numéro de la demande de tirage dans la fenêtre Modifications Git ou dans le menu Git de niveau supérieur avec Git>GitHub ou Azure DevOps>Afficher les commentaires dans des fichiers.
Pour parcourir les fichiers et les commentaires individuels, vous pouvez utiliser les icônes de la barre d’outils ou les raccourcis clavier suivants :
| Action | Raccourci clavier |
|---|---|
| Accéder au fichier précédent dans la demande de tirage | Ctrl+Maj+Alt+F6 |
| Accéder au fichier suivant dans la demande de tirage | Ctrl+Alt+F6 |
| Accéder au commentaire précédent | Ctrl+Maj+Alt+F8 |
| Accéder au commentaire suivant | Ctrl+Alt+F8 |
Étapes suivantes
Pour continuer votre parcours, consultez la page Récupérer, extraire et synchroniser dans Visual Studio.