Installation de l'environnement Android

README.md

Installation de l'environnement Android

Téléchargement et installation d'Android Studio

Premièrement, télécharger Android Studio pour ton OS.

Ensuite, installer Android Studio. Sur Linux, il faut faire les étapes suivantes (pour les autres OS, voir la documentation) :

1. Extraire l'archive zip téléchargée dans le dossier /usr/local
2. Lancer le script /usr/local/android-studio/bin/studio.sh
3. Sélectionner "do not import settings", puis cliquer sur "OK"
4. Dans l'assistant d'installation, utiliser les paramètres par défaut si tu n'as aucune idée des paramètres précis dont tu as besoin
5. Lancer l'installation en cliquant sur "finish" à la dernière étape. L'installation peut être assez longue

Si au cours de l'installation, tu as une erreur "Unable to run mksdcard SDK tool", il suffit d'installer quelques packages de compatibilité, puis de cliquer sur Retry.

Pour Ubuntu :

sudo apt-get install lib32z1 lib32ncurses5 lib32stdc++6

Pour Fedora :

sudo dnf install compat-libstdc++-296.i686 compat-libstdc++-33.i686 ncurses-libs.i686 compat-libstdc++-33.x86_64

Une fois l'installation terminée, la fenêtre d'accueil d'Android Studio doit s'ouvrir.

Création d'un device virtuel

Dans Android Studio, en interface graphique

Dans la fenête d'accueil d'Android Studio, on va créer un nouveau projet, afin d'accéder à Android Studio lui-même. Clique donc sur "Start a new Android Studio project", puis laisse tout par défaut et clique sur "Next", "Next", re "Next", puis "Finish".

Te voilà réellement dans Android Studio. Tu peux maintenant aller dans "Tools > Android > AVD Manager". Clique ensuite sur "Create Virtual Device...", puis sélectionne le device qui te fait plaisir, ou qui correspond précisément à l'appareil sur lequel tu veux faire tes tests, puis clique sur "Next". Pour l'exemple, on prendra un Pixel 2.

Il faut maintenant sélectionner une image système à installer sur le device. Si tu souhaites tester sur une version d'Android spécifique, tu sélectionne cette version, sinon tu peux prendre la première d'Android stable dans l'onglet "Recommended". Il faudra d'abord la télécharger en cliquant sur "Download". Une fois le téléchargement terminé, tu peux sélectionner l'image puis passer à l'étape suivante. Si tu n'as rien de spécial à modifier à cette étape, tu peux cliquer directement sur "Finish".

Voilà, tu as un nouveau device virtuel. Dans la liste des devices, tu peux le lancer pour vérifier qu'il fonctionne, en cliquant sur la petite flèche verte.

En CLI

// TODO

Installation de Cordova

Pour installer Cordova, il te faut node et npm :

npm install -g cordova

Pour vérifier que l'installation s'est bien passée :

cordova -h

Il te sera proposé de participer à aux statistiques d'utilisation, up to you !

Préparation de l'application

D'abord il va falloir se placer dans le dossier de l'application qu'on veut tester.

Génération des icônes

Pour pouvoir générer les icônes, il faut installer imagemagick. Pour ça, tu peux suivre les indications de la documentation de splashicon-generator.

Ensuite, tu peux lancer la commande suivante :

yarn mobile:icon

Installation des dépendances Cordova

Pour installer les dépendances Cordova de l'app mobile, il faut lancer la commande suivante :

yarn mobile:prepare

En cas d'erreur disant que le dossier courant n'est pas un projet cordova, lancer la commande suivante :

mkdir src/targets/mobile/www

Cette erreur est due au fait que Cordova ne considère pas un projet qui ne contient pas de dossier www comme un projet cordova. Mais puisque ce dossier contient le résultat d'un build, il n'est logiquement pas versionné dans git.

Build de l'application

Avant de pouvoir lancer le build, il faut ajouter quelques petites choses à ton PATH :

# dans ton .bashrc, ou .zshrc, ou .*rc...
export ANDROID_HOME=$HOME/Android/Sdk
export PATH="/usr/local/android-studio/bin/gradle/gradle-4.1/bin:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools:$PATH"

Puis on va changer les droits pour pouvoir exécuter les outils dont on a besoin avec un user normal :

sudo chmod -R 755 /usr/local/android-studio/bin/gradle/gradle-4.1/bin

Maintenant on peut lancer le build :

yarn build:mobile

# ou

yarn watch:mobile

Lancement de l'application

Dans un émulateur

Pour lancer l'application dans un émulateur :

yarn android:run:emulator

Sur un device

Pour lancer l'application sur un vrai device :

yarn android:run