Contrôle de version facile avec Git dans Android Studio

Comme vous le savez, il est recommandé de toujours utiliser la gestion de contrôle de source (SCM) pour vos projets, même personnels. Savez-vous qu'Android Studio a une intégration étonnante avec Git pour la gestion du contrôle de source? Si vous ne saviez pas ou n'avez pas l'expérience de l'utiliser, continuez à lire ce post. Même si vous avez déjà utilisé l’intégration Git d’Android Studio, vous pouvez toujours apprendre quelques astuces utiles dans cet article..

Je vais vous montrer les nombreuses fonctionnalités de la prise en charge de Git dans Android Studio et la facilité avec laquelle il est facile d'effectuer les différentes opérations de Git (validation, diffusion, extraction, branche, etc.) depuis Android Studio.

Dans ce didacticiel, je vais vous présenter la liste des fonctionnalités SCM disponibles dans Android Studio. Nous allons examiner les domaines suivants:

intégrer un nouveau projet Android Studio avec Git
travailler avec GitHub ou Bitbucket
explorer le Contrôle de version la fenêtre
commet
branches
pousser et tirer depuis un dépôt distant

Conditions préalables

Pour pouvoir suivre ce tutoriel, vous aurez besoin de:

une compréhension de base du système de contrôle de version distribué par Git
Android Studio 3.0 ou supérieur

1. Créer un projet Android Studio

Lancez Android Studio et créez un nouveau projet (vous pouvez le nommer GitApplicationDemo) avec une activité vide appelée Activité principale.

2. Intégration de Git

Une fois votre projet Android Studio configuré, cliquez sur le bouton VCS menu, survolez le Importer dans le contrôle de version menu et sélectionnez Créer un référentiel Git…

Puis sélectionnez le dossier parent supérieur de votre projet Android Studio..

Clique le D'accord bouton pour initialiser le projet avec Git. Sous le capot, Android Studio exécute la commande Git:

git init

Pour rappel, voici ce que cette commande va faire:

Cette commande crée un référentiel Git vide, essentiellement un .git répertoire avec sous-répertoires pour objets, refs / têtes, refs / tags, et des fichiers modèles. Une initiale TÊTE le fichier faisant référence à la tête de la branche principale est également créé.

Un dialogue d'information apparaîtra:

Cela nous parle d'un fichier nommé vcs.xml à l'intérieur de .idée dossier. Ce dossier contient uniquement les paramètres spécifiques au projet. Notez qu'il s'agit du format utilisé par toutes les versions récentes d'IntelliJ IDEA..

Idéalement, les fichiers dans le .idée/ ne devrait pas atteindre Git-donc vous devriez l'ajouter à .gitignore.

Par défaut, nous passons à la branche principale. Vous pouvez toujours afficher la branche actuelle de votre projet dans le coin inférieur droit d'Android Studio..

3. Intégration avec GitHub ou Bitbucket

Vous pouvez facilement travailler sur n'importe lequel de vos référentiels de code source Android se trouvant dans un compte GitHub ou Bitbucket dans Android Studio. Laissez-moi vous montrer comment faire.

Aller vers Fichier> Nouveau> Projet depuis le contrôle de version> GitHub.

(Si vous souhaitez travailler sur un dépôt de Bitbucket, sélectionnez Bitbucket au lieu. Si vous souhaitez simplement copier un dépôt Git d’Internet sur votre ordinateur local, sélectionnez le Git option de menu.)

Ensuite, entrez vos identifiants de compte GitHub et cliquez sur S'identifier.

Si la connexion a réussi, le Référentiel de clonage dialogue va apparaître. Cette boîte de dialogue affiche une liste déroulante contenant une liste de référentiels sur GitHub que vous possédez ou sur lesquels vous avez travaillé..

Cliquez sur Cloner cloner le référentiel sur votre machine locale dans le répertoire parent déjà sélectionné.

4. La fenêtre de contrôle de version

