Nous allons sécuriser et partager vos projets développés avec Android Studio grâce à GitHub. GitHub est un service gratuit permettant d’archiver le code source des applications soit pour le partager avec des tiers, soit pour un usage privé.
Nous allons utiliser dans un premier temps GitHub en mode privé. L’idée est de gérer notre projet dans Android Studio, et de copier notre code sur un serveur distant GitHub. Cela permet de travailler sur plusieurs PC, ou à plusieurs collaborateurs.
Nous réaliserons :
- la création d’un compte GitHub
- la création d’un projet dans GitHub
- la connexion d’Android Studio avec notre serveur GitHub.
Il y a 2 façons de démarrer avec GitHub :
- en clonant un projet existant dans GitHub pour le récupérer dans Android Studio
- en poussant le code d’un projet Android Studio vers GitHub (opération push)
Comme notre projet Hello Android a été créé dans Android Studio, nous devrons réaliser la seconde opération.
Création d’un compte GitHub
Rendons-nous sur la page du site github : https://github.com/
En haut à droite nous avons le bouton [Sign Up]. Nous pouvons arriver sur la même page en saisissant directement notre adresse courriel dans la zone centrale.
Nous indiquons notre adresse courriel. Cette adresse sera utilisé par github pour vérifier notre identité à l’étape 5. Nous choisissons notre mot de passe.
Le nom utilisateur username est utilisé pour construire les adresses des projets. Nous verrons que notre projet HelloAndroid sera accessible par l’adresse :
github.com/copier-coder/HelloAndroid/
Le choix du username a un impact sur la visibilité et l’accès à notre code partagé dans GitHub.
Vous pouvez accepter ou non de recevoir des offres produits par courriel.
Nous validons par [Continue].
La vérification du compte se fait par un captcha « Completely Automated Public Turing test to tell Computers and Humans Apart« , demandant de choisir l’image répondant le mieux à la question posée.
Lorsque tout est conforme nous pouvons demander la création du compte par [Create account].
A la création du compte, github nous adresse un code à notre adresse courriel.
Pour paramétrer le compte, GitHub nous demande de préciser l’usage que nous ferons de notre compte GitHub. Dans notre cas, nous voulons juste archiver notre code pour des raisons de sécurité, et éventuellement pouvoir partager notre travail sur plusieurs ordinateurs. Nous choisissons donc [Just me]. Nous n’avons ni coché [Student] ni [Teacher].
Nous n’avons pas besoin de fonctionnalités particulière pour l’instant, donc nus choisissons [Skip personalization]
Le compte est actif, nous pouvons créer notre premier projet.
Création d’un projet dans GitHub
Afin de tester la création d’un projet dans GitHub, nous avons suivi les étapes proposées dans GitHub à partir de [Create repository].
Nous mettons ici les étapes que nous avons suivit.
Toutefois, ce n’est pas la meilleure idée lorsqu’on travail entre Android Studio et GitHub. Nous verrons au paragraphe suivant qu’il est bien plus facile une fois le compte GitHub créé de retourner dans Android Studio et de partager le code avec GitHub depuis Android Studio.
Nous activons [Create repository]
Nous remarquons notre username suivi d’une zone de saisie dans laquelle nous indiquons le nom de notre projet HelloAndroid.
Nous choisissons [Private] pour ce projet, car nous n’attendons pas de mise à jour de la part de collaborateurs.
Nous souhaitons ajouter un fichier ReadMe qui décrira le projet [Add a README file].
Nous n’avons pas choisi d’ajouter le fichier .gitignore, ni une licence.
Nous validons la création du dossier [Create repository].
Le projet a été créé. Nous constatons le lien d’accès au projet (1) copier-coder/HelloAndroid . Ainsi que la propriété private (1).
Nous retrouvons la phrase indiquée dans [Description] lors de la création du projet à l’étape précédente (2). L’icône [crayon](3) permet de lancer le mode édition pour rédiger le fichier README.md.
La rédaction du fichier README se fait dans le langage de mise en page MarkDown (1). Nous indiquons le libellé de changement (2). Puis nous lançons l’opération d’enregistrement [Commit change] (3).
Notre fichier README est créé et le projet finalisé dans GitHub.
Nous voyons dans [Code] le lien https utilisé pour faire référence à notre projet :
https://github.com/copier-coder/HelloAndroid.git
Nous pouvons copier le lien complet avec l’icône situé à droite du lien.
Sécuriser et partager le projet HelloAndroid grâce à GitHub depuis Android Studio
Nous allons maintenant montrer comment Sécuriser et partager nos projets développés avec Android Studio grâce à GitHub sans quitter Android Studio.
La première phase est d’avoir créé son compte GitHub, ce que nous avons fait précédemment dans le paragraphe Création d’un compte GitHub.
La page de notre projet dans Android Studio est la suivante :
Choisir GitHub comme outil de gestion de version dans Android Studio
Le menu VCS permet d’activier un outil de Contrôle de Version [VCS](Version control System). Android Studio permet d’utiliser plusieurs type d’outil de vestion de version dont GitHub. Nous choisisson le menu [Enable Version control Intégration] :
Nous selectionnons Git comme outil de control de version :
Un message d’information confirme la création du répertoire Git en bas à gauche : Created Git repository in…
Le menu VCS est remplacé par le menu Git.
Activer le partage du projet Android Studio vers GitHub
Nous avons directement intégré dans Android Studio les outils pour nous connecter à GitHub : Git>Github>Share Project on GitHub :
Nous pouvons maintenant définir notre projet dans GitHub :
- Le nom du projet dans GitHub
- la description
- l’ajout d’un compte GitHub par [Add account]
On commence par déclarer notre compte GitHub à partir d’un Token [Add account> Log in with Token…]
Nous obtenons l’accès à un bouton pour ajouter un Token [Generate] d’accès à github.com
Nous sommes invité à saisir nos identifiants d’accès par GitHub :
Nous indiquons notre adresse courriel utilisée pour la création du compte GitHub, ainsi que le mot de passe choisi. Puis nous nous enregistrons [Sign in].
Nous arrivons sur GitHub.
En bas de la page, nous avons le bouton [Generate token] :
GitHub génère un Token que l’on peut copier :
Nous collons le Token dans Android Studio :
Une fois le Token ajouté, nous pouvos compléter le sinformation sur le projet. L’identifiant du compte GitHub est visible : github.com/copier-coder. Nous validons le partage avec [Share].
Choisir les fichiers à partager sur GitHub
Nous devons choisir les fichiers que nous voulons partager avec Github. Dans un premier temps, nous choisissons les fichiers sur lesquels nous intervenons :
- MainActivity.java
- AndroidManifest.xml
- activity_main.xml
Selection des fichiers :
Comme c’est la première connexion entre Android Studio et GitHub, nous avons la demande d’authentification qui s’affiche :
Avec le commit, nous avons une analyse du code par Android Studio. Nous avons un message indiquant qu’une chaïne de caractère aurait dî être défini dans les ressources Strings.
Comme il s’agit d’un Warning, nous pouvons passer outre et confirmer le Commit.
Nous voyons la liste des fichiers regroupé dans le Commit. Nous pouvons confirmer le [Push] pour enregistrer les fichiers dans GitHub :
On valide l’autorisation [Autorize GitCredentialManager] :
L’authentification a réussi :
Nous avons un message en bas à gauche confirmant l’initialisation du projet dans GitHub :
Nous allons dans GitHub pour vérifier le changement :
Le nom du projet HelloAndroid est clickable, et nous pouvons aller sur la page du projet :
Présenter le projet sur GitHub avec le fichier README.md
Nous ajoutons le fichier README.md au projet par [Add a README].
Nous validons la création du fichier README par un [Commit new File].
Nous avons montré comment sécuriser et partager nos projets développés avec Android Studio grâce à GitHub, et ce, directement depuis Android Studio.
Modifier un fichier dans Android Studio et enregistrer la modification dans GitHub
Nous allons à titre d’exemple, reprendre la demande de moficiation proposée par Android Studio, à savoir utiliser le fichier ressource Strings.xml pour définir le texte « Hello Android ! ».
Le message Android Studio est le suivant :
…\HelloAndroid\app\src\main\res\layout\Activity_main.xml
Warning:(12,9) Hardcoded string « Hello Android! », should use ‘@String’ resource
Nous identifions la ressource dans le fichier indiqué Activity_main.xml sur la première ligne de la notification, et à la ligne indiquée sur la seconde ligne de la notification (12,9) soit ligne 12 caractère 9.
Nous ajoutons la ressource dans le fichier :
res\values\strings.xml
Notons que le nom de la ressource est strings.xml avec un ‘s’ à string.
La ressource est identifiée par le nom que nous choisissons et qui doit être unique dans le fichier hello_text et la valeur du texte soit Hello Android !
Regardons dans le fichier AndroidManifest.xml comment est utilisé le fichier de ressource Strings.xml : nous voyon android:label= »@string/app_name » :
Nous modifions le fichier AndroidManifest.xml pour qu’il utilise la ressource « @string/hello_text ». Le texte de correspondant est directement visible lorsque nous nous plaçons sur le nom de la ressource : Hello Android !
Nous allons maintenant pousser la modification dans GitHub par le menu Git>Commit…
Nous ajoutons le message de commit, et nous constatons que Android Studio identifie les fichiers qui ont été modifiés :
- activity_main.xml
- strings.xml
Nous confirmons la modification avec [Commit and Push]
Nous retrouvons la liste des changements :
Nous pouvons aller voir les changements dans GitHub
Le fihcier res/values/strings.xml
Le fichier res/layout/activity_main.xml
Android Studio et le paramétrage de la connection à GitHub
Nous pouvons dant le menu Git>Manage Remotes… vérifier le paramétrage du projet :
Nous retrouvons le lien vers le projet dans GitHub, https://github.com/copier-coder/HelloAndroid.git
Le nom du projet dans GitHub doit être unique
Lorsque nous définissons un nom pour un projet dans Android Studio, ce nom est repris lors de la création du partage du projet avec GitHub.
Si le nom du projet existe déjà dans notre GitHub, un message d’avertissement apparait :
Nous pouvons changer le nom d’un projet dans GitHub. Il faut aller sur le projet dans le menu [Settings].
Sur la page, nous avons le nom du pojet avec à côté le bouton [Rename].
Android Studio permet de travailler confortablement avec GitHub
Nous avons vu dans cet article qu’il est très confortable de travailler avec GitHub depuis Android Studio.
Il est inutile de créer le projet dans GitHub.
Nous avons besoin d’un compte GitHub, puis le travail se fait directment dans Android Studio. Nous pouvons :
- activer le partage du projet depuis Android Studio vers GitHub
- pousser des modifications depuis Android Studio ers GitHub
Il est ainsi possible de sécuriser et partager nos projets développés avec Android Studio grâce à GitHub.
Nous avons maintenant mis en place nos outils de travail, nous allons pouvoir commencer la partie développement proprement dite.
Dans le prochain article, nous verrons comment utilisé la WebView dans une application Android.