Enterprise Server 3.15 est actuellement disponible en tant que version finale (RC).

Commit et revue des changements apportés à votre projet dans GitHub Desktop

GitHub Desktop suit tous les changements de tous les fichiers au fur et à mesure que vous les modifiez. Vous pouvez décider comment regrouper les changements pour créer des commits significatifs.

Dans cet article

À propos des commits

Comme l’enregistrement d’un fichier qui a été modifié, un enregistrement de validation change un ou plusieurs fichiers dans votre branche. Git affecte à chaque validation un ID unique, appelé SHA ou hachage, qui identifie :

  • Les modifications spécifiques
  • Quand les modifications ont été apportées
  • Qui a créé les modifications

Lorsque vous effectuez une validation, vous devez inclure un message de validation qui décrit brièvement les modifications. Vous pouvez également ajouter un coauteur aux commits auxquels vous collaborez.

Si les commits que vous effectuez dans GitHub Desktop sont associées au mauvais compte sur GitHub Enterprise Server, mettez à jour l’adresse e-mail figurant dans votre configuration Git à l’aide de GitHub Desktop. Pour plus d’informations, consultez « Configuration de Git pour GitHub Desktop ».

Les administrateurs de référentiel peuvent activer des ensembles de règles pour une branche afin d’appliquer des conventions spécifiques durant le commit. Par exemple, un ensemble de règles peut nécessiter la signature d’une validation ou pour qu’un numéro de problème soit référencé au début d’un message de validation. GitHub Desktop affiche un avertissement et empêche la validation si une validation ne respecte pas les ensembles de règles. Pour plus d’informations, consultez « À propos des ensembles de règles ».

Choix d’une branche et apport de changements

  1. Créez une branche, ou sélectionnez une branche existante en cliquant sur Branche actuelle dans la barre d’outils, puis en sélectionnant la branche dans la liste.

    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. À l’aide de l’éditeur de texte de votre choix, comme Visual Studio Code, apportez les modifications nécessaires aux fichiers de votre projet.

Choix du mode d’affichage des différences

Vous pouvez changer la façon dont les différences sont affichées dans GitHub Desktop en fonction de vos besoins de vérification.

Pour changer la façon dont vous visualisez les différences, dans le coin supérieur droit de la vue des différences, cliquez sur .

  • Pour changer le mode d’affichage de l’ensemble des différences, sous « Affichage des différences », sélectionnez Unifié ou Fractionné. Le mode Unifié montre les changements de manière linéaire, alors que le mode Fractionné montre l’ancien contenu sur le côté gauche et le nouveau contenu sur le côté droit.
  • Pour masquer les changements liés aux espaces blancs et vous concentrer sur les changements plus importants, sélectionnez Masquer les changements liés aux espaces blancs.

Capture d’écran de la vue de différences d’un fichier « README ». Une icône d’engrenage est présentée en orange au-dessus d’une liste déroulante développée affichant les paramètres « Espace blanc » et « Affichage des différences ».

Si vous devez voir une plus grande partie du fichier que celle affichée par défaut dans GitHub Desktop, vous pouvez développer la vue des différences.

  • Pour voir les lignes suivantes au-dessus ou en dessous des changements mis en évidence, cliquez sur la flèche au-dessus ou en dessous des numéros de ligne.
  • Pour voir l’intégralité du fichier, cliquez avec le bouton droit dans la vue des différences, puis cliquez sur Développer le fichier entier.

Capture d’écran de la vue de différences d’un fichier « README ». Sur une ligne « addition » verte, dans un menu contextuel, le curseur pointe sur « Développer le fichier entier ».

Sélection des changements à inclure dans un commit

Au fur et à mesure que vous apportez des changements aux fichiers dans votre éditeur de texte et que vous les enregistrez localement, vous voyez également les changements dans GitHub Desktop.

Sous l’onglet « Changements » de la barre latérale gauche :

  • L’icône rouge indique des fichiers supprimés.

  • L’icône jaune indique des fichiers modifiés.

  • L’icône verte indique des fichiers ajoutés.

  • Pour accéder aux changements ayant fait l’objet d’un stash, cliquez sur Changements avec stash.

  • Pour ajouter tous les changements apportés dans tous les fichiers à un commit unique, cochez la case située en haut de la liste sélectionnée.

    Capture d’écran de l’onglet « Changements ». Au-dessus de la liste des fichiers modifiés, en regard du texte « 3 fichiers modifiés », une case à cocher sélectionnée est indiquée en orange.

  • Pour ajouter tous les changements apportés dans un ou plusieurs fichiers à un seul commit, décochez les cases en regard des fichiers que vous ne voulez pas inclure, ce qui laisse uniquement les fichiers souhaités dans le commit. Vous pouvez cocher/décocher la case avec les touches Spacebar ou Enter après avoir sélectionné un fichier.

Création d’un commit partiel

Si un fichier contient plusieurs changements, mais que vous souhaitez inclure uniquement une partie de ces changements dans un commit, vous pouvez créer un commit partiel. Le reste de vos changements demeure intact, ce qui vous permet d’effectuer des modifications et des commits supplémentaires. Cela vous permet d’effectuer des commits distincts et importants, par exemple pour séparer les changements liés à des sauts de ligne dans un commit, des changements liés à du code ou du texte.

Pour exclure de votre commit les lignes ayant fait l’objet de changements, cliquez sur une ou plusieurs lignes changées afin de faire disparaître ce qui est en bleu. Les lignes restantes surlignées en bleu sont incluses dans le commit.

