Gestion des branches dans GitHub Desktop

Vous pouvez utiliser GitHub Desktop pour créer une branche à partir d’une branche existante dans votre dépôt afin de pouvoir tester les modifications en toute sécurité.

Platform navigation

Dans cet article

À propos de la gestion des branches

Vous pouvez utiliser les branches pour tester sans risques les changements apportés à votre projet. Les branches isolent votre travail de développement des autres branches du dépôt. Par exemple, vous pouvez utiliser une branche pour développer une nouvelle fonctionnalité ou résoudre un bogue.

Vous créez toujours une branche à partir d’une branche existante. En règle générale, vous pouvez créer une branche à partir de la branche par défaut de votre dépôt. Vous pouvez ensuite travailler sur cette nouvelle branche indépendamment des changements apportés au dépôt par d’autres personnes.

Vous pouvez également créer une branche à partir d’un commit précédent dans l’historique d’une branche. Cela peut être utile si vous devez retourner à une vue antérieure du dépôt pour investiguer un bogue ou pour créer un correctif logiciel ciblant votre dernière mise en production.

Une fois que vous êtes satisfait de votre travail, vous pouvez créer une demande de tirage (pull request) pour fusionner les changements que vous avez apportés dans la branche actuelle avec une autre branche. Pour plus d’informations, consultez « Création d’un problème ou d’une demande de tirage (pull request) à partir de GitHub Desktop » et « À propos des demandes de tirage (pull requests) ».

Vous pouvez toujours créer une branche dans GitHub Desktop si vous disposez d’un accès en lecture à un dépôt, mais vous pouvez uniquement pousser la branche vers GitHub si vous disposez d’un accès en écriture au dépôt.

Les administrateurs de dépôt peuvent activer des protections sur une branche. Si vous travaillez sur une branche protégée, vous ne pouvez pas supprimer une branche ni forcer une poussée (push) vers la branche. Les administrateurs de référentiel peuvent également activer d’autres paramètres de branche protégée pour appliquer des workflows spécifiques avant qu’une branche ne puisse être fusionnée. Pour plus d’informations, consultez « À propos des branches protégées ».

Les administrateurs de référentiel peuvent également activer des ensembles de règles. Les ensembles de règles peuvent être utilisés pour exiger des noms de branche spécifiques pendant la création d’une nouvelle branche ou pour autoriser uniquement les utilisateurs disposant d’autorisations de contournement à publier une nouvelle branche dans le référentiel à distance. GitHub Desktop affiche un avertissement et empêche la création de la branche si celle-ci ne respecte pas les ensembles de règles. Pour plus d’informations, consultez « À propos des ensembles de règles ».

Création d'une branche

Tip

La première branche que vous créerez sera basée sur la branche par défaut. Si vous avez plusieurs branches, vous pouvez baser la nouvelle branche sur la branche extraite ou sur la branche par défaut.

  1. En haut de l’application, cliquez sur Branche actuelle, puis dans la liste des branches, cliquez sur la branche sur laquelle vous voulez baser votre nouvelle branche.

    Capture d’écran de la vue déroulante « Branche actuelle ». Sous « Branches récentes », une branche nommée « my-feature » est mise en évidence avec un contour orange.

  2. Cliquez sur Nouvelle branche.

    Capture d’écran de la vue déroulante « Branche actuelle ». En regard du champ « Filtre », un bouton intitulé « Nouvelle branche » est indiqué en orange.

  3. Dans la fenêtre « Créer une branche », sous « Nom », tapez le nom de la nouvelle branche.

  4. Sous « Créer une branche basée sur... », sélectionnez une branche de base pour votre nouvelle branche.

  5. Cliquez sur Créer une branche.

Création d’une branche à partir d’un commit précédent

  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. Cliquez avec le bouton droit sur le commit à partir duquel vous souhaitez créer une branche, puis sélectionnez Créer une branche à partir du commit.

    Capture d’écran d’une liste de validations sous l’onglet « Historique ». En regard d’une validation, dans un menu contextuel, le curseur pointe sur une option intitulée « Créer une branche à partir d’une validation ».

  3. Dans la fenêtre « Créer une branche », sous « Nom », tapez le nom de la nouvelle branche.

  4. Cliquez sur Créer une branche.

Publication d’une branche

Si vous créez une branche sur GitHub, vous devez la publier pour la rendre disponible à des fins de collaboration sur GitHub.

  1. Dans la barre de dépôts, cliquez sur Branche actuelle, puis sur la branche à publier.
    Capture d’écran de la vue déroulante « Branche actuelle ». Sous « Branches récentes », une branche nommée « my-feature » est mise en évidence avec un contour orange.
  2. Cliquez sur Publier la branche.
    Capture d’écran de la barre du dépôt. Sur le côté droit, un bouton intitulé « Publier la branche » est mis en surbrillance avec un contour orange.

Basculement entre les branches

Vous pouvez voir et effectuer des commits dans n’importe quelle branche de votre dépôt. Si vous avez des changements enregistrés non commités, vous devez décider quoi en faire avant de pouvoir changer de branche. Vous pouvez commiter vos changements dans la branche actuelle, faire un stash de vos changements pour les enregistrer temporairement dans la branche actuelle ou appliquer les changements à votre nouvelle branche. Si vous souhaitez commiter vos changements avant de changer de branche, consultez « Commit et revue des changements apportés à votre projet dans GitHub Desktop ».

Tip

Vous pouvez définir un comportement par défaut pour le passage d'une branche à l'autre dans les paramètres des invites. Pour plus d’informations, consultez « Configuration des paramètres de base dans GitHub Desktop ».

  1. Dans la barre de dépôts, cliquez sur Branche actuelle, puis sur la branche sur laquelle basculer.
    Capture d’écran de la vue déroulante « Branche actuelle ». Sous « Branches récentes », une branche nommée « my-feature » est mise en évidence avec un contour orange.
  2. Si vous avez enregistré des modifications non validées, dans la fenêtre « Changer de branche », sélectionnez Laisser mes modifications dans CURRENT-BRANCH ou Apporter mes modifications à NEW-BRANCH, puis cliquez sur Changer de branche.

Suppression d’une branche

Vous ne pouvez pas supprimer une branche si elle est associée à une demande de tirage ouverte. Vous ne pouvez pas annuler la suppression d’une branche.

  1. Dans la barre de dépôts, cliquez sur Branche actuelle, puis sur la branche à supprimer.
    Capture d’écran de la vue déroulante « Branche actuelle ». Sous « Branches récentes », une branche nommée « my-feature » est mise en évidence avec un contour orange.
  2. Dans la barre de menus, cliquez sur Branche, puis sur Supprimer... . Vous pouvez également appuyer sur Maj+Commande+D.
    Capture d’écran de la barre de menus sur un Mac. Dans le menu déroulant « Branche » développé, le curseur pointe sur l’option « Supprimer », mise en surbrillance en bleu.
  1. Dans la barre de dépôts, cliquez sur Branche actuelle, puis sur la branche à supprimer.
    Capture d’écran de la vue déroulante « Branche actuelle ». Sous « Branches récentes », une branche nommée « my-feature » est mise en évidence avec un contour orange.
  2. Dans la barre de menus, cliquez sur Branche, puis sur Supprimer... Vous pouvez aussi appuyer sur Ctrl+Maj+D.
    Capture d’écran de la barre de menus « GitHub Desktop » sur Windows. Dans le menu déroulant « Branche » développé, une option intitulée « Supprimer » est encadrée en orange.

Pour aller plus loin