Après avoir lancé avec succès notre projet Android Studio avec Git, Android Studio affiche le Contrôle de version la fenêtre. Clique sur le Contrôle de version onglet (en bas à gauche d'Android Studio) et explorons ce que nous avons là. Notez que vous pouvez utiliser Alt-9 pour ouvrir cette fenêtre rapidement.

Dans cette fenêtre, nous avons trois onglets différents: Changements Locaux, Console, et Bûche.

Les changements locaux Tun B

Ceci affiche la liste des fichiers qui ont été modifiés localement (sur votre propre ordinateur) et non encore validés dans le référentiel..

Jetons un coup d’œil aux barres d’outils disponibles lorsque vous êtes dans le Changements locaux languette.

Cliquez sur cette icône pour actualiser le statut de vos fichiers dans le lieu de travail actuel. Le raccourci est Contrôle-F5.
Lorsque vous cliquez sur cette icône, vos modifications en cours seront validées. Le raccourci est Contrôle-Alt-Z.
Cliquez sur cette icône pour annuler les modifications sélectionnées..
Cliquez sur cette icône pour créer une nouvelle liste de modifications. Notez qu'une liste de modifications est un ensemble de modifications de fichiers qui représente une modification logique du code source. Le raccourci est Alt-Insert.
Cliquez sur ce bouton pour supprimer la liste de modifications sélectionnée..
Pour activer une liste de modifications active, cliquez simplement sur cette icône..
Pour déplacer un fichier sélectionné vers une autre liste de modifications, cliquez sur cette icône..

Cliquez sur cette icône pour la développer et voir tous les fichiers..
Cliquez sur cette icône pour réduire tous les fichiers..
Cliquez sur cette icône pour afficher les fichiers modifiés regroupés par dossiers..
Cliquez sur cette icône pour copier le chemin du fichier sélectionné dans le presse-papiers du système..
Cliquez sur cette icône pour afficher le noeud des fichiers ignorés avec la liste des fichiers existants ignorés par Git..
Cliquez sur cette icône pour configurer la liste des fichiers qui seront ignorés par Git..
Cliquez sur cette icône pour ouvrir le Extrait Diff volet permettant de comparer le fichier actuel à la dernière révision validée.

La console tun B

Dans cet onglet, nous voyons le résultat de l'exécution de commandes liées à Git. Notez que vous ne pouvez pas écrire de commandes Git dans cet onglet, mais plutôt dans la fenêtre du terminal d'Android Studio..

L'onglet Journal

Cet onglet affiche toutes les modifications qui ont été validées dans toutes les branches du référentiel local et distant. Dans cet onglet, vous pouvez parcourir les commits vers toutes les branches..

Le champ de recherche est utilisé pour rechercher les commits ayant la chaîne entrée ou une expression régulière.

Cette liste déroulante utilisée pour filtrer les commits par branche. Pour afficher tous les commits locaux et distants, sélectionnez simplement Tout (le défaut).
Pour filtrer les commits par l'auteur, utilisez cette liste déroulante. Vous devrez taper le nom de l'auteur pour voir ses commits. Sélectionner Tout pour afficher les commits de tous les utilisateurs.
Utilisez cette liste déroulante pour filtrer les validations selon une plage de temps ou pour une date spécifique. Pour être précis sur la date, cliquez simplement sur Sélectionner et choisissez la date. Sélectionner Tout voir les commits faits à toutes les dates.
Utilisez cette liste déroulante pour filtrer les validations en fonction du chemin des fichiers modifiés..
Ce bouton (IntelliSort) permet de visualiser plus facilement les fusions en affichant d’abord les validations entrantes, directement sous la validation de fusion..
Si ce bouton est activé, les longues branches sont affichées en entier, même si elles ne contiennent pas de commits..
Utilisez ce bouton pour actualiser la liste des commits du projet..
Pour aller à un hachage, une balise ou une branche, utilisez simplement ce bouton.
Cliquez sur ce bouton pour appliquer les modifications du commit sélectionné à la branche actuelle..
Cliquez sur ce bouton pour mettre en surbrillance les commits de la branche sélectionnée qui n'ont pas encore été appliqués à la branche actuelle..

Vous pouvez en apprendre plus sur le Contrôle de version fenêtre d'outils dans la documentation IntelliJ IDEA.

5. S'engager

Vous remarquerez que lorsque nous avons configuré l'intégration de Git avec notre projet Android Studio, la couleur de notre nom de fichier est devenue brune. Selon la documentation officielle d'IntelliJ IDEA, pour les fichiers avec des étiquettes brunes:

Le fichier existe localement, mais ne se trouve pas dans le référentiel et il n'est pas prévu de l'ajouter..

Voyons maintenant comment faire un commit dans Android Studio. Mais d’abord, nous devons ajouter nos modifications dans le répertoire de travail à la zone de transfert. Dans la console, nous utiliserions le git ajouter commander.

git ajouter  ||

Mais nous pouvons le faire directement depuis Android Studio. Sélectionnez le Fichiers non versionnés menu déroulant dans le Changements Locaux languette, clic-droit et allez à Git> Ajouter Ou utiliser Contrôle-Alt-A. Rappelez-vous que la sélection du dossier racine ajoutera tout ce qu'il contient à la zone de stockage intermédiaire..

Vous constaterez maintenant que les couleurs de l'étiquette de votre fichier sont passées du marron au vert. Voici ce que dit la documentation IntelliJ IDEA sur les noms de fichiers de couleur verte:

Le fichier est programmé pour être ajouté au référentiel.

Pour en savoir plus sur les différentes couleurs qu'un nom de fichier peut avoir en fonction de l'état du fichier dans Android Studio (IntelliJ IDEA), consultez la documentation sur l'état du fichier.

Pour finalement valider nos modifications, cliquez sur le bouton valider les modifications dans la fenêtre. Changements Locaux onglet, et le Valider les modifications dialogue va s'ouvrir.

Ici, nous pouvons sélectionner ou désélectionner les fichiers à inclure dans ce commit. Par défaut, tous les fichiers intermédiaires sont vérifiés..
Écrivez votre message de validation à l'intérieur ici. Si vous avez déjà écrit un message de validation, il sera affiché ici par défaut..
Sélectionnez la ou les opérations à effectuer avant de vous engager dans Git..
Comparaison côte à côte des fichiers modifiés.
Avec ce bouton déroulant, vous pouvez valider et pousser ou simplement commettre.

Donc, pour faire un commit, écrivons un message de commit:

Commit initial

Sélectionner Commettre dans le Commettre liste déroulante pour enfin valider vos modifications. Notez que vous pouvez utiliser le raccourci Control-K valider des modifications à tout moment depuis Android Studio.

Si vous revisitez maintenant le Changements Locaux onglet dans le Contrôle de version fenêtre, vous ne verrez plus aucun de vos fichiers y figurer, car nous les avons envoyés avec succès dans notre référentiel local..

Notez que vous pouvez également accéder à VCS> Git> Commit File… s'engager et VCS> Git> Ajouter ajouter un fichier pour la mise en scène. En outre, vous pouvez cliquer sur l’icône des modifications de validation dans la barre d’outils principale d’Android Studio pour effectuer rapidement une validation (ou une validation et une transmission)..

Dans notre MainActivity.kt classe, j’ai fait une simple modification dans la classe en redéfinissant pour résumer(). Vous remarquerez que la couleur du nom de fichier après la modification est maintenant bleue; cela signifie que nous avons modifié le fichier.

Affichage du journal de validation

Maintenant, revisitez le Contrôle de version fenêtre une fois de plus et aller à la Bûche languette. Ce que vous allez voir maintenant, ce sont les engagements qui ont été faits pour ce projet. Pour obtenir plus de détails sur un commit, cliquez dessus.

Ce volet principal affiche tous les commits du projet en fonction du filtre sélectionné. En d'autres termes, cela nous montre l'historique des commits.
Ce volet affiche les fichiers et dossiers affectés par la validation sélectionnée dans le volet Historique des validations..
Ce volet affiche plus de détails sur le commit sélectionné..

En cliquant avec le bouton droit sur une validation, vous pouvez également voir un menu qui vous permet de copier le numéro de révision, créer un patch, extraire une révision, créer une branche à partir de cette validation, créer une nouvelle balise et rétablir la branche actuelle sur cette validation..

Voyons maintenant comment afficher quel code a été ajouté, modifié ou supprimé. En d'autres termes, nous voulons vérifier-dans plus en détail les modifications apportées.

Cliquez simplement sur l'icône show diff au-dessus de la fenêtre où sont affichés les fichiers concernés par la validation. Un raccourci est d'utiliser Contrôle-D ou double-cliquez sur le fichier ou le dossier.

Ce que vous verrez est un Montrer Diff boîte de dialogue, montrant les différences entre le commit précédent et le commit sélectionné.

Une zone de couleur verte dans le fichier met en évidence les lignes qui ont été ajoutées au fichier. Vous devriez en voir certaines si vous suivez le mouvement. Les zones grises soulignent les lignes qui ont été supprimées. Et le bleu met en évidence les lignes qui ont été modifiées. Essayez d’explorer les filtres et les boutons d’icône disponibles en haut de la fenêtre. Montrer Diff dialogue pour en savoir plus.

Notez que vous pouvez également voir les modifications apportées aux images dans Montrer Diff dialogue!

En cliquant avec le bouton droit sur un fichier, vous avez également la possibilité de voir la différence entre la dernière validation et la validation actuelle de ce fichier-show diff (raccourci Contrôle-D). Vous pouvez également éditer la source (F4), ouvrez la version dans le référentiel, annulez les modifications sélectionnées, affichez l'historique de la révision et affichez les détails de la validation pour ce fichier.

6. Créer une branche Git

La branche principale sera en cours par défaut. Cependant, il est recommandé de toujours vous séparer du maître et de travailler sur une branche distincte, spécifique à une fonctionnalité. Lorsque vous avez fini de coder votre fonctionnalité (et lorsque vous avez testé vos modifications), vous fusionnez vos modifications dans la branche principale..

Voyons comment créer une branche à partir du maître.

Allez dans le coin inférieur droit d’Android Studio et cliquez sur le bouton Git: maître menu déroulant.

Clique sur le Nouvelle branche bouton.

Entrez le nom de la branche. Dans notre cas, utilisez dev.

Enfin, cliquez sur le D'accord bouton pour Android Studio pour créer automatiquement le devbranche et aussi checkout à cette branche.

Nous sommes actuellement dans le devbranche. Comme vous pouvez le voir ci-dessous:

Sous le capot, Android Studio exécute la commande:

 git checkout -b dev

Notez que nous pouvons également créer une nouvelle branche en allant à VCS> Git> Branches> Nouvelle branche.

7. Fusion des branches de Git

À l'intérieur de dev branche, il suffit de créer une activité de base ProfileActivity.kt et ses fichiers de mise en page et validez vos modifications. Nous allons voir comment fusionner devmaîtriser directement dans Android Studio.

Allez vérifier à partir de la branche actuelle (dev) à la branche master (ce qui signifie que nous passons de devau maître).

Fusionner, Commander, Supprimer, Comparer, Renommer une branche

Si vous cliquez sur une branche, vous verrez quelques opérations que vous pouvez effectuer sur cette branche. Les opérations comprennent la fusion, la comparaison de deux branches, le changement de nom de la branche, la refonte de la base, l'extraction et la suppression de la branche..

Nous allons voir comment fusionner une branche dans ce post. Dans la branche principale, fusionnez le dev branche en naviguant vers le dev branche et en cliquant Fusionner dans le menu.

C'est tout! Nous avons maintenant fusionné avec succès notre branche de développement avec la branche principale.

Dans les coulisses, Android Studio exécute la commande:

Git Merge Dev

Notez que nous pouvons également effectuer une fusion avancée directement dans Android Studio. Nous sommes en mesure de spécifier la stratégie de fusion (Résoudre, Récursif, Octopus, Ours ou Sous-arbre) ou de ne pas utiliser le mode de fusion rapide..

Pour le configurer lors de la fusion, accédez à VCS> Git> Fusionner les modifications…

Ici, vous pouvez sélectionner plusieurs branches à fusionner, sélectionner la stratégie de fusion et écrire un message de validation. Il est vivement recommandé de bien comprendre ces stratégies de fusion et de décider s’il faut utiliser le mode Avance rapide avant de fusionner..

8. Pousser vers un référentiel distant

Chaque projet Git doit avoir un référentiel distant ou central où d’autres développeurs peuvent collaborer sur le projet depuis n’importe où dans le monde. Dans Android Studio, il est également possible de transférer nos commits ou modifications vers un référentiel distant. Pour ce faire, accédez à VCS> Git> Poussez…

Ici, nous pouvons ajouter l’URL du dépôt distant en cliquant sur le bouton Définir à distance lien dans le Push Commits dialogue qui apparaît. Enfin, cliquez sur le Pousser bouton lorsque vous avez terminé! Un raccourci est d'utiliser Control-Shift-K.

Android Studio exécute la commande suivante dans les coulisses:

git push

Vous pouvez également effectuer rapidement une validation en cliquant sur l’icône des modifications de validation dans la barre d’outils principale ou en utilisant Control-K.

9. Extraire d'un référentiel distant

Pour mettre à jour votre projet (pour effectuer un prélèvement) avec les dernières modifications apportées au référentiel distant (vous devez déjà avoir ajouté l’origine distante), accédez à VCS> Git> Pull. Ceci mettra automatiquement à jour votre projet Android Studio avec le code le plus récent du référentiel distant..

Pour lancer un pull, vous pouvez également cliquer sur l’icône Mise à jour du projet dans la barre d’outils principale ou utiliser le bouton Contrôle-t raccourci.

Si vous faites cela, Android Studio exécutera le Git tirez commande dans les coulisses:

git pull

Notez que si vous rencontrez un conflit de fusion en tirant ou en poussant, Android Studio affiche une boîte de dialogue très pratique pour les conflits de fusion qui vous aidera à résoudre ce conflit..

Conclusion

Dans ce tutoriel, vous avez appris à quel point il est facile d’exécuter différentes opérations Git que vous pouvez généralement effectuer sur la ligne de commande ou dans le terminal. L'utilisation des outils Git d'Android Studio permet de collaborer plus facilement sur des projets Android avec d'autres développeurs..

Pour en savoir plus sur le codage pour Android, consultez certains de nos autres cours et tutoriels ici sur Envato Tuts.+!

Code