Executer votre application flutter sur un appareil mobile Android

• expliquer pourquoi il faut tester une application sur un vrai téléphone, en plus de l'émulateur ;
• activer les options pour les développeurs et le débogage USB sur un téléphone Android, quelle que soit sa marque ;
• installer le pilote USB nécessaire sous Windows ;
• connecter le téléphone, autoriser l'ordinateur et vérifier la connexion avec adb et flutter devices;
• exécuter, recharger et déboguer une application Flutter sur le téléphone depuis VS Code ou le terminal ;
• utiliser le débogage sans fil (Wi-Fi) pour travailler sans câble ;
• installer une version finale de l'application (APK) sur un téléphone ;
• résoudre seul les problèmes de connexion les plus fréquents.

• les vraies performances : fluidité des animations, temps de chargement, consommation de batterie ;
• le vrai écran : taille, encoche (notch), luminosité, confort de lecture et taille des boutons sous le doigt ;
• les vrais capteurs : appareil photo, GPS, empreinte digitale, accéléromètre, notifications ;
• la surcouche du fabricant : Samsung, Xiaomi, Oppo… modifient parfois le comportement d'Android (gestion de la batterie, permissions).

1.1. Le téléphone

• Noter la version d'Android du téléphone : Paramètres → À propos du téléphone. Les versions récentes de Flutter demandent un Android assez récent ; le débogage sans fil (étape 7) nécessite Android 11 ou plus.
• Charger le téléphone et le déverrouiller pendant toute la manipulation.

1.2. Le câble USB

• Beaucoup de câbles livrés avec des chargeurs ou des accessoires ne servent qu'à charger: ils ne transmettent pas de données et le téléphone ne sera jamais détecté.
• Pour tester un câble : branchez le téléphone et vérifiez que vous pouvez parcourir ses fichiers depuis l'Explorateur Windows. Si rien n'apparaît, changez de câble avant d'aller plus loin.
• Branchez de préférence le câble directement sur l'ordinateur, sans hub ni rallonge USB.

1.3. L'ordinateur

• Exécuter flutter doctor dans un terminal : la ligne Android toolchain doit avoir une coche verte. Sinon, exécuter flutter doctor --android-licenses et relire la leçon Flutter Doctor.

Réglages supplémentaires selon la marque

• Xiaomi, Redmi, Poco : activer aussi Installer via USB et Débogage USB (paramètres de sécurité). Ces options peuvent demander une carte SIM et un compte Xiaomi connecté. Sans elles, l'installation de l'application est refusée.
• Samsung (One UI 6 et plus) : si le débogage USB ne fonctionne pas, vérifier que Blocage automatique (Auto Blocker) est désactivé dans Paramètres → Sécurité et confidentialité: il bloque les commandes envoyées par USB.
• Oppo, Realme : activer aussi Désactiver la surveillance des autorisations si l'installation est bloquée.

Réglages utiles pendant le développement (facultatifs)

• Rester activé: l'écran ne s'éteint pas tant que le téléphone est en charge.
• Afficher les appuis: un point blanc montre où vous touchez l'écran, pratique pour une démonstration projetée en classe.

4.1. Téléphones Google Pixel

1. Dans Android Studio : More Actions → SDK Manager (ou Tools → SDK Manager), onglet SDK Tools.
2. Cocher Google USB Driver et cliquer sur Apply.
3. Si le téléphone n'est toujours pas reconnu : ouvrir le Gestionnaire de périphériques, clic droit sur le téléphone (souvent sous Autres périphériques avec un triangle jaune) → Mettre à jour le pilote → Parcourir mon poste de travail → dossier Sdk\extras\google\usb_driver.

4.2. Autres marques

• Installer le pilote USB du fabricant (par exemple Samsung Android USB Driver, disponible sur le site développeur de Samsung). La page Install OEM USB drivers d'Android Developers donne les liens par fabricant.
• Bien souvent, Windows installe le bon pilote automatiquement au premier branchement : essayez d'abord l'étape 5, et ne revenez ici que si le téléphone n'est pas détecté.

4.3. Linux (Ubuntu)

• Ajouter votre utilisateur au groupe plugdev et installer les règles udev, puis se déconnecter et se reconnecter :

5.1. Brancher et autoriser

1. Déverrouiller le téléphone et le brancher au PC.
2. Si une notification « Recharge de cet appareil via USB » apparaît, la toucher et choisir Transfert de fichiers (certains téléphones ne sont détectés qu'avec ce mode).
3. Une fenêtre « Autoriser le débogage USB ? » s'affiche avec l'empreinte de la clé RSA de l'ordinateur. Cocher Toujours autoriser sur cet ordinateur, puis toucher Autoriser.

5.2. Vérifier la connexion

Méthode A : depuis VS Code (conseillée)

1. Ouvrir votre projet Flutter dans VS Code (ou en créer un : flutter create test_telephone).
2. Cliquer sur le nom de l'appareil dans la barre d'état, en bas à droite, ou ouvrir la palette de commandes (Ctrl + Maj + P) et taper Flutter: Select Device.
3. Choisir votre téléphone dans la liste.
4. Appuyer sur F5 (Run → Start Debugging).

Méthode B : depuis le terminal

7.1. Activer le débogage sans fil

1. Dans Options pour les développeurs, activer Débogage sans fil et accepter le réseau actuel (cocher Toujours autoriser sur ce réseau).
2. Toucher le texte Débogage sans fil (pas l'interrupteur) pour ouvrir son écran : il affiche l'adresse IP et le port du téléphone, par exemple 192.168.1.25:41235.

7.2. Associer le PC (une seule fois)

1. Toucher Associer l'appareil avec un code d'association. Le téléphone affiche un code à 6 chiffres et une adresse d'association avec un autre port, par exemple 192.168.1.25:37099.
2. Sur le PC, exécuter les commandes ci-dessous en remplaçant les adresses par celles affichées sur votre téléphone.

Debug, profile et release

• Pendant le développement, Flutter compile en mode debug: il permet le hot reload et les points d'arrêt, mais l'application est plus lente et affiche le bandeau DEBUG en haut à droite. C'est normal : ne jugez pas les performances dans ce mode.

• n'acceptez la fenêtre « Autoriser le débogage USB ? » que sur votre propre ordinateur ou le poste de la salle de cours ;
• ne cochez jamais Toujours autoriser sur un ordinateur public ;
• à la fin du cours, touchez Révoquer les autorisations de débogage USB si vous avez utilisé un poste partagé ;
• désactivez le Débogage USB et le Débogage sans fil quand vous ne développez pas, surtout avant de brancher le téléphone sur une borne de recharge publique.

1. Relever la marque, le modèle et la version d'Android de votre téléphone.
2. Activer les options pour les développeurs et le débogage USB, puis noter le chemin exact suivi sur votre modèle.
3. Brancher le téléphone et relever la sortie de adb devices et de flutter devices.
4. Créer le projet test_telephone, le lancer sur le téléphone avec F5, puis modifier la couleur du thème et constater le hot reload.
5. Si votre téléphone est sous Android 11 ou plus, refaire le lancement en débogage sans fil, câble débranché.
6. Lancer l'application avec flutter run --release: quelles différences observez-vous avec le mode debug ?
7. Générer l'APK avec flutter build apk --release, l'installer avec adb install et relever la taille du fichier.
8. Rendre un court compte rendu avec vos réponses, les commandes utilisées et une capture d'écran de l'application sur le téléphone.