Paramètres > About phone > appuyez Numéro de build sept fois > saisissez votre code PIN (ou schéma). Un message confirme que vous êtes développeur. Ouvrez Options pour les développeurs et activez le débogage USB ou le débogage sans fil quand vous en avez besoin adb, Android Studio, ou une exécution de Capacitor sur un appareil réel. Les étapes sont les mêmes sur Android 14, 15 et 16; seul le chemin vers Numéro de build change selon la marque (tableau ci-dessous).
À quoi servent les options développeur (et leurs limites)
Les options pour les développeurs sont un menu de paramètres caché destiné aux développeurs d'applications. L'activer ne change rien en soi. Cela révèle simplement des options telles que :
- le débogage USB: permet à un ordinateur de confiance d'exécuter des
adbcommandes, d'installer des builds et de lire les logs. - le débogage sans fil: la même chose via Wi-Fi (Android 11+).
- Rester éveillé: l'écran reste allumé pendant la charge, pratique pour les tests.
- Échelle d'animation: accélérer ou désactiver les animations système, utile pour les tests UI.
- Ne pas conserver les activités: détruit les activités dès que vous les quittez, idéal pour tester la restauration d'état dans une application Capacitor.
- Afficher les appuis / Position du pointeur: utile pour enregistrer des démos et vérifier les zones tactiles.
Vous avez pas besoin des options développeur pour installer un APK depuis un navigateur ou un gestionnaire de fichiers, utiliser la plupart des apps ou recevoir une mise à jour OTA.
Activer les options développeur par marque
| Marque | Où appuyer 7 fois | Où le menu apparaît ensuite |
|---|---|---|
| Google Pixel / Android stock | Paramètres > À propos du téléphone > Numéro de build | Paramètres > Système > Options pour les développeurs |
| Samsung (One UI) | Paramètres > À propos du téléphone > Informations sur le logiciel > Numéro de build | Paramètres > Options pour les développeurs (en bas de liste) |
| Xiaomi, Redmi, POCO (HyperOS) | Paramètres > À propos du téléphone > Version de l'OS | Paramètres > Paramètres supplémentaires > Options pour les développeurs |
| Xiaomi (MIUI plus ancien) | Paramètres > À propos du téléphone > Version de MIUI | Paramètres > Paramètres supplémentaires > Options pour les développeurs |
| OnePlus (OxygenOS) | Paramètres > À propos de l'appareil > Version > Numéro de build | Paramètres > Paramètres système > Options pour les développeurs |
| OPPO / realme (ColorOS / realme UI) | Paramètres > À propos de l'appareil > Version > Numéro de build | Paramètres > Paramètres supplémentaires > Options pour les développeurs |
| Motorola | Paramètres > À propos du téléphone > Numéro de build | Paramètres > Système > Options pour les développeurs |
| Huawei / Honor (EMUI / MagicOS) | Paramètres > À propos du téléphone > Numéro de build | Paramètres > Système et mises à jour > Options pour les développeurs |
Les menus changent d’une version de système d’exploitation à l’autre. Si vous ne trouvez pas « Numéro de build », ouvrez Paramètres et utilisez le champ de recherche : tapez « build number ». Sur la quasi-totalité des appareils Android, la recherche le trouve directement.
Google Pixel (Android 14, 15, 16)
- Ouvrez Paramètres et faites défiler jusqu'à About phone.
- Faites défiler jusqu'en bas et appuyez sur Numéro de build sept fois. Après quelques appuis, un message de compte à rebours s'affiche.
- Saisissez votre code PIN, schéma ou mot de passe.
- Retourner à Paramètres > Système > Options pour les développeurs.
Samsung Galaxy
- Ouvrez Paramètres > À propos du téléphone > Informations sur le logiciel.
- Appuyez sur Numéro de build sept fois et confirmez avec votre code PIN.
- Options pour les développeurs apparaît désormais tout en bas de la liste principale des Paramètres, sous À propos du téléphone.
Xiaomi, Redmi et POCO
- Ouvrez Paramètres > À propos du téléphone.
- Appuyez sur Version de l'OS (HyperOS) ou Version de MIUI (appareils plus anciens) sept fois.
- Accéder à Paramètres > Paramètres supplémentaires > Options pour les développeurs.
Xiaomi adds two extra switches you usually need for development: Installer via USB et Débogage USB (Paramètres de sécurité). Sans « Installer via USB », adb install échoue avec INSTALL_FAILED_USER_RESTRICTED. Leur activation peut nécessiter de se connecter à un compte Xiaomi et d'insérer une carte SIM.
OnePlus, OPPO et realme
- Ouvrez Paramètres > À propos de l'appareil > Version.
- Appuyez sur Numéro de build sept fois.
- Ouvrez Paramètres > Paramètres système > Options pour les développeurs (OnePlus) ou Paramètres > Paramètres supplémentaires > Options pour les développeurs (OPPO, realme).
Huawei et Honor
- Ouvrez Paramètres > À propos du téléphone.
- Appuyez sur Numéro de build sept fois.
- Accéder à Paramètres > Système et mises à jour > Options pour les développeurs.
Si adb ne voit pas d'appareil Huawei en USB, réglez le mode de connexion USB sur Transfert de fichiers lors du branchement.
Numéro de build manquant ou « Cette action est indisponible »
Ligne incorrecte dans À propos du téléphone. En appuyant sur Version Android ou Niveau de correctif de sécurité n’active pas le mode développeur. Sur Samsung, utilisez Informations sur le logiciel > Numéro de build. Sur Xiaomi, utilisez Version de l'OS ou Version de MIUI, et non le nom générique du modèl’en haut.
Profil professionnel ou appareil géré. Les téléphones soumis à des politiques d’entreprise ou scolaires bloquent souvent les options développeur. Vous pourriez voir Les options développeur ne sont pas disponibles pour cet utilisateur ou Cette action est indisponible lorsque vous appuyez sur Numéro de build. Ouvrez Paramètres > Comptes et confirmez que vous êtes sur le profil profil, pas Work. Demandez un appareil de test dédié à votre service IT plutôt que de contourner la politique.
Utilisateur invité. Passez à votre utilisateur principal : Paramètres > Système > Plusieurs utilisateurs (le chemin peut varier), déconnectez-vous de Invité, puis répétez les sept appuis sur le compte du propriétaire.
Contrôle parental et profils restreints. Family Link ou un utilisateur secondaire restreint peut masquer le numéro de build ou bloquer le geste de déverrouillage. Utilisez un compte propriétaire sans restriction.
Toujours bloqué. Redémarrez, installez les mises à jour système en attente, puis recherchez dans Paramètres numéro de build encore. Si l’appareil est d’occasion et toujours verrouillé, l’ancien propriétaire ou l’opérateur a peut-être laissé des contrôles d’entreprise en place.
Activer le débogage USB
- Ouvrez Options pour les développeurs et activez le débogage USB.
- Connectez le téléphone avec un câble USB compatible transfert de données (beaucoup de câbles bon marché ne servent qu'à la charge).
- Sur le téléphone, acceptez la boîte de dialogue « Autoriser le débogage USB ? » , puis cochez « Toujours autoriser depuis cet ordinateur » sur votre machine.
- Sur l'ordinateur, vérifiez la connexion :
adb devices
Vous devriez voir :
List of devices attached
R5CT1234ABC device
unauthorized signifie que vous n'avez pas accepté le prompt. offline signifie généralement un câble ou un port défectueux, ou un adb serveur provenant d'un ancien SDK.
adb est fourni avec les Platform-Tools du SDK Android. Si Android Studio est installé, il se trouve dans ~/Library/Android/sdk/platform-tools sur macOS ou %LOCALAPPDATA%\Android\Sdk\platform-tools sur Windows. Ajoutez ce dossier à votre PATH. Vous débutez avec la toolchain Android ? Notre Configuration Android pour les apps Capacitor couvre ce sujet.
Activer le débogage sans fil (Android 11 et versions ultérieures)
Le débogage sans fil supprime le câble. Votre ordinateur et votre téléphone doivent être connectés au même réseau Wi-Fi, et certains réseaux d’entreprise ou d’hôtel bloquent le trafic entre appareils.
- Dans Options pour les développeurs, activez le débogage sans fil et acceptez la demande de connexion au réseau.
- Appuyez sur le débogage sans fil pour l’ouvrir, puis Appairez l'appareil avec le code d'appairage. Gardez cet écran ouvert.
- Sur l’ordinateur, appairez en utilisant l’adresse IP et le port affichés dans la boîte de dialogue d’appairage :
adb pair 192.168.1.42:37145
# Enter pairing code: 482913
- Connectez-vous en utilisant l’IP et le port affichés sur l’écran principal du débogage sans fil (un port différent du port d’appairage) :
adb connect 192.168.1.42:41827
adb devices
Android Studio dispose également de Appairer les appareils via Wi-Fi dans le gestionnaire d’appareils, qui affiche un QR code à scanner depuis l’écran de débogage sans fil.
Le port change à chaque redémarrage du débogage sans fil, vous devrez donc répéter adb connect après les redémarrages. L’appairage lui-même est mémorisé.
Sur Android 10 et versions antérieures, utilisez l’ancienne méthode : connectez une fois par USB, exécutez adb tcpip 5555, débranchez-le, puis adb connect <phone-ip>:5555.
Lancez votre application Capacitor sur l'appareil
Avec l’appareil répertorié dans adb devices, le Capacitor CLI peut compiler et installer directement :
bun run build
bunx cap sync android
bunx cap run android --list # show connected devices and emulators
bunx cap run android --target R5CT1234ABC
Pour un cycle plus rapide, utilisez le live reload afin que l’app charge votre serveur de dev via le réseau :
bunx cap run android -l --external
Le téléphone doit pouvoir accéder à l’IP de votre machine pour que cela fonctionne.
Pour lire les logs natifs pendant l’exécution de l’app :
adb logcat | grep -i -E "capacitor|chromium"
Et pour déboguer le WebView, ouvrez chrome://inspect dans Chrome sur ordinateur pendant que le build de debug est en cours. Les builds de debug des apps Capacitor activent le débogage WebView par défaut.
Troubleshooting
Taper sur le numéro de build ne fait rien. Vous appuyez peut-être sur le mauvais champ (par exemple la version Android au lieu du numéro de build), ou l'appareil est géré par une organisation. Sur certains appareils Xiaomi, il faut appuyer sur la version de l'OS, pas sur le numéro de build.
Appareil absent de adb devices.
adb kill-server
adb start-server
adb devices
Essayez ensuite un autre câble et un port directement sur l'ordinateur plutôt qu'un hub. Passez la notification de mode USB sur Transfert de fichiers.
Windows ne détecte pas le téléphone. Installez le pilote USB OEM (Samsung, Xiaomi et d'autres publient le leur) ou le Google USB Driver depuis le SDK Manager pour les appareils Pixel.
INSTALL_FAILED_UPDATE_INCOMPATIBLE. L'application installée a été signée avec une clé différente (par exemple un build Play Store au lieu de votre build de debug). Désinstallez-la d'abord : adb uninstall com.example.app.
INSTALL_FAILED_USER_RESTRICTED sur Xiaomi. Activer Installer via USB dans les options pour les développeurs.
Le débogage sans fil se désactive tout seul. Android le désactive lors d'un changement de réseau Wi-Fi. Certains modes d'économie d'énergie l'arrêtent aussi. Gardez le téléphone sur le même réseau et en charge lors de sessions prolongées.
Accès refusé après la mise à jour d'Android Studio. La clé adb dans ~/.android/adbkey changed. In Developer options tap Révoquer les autorisations de débogage USB, reconnectez-vous et acceptez à nouveau le prompt.
Comment désactiver les options développeur
- Ouvrez Options pour les développeurs.
- Basculer Utiliser les options développeur (ou Options pour les développeurs sur Samsung) en haut, en position off.
Le menu peut rester visible sur certains appareils, et les commutateurs individuels peuvent conserver leur dernière valeur même quand les options développeur sont désactivées. Pour masquer complètement le menu, allez dans Paramètres > Applications > Paramètres > Stockage et videz le stockage de l'application Paramètres. Cela réinitialise aussi les autres préférences, donc cela en vaut rarement la peine.
Avant de confier un téléphone de test à quelqu'un d'autre, appuyez aussi sur Révoquer les autorisations de débogage USB les anciens ordinateurs ne peuvent plus se connecter.
Notes de sécurité
- Le débogage USB permet à un ordinateur autorisé d'installer des apps et de lire les données des builds debuggables. N'acceptez pas le prompt RSA sur les bornes de recharge publiques ou les ordinateurs auxquels vous ne faites pas confiance.
- Certaines apps bancaires et de paiement refusent de se lancer quand les options développeur ou le débogage USB sont activés. Désactivez-les sur votre téléphone personnel lorsque vous avez terminé.
- Ne déployez jamais un build de release avec
android:debuggable="true". Les builds de release Capacitor ne sont pas debuggables par défaut.
Foire aux questions
Comment activer les options développeur sans numéro de build ?
Chaque téléphone Android possède un numéro de build, mais certaines marques le renomment ou le déplacent. Sur Samsung, ouvrez Paramètres, À propos du téléphone, Informations logicielles, puis touchez Numéro de build sept fois. Sur Xiaomi HyperOS, touchez Version du système d’exploitation, et sur les anciennes versions de MIUI, touchez Version MIUI. Si vous ne le trouvez toujours pas, tapez « numéro de build » dans la barre de recherche des Paramètres. Voir Numéro de build introuvable for work profiles and restricted users.
Combien de fois faut-il appuyer sur le numéro de build sur Android 14 ou 15 ?
Sept fois de suite sur Numéro de build (ou Version de l'OS / Version de MIUI sur Xiaomi). Après le troisième ou quatrième appui, Android affiche généralement un toast avec un compte à rebours. Saisissez le code PIN, le schéma ou le mot de passe de votre appareil lorsque cela vous est demandé, puis ouvrez Options pour les développeurs depuis les Paramètres.
Où se trouve le numéro de build sur Samsung ?
Paramètres > À propos du téléphone > Informations sur le logiciel > Numéro de build. Appuyez sept fois dessus, confirmez votre code PIN, puis trouvez Options pour les développeurs en bas de la liste principale des Paramètres.
Comment associer le débogage sans fil ?
Activez le débogage sans fil dans les options du développeur, ouvrez-l’et choisissez Appairez l'appareil avec le code d'appairage. Sur votre ordinateur, lancez adb pair <ip>:<pairing-port>, saisissez le code à six chiffres, puis adb connect <ip>:<debug-port> en utilisant l'adresse affichée sur l'écran principal du débogage sans fil (pas le port d'appairage).
Can I enable developer options on a work phone?
Généralement pas sans l'approbation de l'IT. Les appareils gérés bloquent le geste du numéro de build ou affichent Cette action est indisponible. Utilisez un téléphone de test personnel ou dédié pour adb et le débogage USB.