Introduction
GitHub Desktopest une application gratuite, open source qui vous permet d’utiliser du code hébergé sur GitHub ou d’autres services d’hébergement Git. Avec GitHub Desktop, vous pouvez effectuer des commandes Git, telles que la validation et l’envoi de modifications, dans une interface utilisateur graphique, plutôt que d’utiliser la ligne de commande. Pour plus d’informations, consultez « À propos de GitHub Desktop ».
Ce guide vous aidera à bien démarrer GitHub Desktop en configurant l’application, en authentifiant votre compte, en configurant les paramètres de base et en introduisant les principes fondamentaux de la gestion des projets avec GitHub Desktop. Vous serez en mesure d’utiliser GitHub Desktop pour collaborer sur des projets et vous connecter à des référentiels distants après avoir travaillé dans ce guide.
Vous pouvez trouver utile d’avoir une compréhension de base de Git et GitHub avant de commencer à utiliser GitHub Desktop. Pour plus d'informations, consultez les articles suivants.
GitHub Desktopest un projet open source. Vous pouvez voir la feuille de route, contribuer au projet, ou ouvrir un problème pour faire part de vos commentaires ou demander des fonctionnalités. Pour plus d'informations, consultez le dépôt desktop/desktop.
Partie 1 : Installation et authentification
Vous pouvez installer GitHub Desktop sur n’importe quel système d’exploitation pris en charge. Pour plus d’informations, consultez « Systèmes d’exploitation pris en charge pour GitHub Desktop ».
Pour installer GitHub Desktop, visitez la page de téléchargement pour GitHub Desktop. Pour plus d’informations, consultez « Installation de GitHub Desktop ».
Une fois que vous avez installé GitHub Desktop, vous pouvez authentifier l’application avec votre compte sur GitHub ou GitHub Enterprise. L’authentification vous permet de vous connecter à des référentiels distants sur GitHub ou GitHub Enterprise.
-
Avant de pouvoir vous authentifier auprès GitHub ou GitHub Enterprise, vous aurez besoin d’un compte. Si vous êtes membre d’une organisation qui utilise GitHub Enterprise Server et que vous n’avez pas de compte, contactez votre administrateur de site.
-
Dans la barre de menus, sélectionnez GitHub Desktop, puis cliquez sur Préférences.
-
Dans la fenêtre « Options », dans le volet Comptes , cliquez sur le bouton « Se connecter » approprié. Utilisez Se connecter à GitHub Enterprise pour vous connecter à GitHub Enterprise Server ou GitHub Enterprise Cloud avec résidence des données.
-
Suivez les étapes pour vous connecter. Pour plus d’informations sur l’authentification, consultez Authentification auprès de GitHub dans GitHub Desktop.
-
Avant de pouvoir vous authentifier auprès GitHub ou GitHub Enterprise, vous aurez besoin d’un compte. Si vous êtes membre d’une organisation qui utilise GitHub Enterprise Server et que vous n’avez pas de compte, contactez votre administrateur de site.
-
Utilisez le menu Fichier, puis cliquez sur Options.
-
Dans la fenêtre « Options », dans le volet Comptes , cliquez sur le bouton « Se connecter » approprié. Utilisez Se connecter à GitHub Enterprise pour vous connecter à GitHub Enterprise Server ou GitHub Enterprise Cloud avec résidence des données.
-
Suivez les étapes pour vous connecter. Pour plus d’informations sur l’authentification, consultez Authentification auprès de GitHub dans GitHub Desktop.
Partie 2 : Configuration et personnalisation GitHub Desktop
Une fois que vous avez installé GitHub Desktop, vous pouvez configurer et personnaliser l’application en fonction de vos besoins.
Vous pouvez connecter ou supprimer des comptes sur GitHub ou GitHub Enterprisechoisir un éditeur de texte ou un interpréteur de commandes par défaut, modifier votre configuration Git, modifier l’apparence des GitHub Desktopboîtes de dialogue système, personnaliser les préférences de confidentialité dans la GitHub Desktop fenêtre Paramètres. Pour plus d’informations, consultez « Configuration des paramètres de base dans GitHub Desktop ».
Vous pouvez connecter ou supprimer des comptes sur GitHub ou GitHub Enterprise, choisir un éditeur de texte ou un interpréteur de commandes par défaut, modifier votre configuration Git, modifier l’apparence des GitHub Desktopboîtes de dialogue système, et définir des préférences de confidentialité dans la GitHub Desktop fenêtre Options. Pour plus d’informations, consultez « Configuration des paramètres de base dans GitHub Desktop ».
Partie 3 : Contribution aux projets avec GitHub Desktop
Après l’installation, l’authentification et la configuration de l’application, vous êtes prêt à commencer à utiliser GitHub Desktop. Vous pouvez créer, ajouter ou cloner des référentiels et les utiliser GitHub Desktop pour gérer les contributions à vos référentiels.
Création, ajout et clonage de dépôts
Vous pouvez créer un référentiel en sélectionnant Fichier dans la barre de menus «GitHub Desktop » et en cliquant sur Nouveau référentiel.... Pour plus d’informations, consultez Création de votre premier dépôt à l’aide de GitHub Desktop.
Vous pouvez ajouter un référentiel à partir de votre ordinateur local en sélectionnant Fichier et en cliquant sur Ajouter un référentiel local.... Pour plus d’informations, consultez « Ajout d’un dépôt de votre ordinateur local à GitHub Desktop ».
Vous pouvez cloner un référentiel depuis GitHub en sélectionnant Fichier, puis en cliquant sur Cloner le référentiel.... Pour plus d’informations, consultez Clonage et duplication (fork) de dépôts à partir de GitHub Desktop.
Apport de changements dans une branche
Vous pouvez utiliser GitHub Desktop pour créer une branche d’un projet. Les branches isolent votre travail de développement des autres branches du dépôt, ce qui vous permet d'expérimenter les changements de manière sécurisée. Pour plus d’informations, consultez « Gestion des branches dans GitHub Desktop ».
Une fois que vous avez apporté des modifications à une branche, vous pouvez les examiner dans GitHub Desktop et faire un commit pour garder une trace de vos modifications. Pour plus d’informations, consultez « Enregistrement et révision des changements dans votre projet sur GitHub Desktop ».
Si vous souhaitez accéder à vos modifications à distance ou les partager avec d’autres personnes, vous pouvez envoyer vos validations vers GitHub. Pour plus d’informations, consultez « Poussée de changements vers GitHub à partir de GitHub Desktop ».
Collaboration avec GitHub Desktop
Vous pouvez utiliser GitHub Desktop pour créer des tickets ou des pull requests afin de collaborer avec d’autres personnes sur des projets. Les problèmes vous permettent d’effectuer le suivi des idées et de discuter des changements possibles à apporter aux projets. Les demandes de tirage vous permettent de partager les changements proposés avec d'autres utilisateurs, de recevoir des commentaires et de fusionner les changements dans un projet. Pour plus d’informations, consultez « Création d’un problème ou d’une demande de tirage (pull request) à partir de GitHub Desktop ».
Vous pouvez consulter vos propres pull requests ou celles de votre collaborateur dans GitHub Desktop. Consulter une pull request dans GitHub Desktop vous permet d’examiner les modifications proposées et d’apporter des modifications supplémentaires en ouvrant les fichiers et les dépôts du projet dans votre éditeur de texte par défaut. Pour plus d’informations, consultez « Visualisation d’un pull request dans GitHub Desktop ».
Maintien de la synchronisation de votre dépôt local
Quand vous apportez des changements à vos dépôts locaux ou quand d'autres personnes apportent des changements aux dépôts distants, vous devez synchroniser votre copie locale du projet avec le dépôt distant. GitHub Desktop peut maintenir votre copie locale d’un projet synchronisée avec la version distante en poussant et en récupérant des commits. Pour plus d’informations, consultez « Synchronisation de votre branche dans GitHub Desktop ».