Capture d’écran de la vue de différences d’un fichier texte. En regard du texte « Je ne veux pas inclure cette ligne », la couleur d’arrière-plan derrière les numéros de ligne est verte, et non bleue.

Abandon des changements

S’il existe des changements non commités que vous ne souhaitez pas conserver, vous pouvez les abandonner. Cela entraîne la suppression des changements apportés aux fichiers sur votre ordinateur. Vous pouvez abandonner tous les changements non commités dans un ou plusieurs fichiers, ou vous pouvez abandonner des lignes spécifiques que vous avez ajoutées.

Les changements abandonnés sont enregistrés dans un fichier daté mis à la Corbeille. Vous pouvez récupérer les changements abandonnés tant que la Corbeille n’a pas été vidée.

Abandon des changements apportés à un ou plusieurs fichiers

  1. Dans la liste des fichiers modifiés, sélectionnez les fichiers dans lesquels vous souhaitez ignorer les modifications depuis le dernier commit. Pour sélectionner plusieurs fichiers, cliquez sur shift et sur la plage de fichiers dans lesquels vous souhaitez ignorer les modifications.

  2. Cliquez sur Ignorer les modifications ou Ignorer les modifications sélectionnées pour ignorer les modifications apportées à un ou plusieurs fichiers, ou Ignorer toutes les modifications pour ignorer les modifications apportées de tous les fichiers depuis la dernière validation.

    Capture d’écran de l’onglet « Changements ». Deux fichiers sélectionnés sont mis en évidence en bleu. Dans un menu contextuel, le curseur pointe sur « Ignorer 2 modifications sélectionnées ».

  3. Pour confirmer les modifications, dans la fenêtre « Confirmer l’abandon des modifications », passez en revue les fichiers affectés, puis cliquez sur Ignorer les modifications.

Abandon des changements apportés à une ou plusieurs lignes

Vous pouvez abandonner une ou plusieurs lignes changées qui ne sont pas commitées.

Remarque : L’abandon de lignes uniques est désactivé dans un groupe de changements entraînant l’ajout et la suppression de lignes.

Pour abandonner une ligne ajoutée, dans la liste des lignes changées, cliquez avec le bouton droit sur le numéro de la ligne à abandonner, puis sélectionnez Abandonner la ligne ajoutée.

Capture d’écran de la vue de différences d’un fichier. Dans un menu contextuel, un curseur pointe sur « Ignorer la ligne ajoutée », mis en évidence en bleu.

Pour abandonner un groupe de lignes changées, cliquez avec le bouton droit sur la barre verticale à droite des numéros de ligne correspondant aux lignes à abandonner, puis sélectionnez Abandonner les lignes ajoutées.

Capture d’écran de la vue de différences d’un fichier. À droite des numéros de ligne, une ligne bleue plus foncée est mise en évidence avec un contour orange.

Écrire un message de commit et pousser vos changements

Une fois que vous êtes satisfait des changements à inclure dans votre commit, écrivez votre message de commit, puis poussez vos changements. Si vous avez collaboré à un commit, vous pouvez également attribuer un commit à plusieurs auteurs.

Remarque : Par défaut, GitHub Desktop enverra (push) l’étiquette que vous créez à votre dépôt avec la validation associée. Pour plus d’informations, consultez « Gestion des étiquettes dans GitHub Desktop ».

  1. En bas de la liste des modifications, dans le champ Résumé, tapez un message de validation court et significatif. Vous pouvez également ajouter des informations supplémentaires sur la modification dans le champ Description.

    Capture d’écran de l’onglet « Changements » dans la barre latérale. À droite d’une image de profil, un champ de texte contenant un message de validation est indiqué en orange.

  2. Si vous le souhaitez, pour attribuer un commit à un autre auteur, cliquez sur l’icône d’ajout de coauteurs, puis tapez le ou les noms d’utilisateurs à inclure.

    Capture d’écran de l’onglet « Changements ». Dans le coin du champ « Description », une icône « personne avec un signe plus » pour l’ajout d’un co-auteur est indiquée en orange.

  3. Sous le champ Description, cliquez sur Commiter dans BRANCHE.

  4. Si la branche dans laquelle vous essayez d’effectuer le commit est protégée, Desktop vous le signale.

    • Pour déplacer vos changements, cliquez sur changer de branche.
    • Pour commiter vos changements dans la branche protégée, cliquez sur Commiter dans BRANCHE.

    Pour plus d’informations sur les branches protégées, consultez « À propos des branches protégées ».

  5. 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.

  6. Si vous disposez d’une demande de tirage basée sur la branche sur laquelle vous travaillez, GitHub Desktop affiche le statut des vérifications effectuées pour la demande de tirage à côté de la section « Branche actuelle » dans la barre du dépôt. Pour plus d’informations sur les vérifications, consultez « Affichage et réexécution des vérifications dans GitHub Desktop ».

    Si aucune demande de tirage n’a été créée pour la branche actuelle, GitHub Desktop vous donne la possibilité d’avoir un aperçu des modifications et d’en créer une. Pour plus d’informations, consultez « Création d’un problème ou d’une demande de tirage (pull request) à partir de GitHub Desktop ».

    Capture d’écran de la vue « Aucune modification locale ». Un bouton intitulé « Prévisualiser une demande de tirage » est mis en évidence avec un encadré orange.

Gestion de votre historique de validation

Si vous devez annuler une validation ou réviser votre historique de validation (pour permettre à un évaluateur de suivre plus facilement vos modifications), GitHub Desktop offre un certain nombre d'options pour la gestion de votre historique de validation. Pour plus d’informations, consultez « Options de gestion des validations dans GitHub Desktop ».

Pour aller plus loin