Visualisation d’une demande de tirage dans GitHub Desktop

Dans cet article

Vous pouvez ouvrir une branche de demande de tirage dans GitHub Desktop pour afficher l’historique des validations, exécuter des vérifications ou apporter des modifications.

À propos des demandes de tirage dans GitHub Desktop

Les demandes de tirage vous permettent de proposer des changements aux projets, de fournir des commentaires et d’effectuer des revues ainsi que de fusionner les changements dans les projets. Pour plus d’informations, consultez « À propos des demandes de tirage (pull requests) ».

Lorsque quelqu’un crée une demande de tirage, il apporte des modifications sur une « branche de tête » et suggère ces modifications à une « branche de base », comme main. Dans GitHub Desktop, vous pouvez ouvrir (ou « modifier ») la branche de tête d’une demande de tirage pour afficher les modifications suggérées par un contributeur. Par exemple, vous pouvez voir l’historique des validations effectuées par le contributeur, ainsi que les fichiers modifiés, ajoutés ou supprimés par les validations.

La modification de la branche de tête peut être utile si vous souhaitez apporter des modifications à la branche, trop complexes pour être laissées comme suggestions dans une révision. Par exemple, vous pouvez apporter des modifications structurelles à certains contenus, ajouter ou supprimer des fichiers ou résoudre un conflit de fusion trop complexe à résoudre sur GitHub. À partir de GitHub Desktop, vous pouvez afficher la branche dans l’éditeur de texte de votre choix pour voir les modifications ou apporter d’autres mises à jour.

Vous pouvez également simplement afficher des informations telles que l’historique des validations et les enregistrements d'état dans un environnement familier, sans avoir à accéder à la demande de tirage sur GitHub. Si des vérifications ont été activées dans votre dépôt, GitHub Desktop indique leur état dans la demande de tirage et vous permet de les réexécuter. Pour plus d’informations, consultez « Utilisation d’une demande de tirage dans GitHub Desktop ».

Vous ne pouvez pas commenter une demande de tirage à partir de GitHub Desktop. Après avoir passé en revue les changements apportés dans une demande de tirage, vous pouvez faire part de vos commentaires sur GitHub. Pour plus d’informations, consultez « À propos des révisions de demande de tirage » et « Afficher une demande de tirage (pull request) sur GitHub ».

Ouverture d’une branche de demande de tirage (pull request) dans GitHub Desktop

  1. Dans GitHub Desktop, cliquez sur Branche actuelle.

    Capture d’écran de la barre du dépôt. Un bouton, intitulé « Current Branch » avec une flèche vers le bas indiquant un menu déroulant, est encadré en orange.

  2. En haut du menu déroulant, cliquez sur Requête de tirage.

    Capture d’écran du menu déroulant « Branche actuelle ». Un onglet intitulé « Demandes de tirage » est mis en évidence avec un encadré orange.

  3. Dans la liste des demandes de tirage, cliquez sur la demande de tirage que vous souhaitez afficher.

    Si vous le souhaitez, pour actualiser la liste des demandes de tirage, cliquez sur .

    Capture d’écran de l’onglet « Demandes de tirage ». Un bouton, étiqueté avec une icône de deux flèches formant un cercle, est mis en surbrillance avec un contour orange.

Lorsque vous avez ouvert une branche de demande de tirage, vous pouvez afficher le contenu de la branche dans un éditeur, afficher les l’historique des différences et validations des mises à jour du contributeur, puis afficher et réexécuter les vérifications. Pour plus d’informations, consultez « Utilisation d’une demande de tirage dans GitHub Desktop ».

