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
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 :
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..
Sélectionnez Git dans la liste déroulante, constatez qu’une configuration est possible avec la plupart des outils..
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.
Mise en place du Git Ignore
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
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.
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.
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.
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…
Nous arrivons sur l’interface de mise en forme du commit
(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
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
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.
Lors de prochains commit/push uniquement les fichiers modifiés seront proposés.
Roy Baptiste – CMRP