Aller au contenu
Table des matières du cours

Leçon 00 — Environnement prêt

Par · cofondateur et Chief Executive Officer de Hábil ·

Avant de lire, sept mots. Une ligne chacun ; les autres mots de la série arrivent dans la leçon où ils servent.

  • Android Studio : le programme où vous écrivez, compilez et lancez l'application.
  • SDK (kit de développement) : les outils et bibliothèques pour compiler et lancer des applications Android. Android Studio le télécharge, mais il vit dans son propre dossier.
  • Émulateur : un téléphone Android qui tourne comme un programme à l'intérieur de votre ordinateur.
  • AVD (appareil virtuel) : la fiche d'un téléphone simulé — modèle, version d'Android, mémoire. L'émulateur démarre un AVD.
  • Virtualisation et accélération : la capacité de votre processeur à faire tourner une autre machine à l'intérieur de lui-même ; avec elle l'émulateur est rapide, sans elle il se traîne.
  • Terminal : la fenêtre où vous tapez des commandes.
  • PATH : la liste des dossiers où le terminal cherche les commandes ; si un outil n'y figure pas, vous devez taper son chemin complet.

Ce que vous en retirez : Android Studio, le SDK et un émulateur qui fonctionnent sur votre machine, avec les versions exactes de la série ; l'émulateur avec votre clavier et votre compte Google ; et le projet de la boutique qui tourne à l'intérieur.

Idée nouvelle de cette leçon (la seule qui est évaluée) : l'environnement Android compte trois pièces — Android Studio, le SDK et l'émulateur — et chacune se vérifie avec une preuve concrète (une commande ou un écran), pas à l'œil.

Une note sur les textes de l'application. Le projet du cours livre ses textes d'écran en espagnol, et les fichiers de lecciones/ ne sont pas traduits : les vérifications automatiques du cours (les verifica) cherchent ces textes exacts. Donc, dans les blocs de code, les sorties de terminal et les maquettes d'écran, les textes restent tels que le projet les contient, et dans la prose la leçon les cite en français et, la première fois, donne l'original entre parenthèses : « La boutique tourne dans votre environnement » (dans le projet, « La tienda corre en tu ambiente »).


La scène

Il est onze heures du soir et l'application de la boutique doit tourner demain à neuf heures. Vous ouvrez Android Studio pour la première fois. Il demande de télécharger des « composants ». Vous dites oui. Vingt minutes plus tard, un téléphone dessiné apparaît à l'écran, avec l'heure et la batterie pleine. Vous tapez votre adresse e-mail pour vous connecter avec Google… et il ne se passe rien. Pas une seule lettre.

Vous essayez le clavier de l'ordinateur dans une autre fenêtre : il fonctionne. Vous revenez au téléphone : rien. Au bout du compte, vous écrivez votre adresse lettre par lettre avec la souris, sur le clavier à l'écran. Puis Google vous demande de scanner un code QR avec votre portable. Vous le scannez. Ça tourne, ça tourne, et il dit que ça n'a pas pu se faire.

Rien de tout cela n'est une faute de votre part. Les deux choses sont arrivées à la personne qui a testé cette leçon avant vous, le 13 novembre 2026, sur un Mac neuf. Toutes deux ont une cause concrète et un correctif d'une ligne. Cette leçon vous les dit avant qu'elles ne vous arrivent, avec les commandes qui vous disent, à chaque étape, si vous êtes sur la bonne voie.


Avant de commencer

Ce dont vous avez besoin :

