À 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
Conseil : La première branche que vous créez est 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.
-
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.
-
Cliquez sur Nouvelle branche.
-
Dans la fenêtre « Créer une branche », sous « Nom », tapez le nom de la nouvelle branche.
-
Sous « Créer une branche basée sur... », sélectionnez une branche de base pour votre nouvelle branche.
-
Cliquez sur Créer une branche.
Création d’une branche à partir d’un commit précédent
-
Dans la barre latérale gauche, cliquez sur Histoire.
-
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.
-
Dans la fenêtre « Créer une branche », sous « Nom », tapez le nom de la nouvelle branche.
-
Cliquez sur Créer une branche.
Publication d’une branche
Si vous créez une branche sur GitHub Enterprise Server, vous devez la publier pour la rendre disponible à des fins de collaboration sur GitHub.
- Dans la barre de dépôts, cliquez sur Branche actuelle, puis sur la branche à publier.
- Cliquez sur Publier la branche.
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 ».
Conseil : vous pouvez définir un comportement par défaut pour le changement de branche dans Invites. Pour plus d’informations, consultez « Configuration des paramètres de base dans GitHub Desktop ».
- Dans la barre de dépôts, cliquez sur Branche actuelle, puis sur la branche sur laquelle basculer.
- 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.
- Dans la barre de dépôts, cliquez sur Branche actuelle, puis sur la branche à supprimer.
- Dans la barre de menus, cliquez sur Branche, puis sur Supprimer... . Vous pouvez également appuyer sur Maj+Commande+D.
- Dans la barre de dépôts, cliquez sur Branche actuelle, puis sur la branche à supprimer.
- Dans la barre de menus, cliquez sur Branche, puis sur Supprimer... Vous pouvez aussi appuyer sur Ctrl+Maj+D.
Pour aller plus loin
- « Clonage d’un dépôt de GitHub vers GitHub Desktop »
- « Glossaire GitHub » dans le glossaire de GitHub
- « À propos des branches »
- « Les branches en bref » dans la documentation de Git
- « Remiser des changements dans GitHub Desktop »