Ce tutoriel a pour but de vous permettre de push vos projets android vers votre repository git via Android Studio.

 

Présence et « Test » Git

 

Vous devez dans un premier temps vérifier si GIT est installé sur votre Ordinateur pour cela, lancez Android Studio, dans le projet que vous voulez push vers votre git :

Windows : File > Settings > Version Control > Git
Mac : Android Studio > Preferences > Version Control > Git

GitCheck

Dans le cas ou la configuration de GIT n’est pas présente et renvoi une erreur en cliquant sur le bouton « Test« ; Rendez vous sur : Técharger GIT

Téléchargez la version selon votre système d’exploitation.
Lors de l’installation vérifiez le chemin d’installation, il vous permettra de le notifier dans le champs précédent (Path to Git executable)
Windows : C:\Program Files\Git
Mac : /usr/bin/git

Pour les utilisateurs Windows, il est préférable de sélectionner l’option d’installation Git Bash :

Git Bash

 Mise en place du Version Control Integration

Nous allons initialiser l’utilisation de GIT sous Android Studio en activant le VCI (pour les projets ayant été initialisé sans version control)
Windows / Mac : VCS > Enable Version Control Integration..

VcsEnable1

Sélectionnez Git dans la liste déroulante, constatez qu’une configuration est possible avec la plupart des outils..

VcsEnable2

Une fois le VCS activé, le menu VCS change et donne accès aux outils d’un outils de gestion GIT et notifiant dans les Projects Files d’Android Studio les fichiers non envoyé vers le repository via un jeu de couleur.

VCSActive

Mise en place du Git Ignore

gitIgnore

Téléchargez le .gitignore et mettez le à la racine de votre projet Android. Il permettra  de ne pas Push des fichiers propre à votre machine et non utile pour le fonctionnement de l’application. (Il se peut que votre navigateur interprète le fichier; Copiez le contenu et collez le dans un fichier; renommez le en « .gitignore » une fois enregistré, dans votre Gestionnaire de fichier/Finder;
Sous Windows pensez à activer les fichiers cachés ;
Sous Mac :
#defaults write com.apple.finder AppleShowAllFiles YES
#killall Finder

 Configuration du repository distant

Windows :
Rendez vous dans votre répertoire GIT, en général – C:\Program Files\Git
Ouvrez git-bash (donnée via l’installation spécifique de git)
# cd /chemin/vers/Projet/Android
# git remote add origin ssh://user@adresseWeb/opt/git/repository.git

Mac :
Ouvrez le Terminal
# cd /chemin/vers/Projet/Android
# git remote add origin ssh://user@adresseWeb/opt/git/repository.git

Ajout De Git en Local

Windows / Mac : VCS > Git > Add

vcsadd

Maintenant les fichiers sont ajouté au GIT en local, dans l’attente de Push vers le repository git.

Récupération des configurations du Repository (GitFlow)

Dans le cas d’une initialisation et utilisation de la branche develop pour la gestion du projet, nous devons Pull le projet afin d’ensuite utiliser la branche « develop », la ou vous enverrez votre code sur le repository distant.

Capture d’écran 2017-05-04 à 17.13.09

Sélectionnez la double flèche de recherche afin de récupérer les branches du repository distant, sélectionnez « origin/develop » et lancez le Pull.

pull

Configuration pour utilisation de la branche Develop

 

Windows :
Rendez vous dans votre répertoire GIT, en général – C:\Program Files\Git
Ouvrez git-bash (donnée via l’installation spécifique de git)
# cd /chemin/vers/Projet/Android
# git branch --set-upstream develop origin/develop

Mac :
Ouvrez le Terminal
# cd /chemin/vers/Projet/Android
# git branch --set-upstream develop origin/develop

 

Nous allons maintenant définir la branche  sélectionnée par défaut lors de l’envoi vers le repository distant.

develop1

develop2

On observe que la branche actuelle est la master, que l’on remplace par la develop via l’option Checkout – Les branches locales et distantes doivent être égales sous peine d’erreur.
#Can't update: no tracked branch
No tracked branch configured for branch master.
To make your branch track a remote branch call

 

La configuration est maintenant terminée, nous allons push notre premier commit.

  Procédure d’envoi vers le repository distant

Nous allons détecter et nommer un commit  : VCS > Commit Changes…
commit
 

 

 

 

Nous arrivons sur l’interface de mise en forme du commit

Capture d’écran 2017-05-05 à 09.38.08 (1) Lors de votre premier commit uniquement sur un projet , il est obligatoire de sélectionner tout les fichiers du projet, notamment ceux contenus dans Unversioned Files. Par la suite des sélections différentes seront proposées dans cette interface..

(2) Dans ce cadre, vous notez vos commit , correspondant aux modifications/ajouts que vous avez faits, par exemple mise en place du module A , ajout de l’activité Test..

(3) Dans le cadre Author, vous notez votre nom, permet de notifier dans le commit la personne ayant fait les modification.

(4) Toutes les informations sont indiquées, vous pouvez  maintenant valider le Commit and Push…

 

Validez le commit

Capture d’écran 2017-05-05 à 09.57.01

 

 

 

Nous sommes maintenant sur la validation du push, observons bien que la branche locale develop envoi bien vers la branche distante origin:develop, et non sur la origin:master. Valider par un Push

Capture d’écran 2017-05-05 à 10.09.12

Des identifiants de connexion seront demandés, mot de passe de l’Android Studio & mot de passe SSH du repository.

 

 Une fois le tout validé, Push successful: Pushed 1 commit to origin/develop, votre système d’envoi est fonctionnel.

Capture d’écran 2017-05-05 à 10.15.15

 

Lors de prochains commit/push uniquement les fichiers modifiés seront proposés.

 

 

 

 

 

 

 

 Roy Baptiste – CMRP