Synchronisation de votre branche dans GitHub Desktop

Quand vos commits sont poussés vers votre projet dans GitHub, vous pouvez garder votre copie locale du projet synchronisée en effectuant un tirage à partir du dépôt distant.

Platform navigation

Dans cet article

À propos de la synchronisation de branche

Vous pouvez synchroniser votre branche locale avec le dépôt distant en tirant les commits ajoutés à la branche dans GitHub depuis la dernière synchronisation. Si vous effectuez des commits à partir d’un autre appareil ou si plusieurs personnes contribuent à un projet, vous devez synchroniser votre branche locale pour la maintenir à jour.

Quand vous effectuez un tirage vers votre branche locale, vous mettez uniquement à jour votre copie locale du dépôt. Pour mettre à jour votre branche sur GitHub, vous devez pousser vos changements. Pour plus d’informations, consultez « Poussée de changements vers GitHub à partir de GitHub Desktop ».

Pour ajouter des changements d’une branche à une autre, vous pouvez fusionner les branches. Pour appliquer les changements apportés à votre branche à partir d’une autre branche du même dépôt, vous pouvez fusionner l’autre branche avec votre branche dans GitHub Desktop. Pour demander la fusion des changements de votre branche dans une autre branche, dans le même dépôt ou dans un autre dépôt du réseau, vous pouvez créer une demande de tirage (pull request) sur GitHub Desktop. Pour plus d’informations, consultez « Fusion d’une autre branche avec votre branche de projet » et « À propos des demandes de tirage (pull requests) ».

Certains workflows ont besoin ou bénéficient d’un rebasage au lieu d’une fusion. Le rebasage vous permet d’effectuer la réorganisation, la modification ou le squash des commits de manière groupée. Pour plus d’informations, consultez « À propos de git rebase » et « Rebasage de votre branche de projet dans une autre branche ».

Tirage vers votre branche locale à partir du dépôt distant

  1. Dans GitHub Desktop, utilisez la liste déroulante Branche actuelle, puis sélectionnez la branche locale à mettre à jour.

  2. Pour rechercher des commits dans la branche distante, cliquez sur Récupérer origin.

    Capture d’écran de la barre du dépôt. Le bouton « Récupérer origin », affiché avec une icône de deux flèches formant un cercle, est encadré en orange.

  3. Pour tirer des commits de la branche distante, cliquez sur Tirer origin ou Tirer origin avec rebasage.

    Capture d’écran de la barre du dépôt. Le bouton « Tirer origin », affiché avec une icône d’une flèche vers le bas, est encadré en orange.

  4. Résolvez les conflits de fusion à votre guise, à l’aide d’un éditeur de texte, de la ligne de commande ou d’un autre outil. Pour plus d’informations, consultez « Traitement des conflits de fusion ».

Fusion d’une autre branche avec votre branche de projet

  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. Cliquez sur Choisir une branche à fusionner dans BRANCH.

    Capture d’écran de la vue déroulante « Branche actuelle ». Sous une liste de branches, un bouton intitulé « Choisir une branche à fusionner dans ma branche » est indiqué en orange.

  3. Cliquez sur la branche à fusionner dans la branche actuelle, puis sur Fusionner BRANCH dans BRANCH.

    Remarque : En cas de conflit de fusion, GitHub Desktop vous avertit au-dessus du bouton Fusionner BRANCHE dans BRANCHE. Vous ne pourrez pas fusionner les branches tant que vous n’aurez pas résolu tous les conflits.

  4. Pour envoyer (push) vos modifications locales vers le dépôt distant, dans la barre du dépôt, cliquez sur Envoyer l’origine.

    Capture d’écran de la barre du dépôt. Un bouton, intitulé « Origine de l’envoi », est mis en évidence avec un encadré orange.

Rebasage de votre branche de projet dans une autre branche

  1. Dans la barre de menus, sélectionnez Branche et cliquez sur Rebaser la branche actuelle.

    Capture d’écran de la barre de menus sur un Mac. Dans le menu déroulant « Branche » développé, le curseur pointe sur une option intitulée « Rebaser la branche actuelle ».

    Capture d’écran de la barre de menus « GitHub Desktop » sur Windows. Dans le menu déroulant « Branche » développé, une option intitulée « Rebaser la branche actuelle » est encadrée en orange.

  2. Cliquez sur la branche à rebaser dans la branche actuelle, puis sur Rebaser.

  3. Si vous êtes sûr de vouloir rebaser, cliquez sur Commencer le rebasage.

  4. Résolvez les conflits de fusion à votre guise, à l’aide d’un éditeur de texte, de la ligne de commande ou d’un autre outil. Pour plus d’informations, consultez « Traitement des conflits de fusion ».

  5. Pour pousser vos changements locaux, cliquez sur Forcer la poussée vers origin.

    Capture d’écran de la barre du dépôt. Un bouton, intitulé « Forcer la poussée vers origin » et affiché avec une icône d’une double flèche vers le haut, est encadré en orange.

Squash et fusion d’une autre branche dans votre branche de projet

  1. Dans la barre de menus, sélectionnez Branche et cliquez sur Effectuer un squash et une fusion dans la branche actuelle.

    Capture d’écran de la barre de menus sur un Mac. Dans le menu déroulant « Branche » développé, le curseur pointe sur une option intitulée « Effectuer un squash et une fusion dans la branche actuelle ».

    Capture d’écran de la barre de menus « GitHub Desktop » sur Windows. Dans le menu déroulant « Branche » développé, une option intitulée « Effectuer un squash et une fusion » est encadrée en orange.

  2. Dans la fenêtre « Effectuer un squash et une fusion », cliquez sur la branche à fusionner dans la branche actuelle, puis sur Effectuer un squash et une fusion.

    Remarque : En cas de conflit de fusion, GitHub Desktop vous avertit au-dessus du bouton Effectuer un squash et une fusion. Vous ne pourrez pas effectuer un squash et une fusion de la branche tant que vous n’aurez pas résolu tous les conflits.

  3. Pour envoyer (push) vos modifications locales vers le dépôt distant, dans la barre du dépôt, cliquez sur Envoyer l’origine.

    Capture d’écran de la barre du dépôt. Un bouton, intitulé « Origine de l’envoi », est mis en évidence avec un encadré orange.

En savoir plus