Ouverture d’une branche de demande de tirage dans GitHub Desktop à partir de GitHub

  1. Sous le nom du référentiel, cliquez sur Demandes de tirage.

    Capture d’écran de la page principale d’un dépôt. Dans la barre de navigation horizontale, un onglet intitulé « Demandes de tirage » est indiqué en orange foncé.

  2. Dans la liste des demandes de tirage, cliquez sur celle que vous souhaitez ouvrir dans GitHub Desktop.

  3. À droite du titre de la demande de tirage, cliquez sur Code, puis, sous l’onglet Local, cliquez sur Validation avec GitHub Desktop.

    Capture d’écran d’une demande de tirage (pull request) sur GitHub. Le menu déroulant « Code » est développé et un bouton intitulé « Validation avec GitHub Desktop » est indiqué en orange.

Lorsque vous avez ouvert une branche de demande de tirage, vous pouvez afficher le contenu de la branche dans un éditeur, afficher les l’historique des différences et validations des mises à jour du contributeur, puis afficher et réexécuter les vérifications. Pour plus d’informations, consultez « Utilisation d’une demande de tirage dans GitHub Desktop ».

Utilisation d’une demande de tirage dans GitHub Desktop

Une fois que vous avez extrait une branche de demande de tirage, vous pouvez utiliser GitHub Desktop et votre éditeur local pour afficher les modifications du contributeur ou apporter d’autres modifications à la branche. Par exemple, vous pouvez :

Ouvrir la branche dans votre éditeur

Si vous souhaitez examiner les modifications apportées au contexte ou apporter des mises à jour supplémentaires à une demande de tirage, vous pouvez afficher le contenu de la branche dans votre éditeur local.

  1. Dans la barre de menus « GitHub Desktop », sélectionnez Référentiel.

  2. Cliquez sur Ouvrir dans l’ÉDITEUR.

    Capture d’écran d’une barre de menus sur un Mac. Sous le menu déroulant « Référentiel », un curseur pointe sur « Ouvrir dans Visual Studio Code », mis en surbrillance en bleu.

Pour plus d’informations, consultez « Configuration d’un éditeur par défaut dans GitHub Desktop ».

Afficher l'historique des validations

Vous pouvez afficher l’historique des validations de la branche si vous souhaitez voir comment le contributeur est arrivé à l’ensemble des modifications suggérées.

  1. Dans la barre latérale gauche, cliquez sur Histoire.

    Capture d’écran de l’onglet « Historique » dans la barre latérale. Au-dessus d’une liste de validations, le bouton d’onglet, intitulé « Historique » est mis en évidence avec un contour orange.

  2. Dans « Sélectionner la branche à comparer... », recherchez et sélectionnez la branche de base de la demande de tirage.

  3. Cliquez sur l’onglet Anticipé.

    Capture d’écran de l’onglet « Historique ». Au-dessus d’une liste de validations, « principal » est entré en tant que branche à comparer et un onglet intitulé « Anticipé » est souligné en orange.

Pour plus d’informations, consultez « Affichage de l’historique des branches dans GitHub Desktop ».

Afficher et réexécuter les vérifications

Vous pouvez afficher l’état des vérifications exécutées sur la branche de demande de tirage. Les vérifications ayant échoué peuvent indiquer des problèmes avec les modifications proposées, ce qui peut empêcher la fusion de la branche. Vous pouvez réexécuter des vérifications à partir de GitHub Desktop. Pour plus d’informations, consultez « Affichage et réexécution des vérifications dans GitHub Desktop ».

Affichage d’une demande de tirage dans GitHub

Pour ajouter des commentaires à une demande de tirage, laisser un avis ou fusionner la demande de tirage, vous devez accéder à la demande de tirage sur GitHub. Une fois que vous avez extrait une branche de demande de tirage dans GitHub Desktop, vous pouvez ouvrir rapidement la demande de tirage correspondante sur GitHub.

  1. Dans la barre de menus GitHub Desktop, cliquez sur Branche.

  2. Sélectionnez Afficher une demande de tirage sur GitHub .

    Capture d’écran de la barre de menus sur un Mac. Le menu déroulant « Branche » est développé et le curseur pointe sur « Afficher la demande de tirage sur GitHub ».