Convient Ne convient pas
Système Linux sur un processeur x86_64 (la série a été testée sur Linux Mint 22.3), ou un Mac Windows (la série ne le couvre pas) · Linux sur processeur ARM : Android Studio n'y a pas de prise en charge officielle
Mémoire 16 Go de RAM pour Android Studio avec l'émulateur Avec 8 Go, utilisez votre téléphone au lieu de l'émulateur (étape 3)
Disque 20 Go libres. Sur Mac, cela a occupé environ 12 Go : Android Studio 3,3, SDK 4,5, appareil virtuel 3,1 et Gradle 1,1 (mesuré le 13 nov. 2026). Sur Linux Mint 22.3, cela a occupé environ 10 Go : Android Studio 1,6, SDK 3,9 (avec l'image de l'émulateur à l'intérieur), appareil virtuel 1,9 et Gradle 2,4 (mesuré le 18 nov. 2026) Moins : l'appareil virtuel grossit à l'usage
Réseau Pour les téléchargements de cette leçon et la première compilation
Savoir Ouvrir un terminal et utiliser git Kotlin et Android ne sont pas supposés connus

Les versions de la série. Elles ont toutes été testées ensemble à une date donnée. Ce ne sont pas « les plus récentes » : ce sont celles dont nous savons qu'elles fonctionnent entre elles. Si vous en installez d'autres, les résultats des leçons peuvent ne pas coïncider avec les vôtres.

Pièce Version Où la voir
Android Studio Rabbit 2, 2026.2.2 Patch 1 Android Studio › About
Android Gradle Plugin (AGP) 9.4.1 gradle/libs.versions.toml du projet
Gradle 9.6.0 ./gradlew -version
Kotlin 2.4.21 gradle/libs.versions.toml
Java du projet 25 jvmToolchain(25) dans app/build.gradle.kts
Plateforme Android 37 (platforms;android-37.0) sdkmanager --list_installed
Émulateur 37.2.13 emulator -version

Testées le 13 nov. 2026.


Un mot de plus : nom de paquet

Nom de paquet : l'identifiant unique de votre application, comme mx.habil.ejemplo.tienda. Le changer ensuite casserait la connexion avec Firebase. Vous le chercherez à l'étape 5.


Étape 1 · Votre machine convient-elle ? (avant d'installer quoi que ce soit)

Prédisez d'abord. Avant de lancer ce qui suit, écrivez en une ligne : pensez-vous que la virtualisation est activée sur votre processeur ? Comment le sauriez-vous ?

Sous Linux (voici ce que cela a donné sur Linux Mint 22.3 le 18 nov. : x86_64, VT-x, /dev/kvm du groupe kvm et votre utilisateur dans kvm) :

uname -m                                  # doit afficher x86_64
lscpu | grep -i virtualiz                 # doit afficher VT-x (Intel) ou AMD-V (AMD)
ls -l /dev/kvm                            # doit exister
groups                                    # votre utilisateur doit figurer dans « kvm »

Si /dev/kvm n'existe pas, vous ne pouvez pas encore utiliser KVM. Il y a trois causes possibles : la virtualisation est désactivée dans le BIOS/UEFI, vous êtes à l'intérieur d'une autre machine virtuelle (VirtualBox, VMware, Docker : là, l'émulateur accéléré ne tourne pas) ou KVM n'est pas installé. Le test qui tranche est emulator -accel-check, à l'étape 3.

Si votre utilisateur n'est pas dans kvm : cette étape demande le mot de passe d'administration et modifie les permissions de votre utilisateur. Ne la faites que sur votre propre ordinateur ou si la personne qui administre la machine vous l'indique ; dans un laboratoire, n'utilisez pas sudo : demandez qu'on vous ajoute au groupe.

sudo gpasswd -a "$USER" kvm               # vous ajoute au groupe

et fermez la session puis rouvrez-la : le nouveau groupe ne s'applique pas à la session ouverte. Vérifiez avec id -nG. Mesuré sur Linux Mint le 13 nov. : sans le groupe, l'émulateur démarre sans accélération.

Sur Mac :

uname -m                                  # arm64 sur Apple silicon ; x86_64 sur Intel

L'installateur d'Android Studio doit être celui de votre processeur. Sur Mac, l'accélération est fournie par Hypervisor.Framework, qui vient avec macOS : il n'y a rien à activer.

Ce qui le prouve : le verifica du précontrôle sort en vert ou vous dit ce qui manque (objectif 0.1). Le verifica se trouve dans le dépôt de la série. Depuis sa racine : ./lecciones/00-ambiente-listo/verifica. Il se contente de lire, il n'installe ni ne change rien. La première fois, il marque en rouge ce que vous n'avez pas encore fait (l'application ouverte, l'exercice 0.5) : c'est normal. Relancez-le à la fin de la leçon.


Étape 2 · Android Studio et le SDK

Téléchargez Android Studio depuis developer.android.com/studio, dans la version du tableau.

  • Mac : ouvrez le .dmg et glissez Android Studio dans Applications. Si vous utilisez Homebrew, brew install --cask android-studio fait la même chose (c'est ainsi qu'il a été installé lors du test du 13 nov.).
  • Linux : décompressez le .tar.gz et lancez bin/studio.sh depuis votre session graphique. Lors du test (Linux Mint 22.3), le fichier téléchargé correspondait au sha256 publié sur developer.android.com/studio.

À la première ouverture, l'assistant propose de télécharger le SDK. Acceptez les licences, gardez le dossier qu'il propose et notez-le : vous l'utiliserez dans le terminal. Voici ceux que nous avons utilisés lors du test :

Système Dossier du SDK
Mac ~/Library/Android/sdk
Linux ~/Android/Sdk (sur Linux Mint 22.3, le SDK a été installé depuis le terminal dans ce dossier ; si l'assistant vous en propose un autre, utilisez le vôtre)

Maintenant, le terminal. Ajoutez ces lignes à la fin de votre ~/.zshrc (Mac) ou ~/.bashrc (Linux), en remplaçant le dossier par le vôtre, et ouvrez un nouveau terminal :

export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator:$ANDROID_HOME/cmdline-tools/latest/bin:$PATH"

Si sdkmanager n'existe pas, installez les Command-line Tools depuis Android Studio › Settings › Languages & Frameworks › Android SDK › SDK Tools. Ensuite, les pièces de la série :

yes | sdkmanager --licenses > /dev/null
sdkmanager "platform-tools" "emulator" "platforms;android-37.0"
sdkmanager --list_installed

Attention au nom : le paquet est platforms;android-37.0, pas android-37. Avec le nom court, sdkmanager ne trouve rien. Et dans la version de 2026, sdkmanager avertit qu'il est obsolète et que android sdk le remplace ; il fonctionne toujours et la série l'utilise parce que c'est celui que documente developer.android.com.

Ce qui le prouve (objectif 0.2), avec quatre preuves que vous conservez :

  1. Android Studio › About : Rabbit 2, 2026.2.2 Patch 1.
  2. sdkmanager --list_installed : platform-tools, emulator et platforms;android-37.0.
  3. emulator -version : 37.2.13.
  4. Dans le projet (étape 5) : ./gradlew -version affiche Gradle 9.6.0, et le tableau ci-dessus vous dit dans quel fichier vous voyez AGP, Kotlin et jvmToolchain(25).

Le verifica de la 00 contrôle ce qui peut être automatisé ; l'écran About de Studio, c'est vous qui le regardez.


Étape 3 · L'émulateur, avec accélération

Prédisez d'abord. Parmi les trois pièces, laquelle pensez-vous qui mettra le plus de temps à être prête, et quelle sortie vous le prouverait ?

Téléchargez une image Android avec Google. Pour vous connecter avec Google dans la leçon 04, il vous faut une image qui contienne les Google Play services. La série retient google_apis_playstore, qui apporte aussi le Play Store ; une image marquée Google APIs apporte aussi les Play services. Ce qui ne convient pas, c'est une image default (Android sans services Google).

# Mac avec Apple silicon :
sdkmanager "system-images;android-37.0;google_apis_playstore;arm64-v8a"
# Linux x86_64 (mesuré sur Linux Mint 22.3) :
sdkmanager "system-images;android-37.0;google_apis_playstore;x86_64"

Créez l'appareil (remplacez arm64-v8a par x86_64 sous Linux) :

echo no | avdmanager create avd -n tienda37 \
  -k "system-images;android-37.0;google_apis_playstore;arm64-v8a" -d pixel_9

Confirmez l'accélération avant de le démarrer :

emulator -accel-check

Sur le Mac du test, il a répondu 0, Hypervisor.Framework OS X Version 27.0 et accel. Le 0 du début signifie « tout va bien ». Sur Linux Mint 22.3, il a répondu KVM (version 12) is installed and usable., avec le code de sortie 0.

Sous Linux, avdmanager peut afficher Error: Could not load devices from …/devices.xml et créer tout de même l'appareil : lors du test, il s'est retrouvé avec hw.device.name=pixel_9. Vérifiez avec avdmanager list avd.

Démarrez-le :

emulator -avd tienda37

Le premier démarrage prend du temps. Sur le Mac du test (Apple silicon, 32 Go), cela a pris 57 secondes ; un démarrage ultérieur, 24. Votre machine aura son propre chiffre. Quand vous voyez l'écran d'accueil, dans un autre terminal :

adb devices

Une ligne doit apparaître dont le nom commence par emulator- et dont l'état est device. Le numéro change selon les émulateurs que vous avez ouverts (le premier est généralement emulator-5554).

Votre machine n'y arrive pas ? Si vous n'avez pas d'accélération ou si vous avez 8 Go, utilisez votre téléphone Android. Settings › About phone › touchez sept fois « Build number » ; puis Settings › System › Developer options › USB debugging. Branchez-le, acceptez l'avis sur le téléphone et lancez adb devices : il doit apparaître avec son numéro de série et le mot device. Cet avis autorise la clé de cet ordinateur à déboguer votre téléphone jusqu'à ce que vous la révoquiez : n'acceptez-le que sur votre propre ordinateur. Si vous en avez utilisé un emprunté, à la fin allez dans Developer options › Revoke USB debugging authorizations.

Ce qui le prouve : exercice 0.3 (ci-dessous).


Étape 4 · La première fois : votre clavier et votre compte

C'est ici que se produisent les deux choses de la scène.

Le clavier qui n'écrit pas

Un appareil créé depuis le terminal arrive avec le clavier de l'ordinateur désactivé : la ligne hw.keyboard=no dans son fichier config.ini. Cela se corrige avec l'émulateur fermé :

  1. Trouvez le fichier : dans Android Studio, Device Manager › les trois points de tienda37 › Show on Disk. config.ini est là. (C'est presque toujours ~/.android/avd/tienda37.avd/, mais cela change si vous avez défini ANDROID_AVD_HOME.)
  2. Remplacez hw.keyboard=no par hw.keyboard=yes. Si la ligne n'existe pas, ajoutez-la à la fin.
  3. Vérifiez avant de démarrer :
grep '^hw.keyboard=' CHEMIN/config.ini    # doit afficher hw.keyboard=yes ; s'il n'apparaît pas, ne démarrez pas encore

Raccourci pour le chemin habituel (Mac et Linux) :

sed -i.bak 's/^hw.keyboard=no$/hw.keyboard=yes/' ~/.android/avd/tienda37.avd/config.ini

Redémarrez l'émulateur. Maintenant, votre clavier écrit.

Compte et machine de confiance

L'émulateur conserve ce que vous y faites —applications, réglages et la session de votre compte— sur l'ordinateur. C'est pourquoi :

  • Ne vous connectez avec votre compte que sur votre ordinateur personnel ou sur une machine autorisée.
  • Dans un laboratoire ou sur une machine empruntée, utilisez votre propre téléphone (étape 3) ou un compte de test sans données personnelles ; n'y tapez pas le mot de passe de votre compte principal.
  • Si vous vous êtes connecté par nécessité sur une machine qui n'est pas la vôtre, à la fin retirez votre compte et effacez les données de l'émulateur : Device Manager › les trois points de l'appareil › Wipe Data.

Votre compte Google

Dans l'émulateur : Settings › Google › ajoutez votre compte. Si votre compte utilise une clé d'accès (passkey), Google vous montre un code QR à scanner avec votre téléphone. Cette étape relie l'ordinateur et le téléphone par Bluetooth, et l'émulateur n'en dispose pas : lors du test de cette leçon, le QR n'a pas abouti. Si cela vous arrive, touchez « Try another way » et connectez-vous avec votre mot de passe ou avec l'avis qui arrive sur votre téléphone.

Ce qui le prouve : exercice 0.4 (ci-dessous).


Étape 5 · Le projet de la boutique tourne

Le dépôt de la série est public sur GitHub : https://github.com/HabilMX/tienda-app-nativa

Prédisez d'abord. Combien de temps pensez-vous que durera la première compilation, et pourquoi la seconde serait-elle plus rapide ?

git clone https://github.com/HabilMX/tienda-app-nativa.git
cd tienda-app-nativa/lecciones/00-ambiente-listo/inicio
./gradlew -version          # Gradle 9.6.0 et la version de Java
./gradlew installDebug      # la compile et l'INSTALLE sur l'émulateur ou le téléphone ; ne l'ouvre pas

Maintenant, ouvrez-la depuis le tiroir d'applications de l'émulateur ou du téléphone. Vous êtes sur la bonne voie si l'écran « La boutique tourne dans votre environnement » apparaît (dans le projet, « La tienda corre en tu ambiente »).

La première compilation télécharge des bibliothèques et dure plusieurs minutes. Le projet de départ apporte déjà une configuration qui s'explique dans la L01 : ne la modifiez pas ici ; commencez par vérifier que vous pouvez installer et ouvrir l'application.

Avec Claude Code, dans cet ordre

La série utilise Claude Code dans toutes les leçons, toujours de la même manière : vous prédisez → vous demandez → vous lisez ce qu'il a généré → vous lancez le verifica → vous l'expliquez avec vos propres mots. Si vous ne savez toujours pas l'expliquer, arrêtez-vous, revérifiez et demandez une précision avant de continuer.

  1. Prédisez sans ouvrir les fichiers : dans quel fichier pensez-vous que se décide le nom de paquet de l'application ?
  2. Demandez à Claude Code : « Explique-moi la structure de ce projet : ce que fait chaque fichier Gradle et où se décide le nom de paquet ».
  3. Lisez sa réponse et choisissez une affirmation concrète (par exemple, « l'applicationId se trouve dans app/build.gradle.kts »).
  4. Vérifiez-la vous-même dans les fichiers : ouvrez-le et notez dans respuestas/00.md (à la racine du dépôt) l'affirmation, le fichier et la ligne où elle se trouve, par exemple app/build.gradle.kts:8. Si l'affirmation était fausse, notez-le aussi : cela compte tout autant.
  5. Lancez le verifica et expliquez en deux lignes ce que vous avez vérifié.

Ce qui le prouve : exercice 0.5 (ci-dessous).


Vos exercices

Les exercices 0.3 et 0.4 se font sans IA : ce sont des commandes et des écrans que vous devez voir vous-même.

# Vous faites C'est fait quand
0.1 Vous lancez le précontrôle de l'étape 1 Le verifica sort en vert, ou vous avez écrit ce qui manque et comment vous l'avez réglé
0.2 Vous installez Studio et le SDK de l'étape 2 Vous avez les quatre preuves de l'étape 2 et elles coïncident avec le tableau des versions
0.3 Vous démarrez l'émulateur avec accélération, ou vous branchez votre téléphone Vous avez la sortie de emulator -accel-check avec « accel » (ou votre téléphone dans adb devices comme device)
0.4 Vous activez le clavier et ajoutez votre compte Vous écrivez avec votre clavier dans l'émulateur et votre compte apparaît dans Settings › Google
0.5 Vous lancez le projet et vérifiez une affirmation de Claude Code Vous avez ouvert l'application et vous voyez « La boutique tourne dans votre environnement », et vous avez : l'affirmation, le fichier et la ligne où vous l'avez vérifiée, et si elle était vraie

Durée : la première fois, en comptant les téléchargements, prévoyez un après-midi. Sur Linux Mint 22.3, les téléchargements du SDK, l'émulateur (il a démarré en 109 secondes) et la première compilation (3 min 51 s) ont pris 10 minutes montre en main avec un bon réseau ; ajoutez l'assistant d'Android Studio et vos pauses.


Ça ne tourne pas ?

Vous voyez Cause probable Ce que vous faites
sdkmanager: command not found Les Command-line Tools ou le PATH manquent Installez-les (étape 2) et ouvrez un nouveau terminal
sdkmanager ne trouve pas platforms;android-37 Le nom est incomplet C'est platforms;android-37.0
-accel-check n'affiche pas « accel » (Linux) Virtualisation désactivée, vous êtes dans une autre machine virtuelle, KVM non installé ou votre utilisateur hors de kvm Étape 1 : BIOS/UEFI, sortir de la VM, ou le groupe kvm (avec autorisation), et rouvrir la session
L'émulateur met des minutes et se traîne Pas d'accélération Comme la ligne précédente, ou utilisez votre téléphone
Votre clavier n'écrit pas dans l'émulateur hw.keyboard=no Étape 4, avec l'émulateur fermé
Le QR de la clé d'accès n'aboutit pas L'émulateur n'a pas de Bluetooth vers votre téléphone « Try another way »
avdmanager ne reconnaît pas pixel_9 Ce profil n'existe pas dans votre version Lancez avdmanager list device -c et utilisez un nom de la liste
adb devices n'affiche pas votre téléphone Débogage USB désactivé ou avis non accepté Vérifiez l'avis sur l'écran du téléphone
adb devices affiche unauthorized Vous n'avez pas accepté la clé de l'ordinateur Déverrouillez le téléphone, acceptez l'avis et recommencez
Linux ne détecte pas le téléphone en USB Permissions du système (plugdev, règles udev) Dans Android Studio, Tools › Troubleshoot Device Connections ; s'il demande des permissions, faites-le avec la personne qui administre la machine
installDebug s'est bien terminé mais vous ne voyez pas l'application installDebug installe, il n'ouvre pas Ouvrez-la depuis le tiroir d'applications (étape 5)
« Java heap space » à la compilation Mémoire de Gradle Vérifiez que gradle.properties contient -Xmx4g

Pour conclure

Répondez sans relire :

  1. Quelles trois pièces forment l'environnement Android, et avec quelle preuve vérifiez-vous chacune ?
  2. Pourquoi l'émulateur a-t-il besoin d'une image avec Google et pas de n'importe laquelle ?
  3. Vous avez créé l'appareil depuis le terminal et votre clavier n'écrit pas. Que changez-vous, et où ?
  4. Que faites-vous de votre compte Google si la machine n'est pas la vôtre ?

La suite : vous avez maintenant où faire tourner l'application. Dans la L01, vous écrivez le premier écran de la boutique en Compose, et le verifica contrôle ce qui s'affiche sans ouvrir l'émulateur.


Comparez vos réponses

  1. Android Studio (l'écran About), le SDK (sdkmanager --list_installed) et l'émulateur (emulator -accel-check et adb devices).
  2. Parce que se connecter avec Google demande les Google Play services. Les images google_apis_playstore (celle de la série) et celles marquées Google APIs les apportent ; une image default, non.
  3. hw.keyboard=no par hw.keyboard=yes dans le config.ini de l'appareil (vous le trouvez avec Show on Disk), avec l'émulateur fermé, puis vous le redémarrez.
  4. N'y utilisez pas votre compte principal : votre téléphone ou un compte de test. Si vous vous y êtes déjà connecté, retirez-le et effacez les données de l'émulateur avec Wipe Data.

Sources de la leçon

Ouvertes le 13 nov. 2026.

Parlons de votre cas

Vous préférez l'e-mail ? Écrivez-nous à hola@habil.mx