Pour activer le mode développeur sur Android, ouvrez Paramètres > À propos de votre téléphone et appuyez Numéro de build sept fois, puis entrez votre code PIN. A Options de développeur un menu s'affiche, où vous pouvez activer le débogage USB ou Débogage sans fil Débogage sans fil adb ou bunx cap run android Vous pouvez installer et déboguer votre application. Le chemin exact vers le numéro de build dépend du fabricant, les étapes pour chaque marque sont donc présentées ci-dessous.
Quels options de développeur sont activés (et quels ne le sont pas)
Options de développeur est un menu de paramètres caché destiné aux développeurs d'applications. L'activation ne fait rien par elle-même. Elle ne révèle que des commutateurs tels que :
- Débogage USB: permet à un ordinateur fiable d'exécuter
adbcommands, install builds and read logs. - Débogage sans filMême chose par Wi-Fi (Android 11+).
- Restez éveilléL'écran reste allumé pendant la recharge, pratique lors des tests.
- Échelle d'animation: speed up or turn off system animations, useful for UI tests.
- N'oubliez pas les activités: détruit les activités lorsque vous les quittez, une bonne façon de tester la restauration de l'état dans une application Capacitor.
- Afficher les touches / Position de la souris: utile pour enregistrer des démos et vérifier les cibles de toucher.
Vous devez pas Pour installer une APK depuis un navigateur ou un gestionnaire de fichiers, ou pour utiliser la plupart des applications, ou pour recevoir une mise à jour par Wi-Fi.
Activer les options de développeur par marque
| Marque | Où appuyez 7 fois | Où le menu apparaît ensuite |
|---|---|---|
| Google Pixel / Android par défaut | Paramètres > À propos de l'appareil > Numéro de construction | Paramètres > Système > Options de développeur |
| Samsung (One UI) | Paramètres > À propos de l'appareil > Informations sur le logiciel > Numéro de version de construction | Paramètres > Options de développeur (en bas de la liste) |
| Xiaomi, Redmi, POCO (HyperOS) | Paramètres > À propos de l'appareil > OS version | Paramètres > Paramètres supplémentaires > Options de développeur |
| Xiaomi (ancien MIUI) | Paramètres > À propos de l'appareil > Version MIUI | Paramètres > Paramètres supplémentaires > Options de développeur |
| OnePlus (OxygenOS) | Paramètres > À propos de l'appareil > Version > Numéro de version | Paramètres > Paramètres système > Options de développeur |
| OPPO / realme (ColorOS / realme UI) | Paramètres > À propos de l'appareil > Version > Numéro de version | Paramètres > Paramètres supplémentaires > Options de développeur |
| Motorola | Paramètres > À propos du téléphone > Numéro de version | Paramètres > Système > Options de développeur |
| Huawei / Honor (EMUI / MagicOS) | Paramètres > À propos de l'appareil > Numéro de version de construction | Paramètres > Système et mises à jour > Options de développeur |
Menus move between OS versions. If you cannot find Build number, open Settings and use the search field: type “build number”. On almost every Android device search finds it directly.
Google Pixel (Android 14, 15, 16)
- Ouvrir Paramètres et défilez jusqu'à About phone.
- Défilez jusqu'en bas et appuyez Numéro de version de construction Sept fois. Après quelques touches, vous voyez un toast de comptage à rebours.
- Enter your PIN, pattern or password.
- Retourner à Paramètres > Système > Options de développeur.
Samsung Galaxy
- Ouvrir Paramètres > À propos de l'appareil > Informations sur le logiciel.
- Appuyez Numéro de construction Sept fois et confirmez avec votre code PIN.
- Les options de développeur apparaissent maintenant en bas de la liste principale des Paramètres, en dessous d'À propos de l'appareil.
Xiaomi, Redmi et POCO
- Ouvrir Paramètres > À propos de l'appareil.
- Cliquez Version de l'OS (HyperOS) ou MIUI version Sept fois (sur les appareils plus anciens).
- Allez à Paramètres > Paramètres supplémentaires > Options de développeur.
Xiaomi adds two extra switches you usually need for development: Installez via USB et USB debugging (Réglages de sécurité). Sans « Installer via USB » adb install échoue avec INSTALL_FAILED_USER_RESTRICTED. L'activation de ces options peut nécessiter de se connecter à un compte Xiaomi et d'avoir un carte SIM insérée.
OnePlus, OPPO et realme
- Ouvrir Paramètres > À propos de l'appareil > Version.
- Clic Numéro de version sept fois.
- Ouvrir Paramètres > Paramètres système > Options de développeur (OnePlus) ou Paramètres > Paramètres supplémentaires > Options de développeur chez OPPO, realme.
Huawei et Honor
- Ouvrir Paramètres > À propos de mon téléphone.
- Appuyez Sur le numéro de version sept fois.
- Allez à Paramètres > Système & mises à jour > Options de développeur.
On les appareils Huawei, configurez également le mode de connexion USB à Transfert de fichiers lorsque vous connectez, sinon adb ne pourra peut-être pas voir le dispositif. Si vous prévoyez d'expédier ces appareils, lisez comment publier une application Capacitor sur Huawei AppGallerycar beaucoup d'entre eux n'ont pas de services Google Play.
Profils de travail et appareils gérés
Si votre entreprise gère le téléphone, l'administrateur peut bloquer les options de développeur. Vous verrez « Les options de développeur ne sont pas disponibles pour cet utilisateur ». Demandez à l'IT un appareil de test plutôt que d'essayer de contourner la politique.
Activer le débogage USB
- Ouvrez Options de développeur et activez USB débogage.
- Connectez le téléphone à un câble USB qui supporte les données (beaucoup de câbles bon marché ne sont que pour la recharge).
- Sur le téléphone, acceptez le Autoriser le débogage USB ? dialogue. Cochez toujours autoriser depuis cet ordinateur sur votre propre 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é la demande. offline signifie généralement un câble ou un port défectueux, ou un adb serveur d'un ancien SDK.
adb est livré avec la plateforme SDK Android-Tools. 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 PATHNouveau dans le flux de travail Android ? Notre configuration Android pour les applications Capacitor couvre cela.
Activer le débogage sans fil (Android 11 et ultérieur)
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 hôtels bloquent le trafic appareil-à-appareil.
- Dans options de développeuractivez le débogage sans fil et accepter la fenêtre de prompt réseau.
- Appuyez Débogage sans fil pour l'ouvrir, puis Pairer appareil avec pairing code. Gardez cette page ouverte.
- Sur l'ordinateur, associez-vous à l'adresse IP et au port affichés dans la fenêtre de pairing :
adb pair 192.168.1.42:37145
# Enter pairing code: 482913
- Connectez-vous à l'adresse IP et au port affichés sur l'écran principal de Débogage sans fil (un port différent du port de pairing) :
adb connect 192.168.1.42:41827
adb devices
Android Studio dispose également de Associer les appareils à l'aide de Wi-Fi dans le gestionnaire de périphérique, qui affiche un QR code que vous pouvez 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 redémarrage. La pairing est mémorisée.
On Android 10 and earlier, use the older method: connect once by USB, run adb tcpip 5555, débranchez, et adb connect <phone-ip>:5555.
Exécutez votre application Capacitor sur le dispositif
Avec le dispositif listé dans adb devices, l'application Capacitor CLI peut construire 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
For a faster loop, use live reload so the app loads your dev server over the network:
bunx cap run android -l --external
Le téléphone doit atteindre l'IP de votre machine pour que cela fonctionne. Lorsque vous voulez que les testeurs à l'extérieur de votre réseau voient les modifications sans réinstaller, regardez Capgo mises à jour en direct au lieu d'un serveur de développement.
To read native logs while the app runs:
adb logcat | grep -i -E "capacitor|chromium"
Et pour déboguer le WebView, ouvrez chrome://inspect Sur Chrome bureau, pendant l'exécution d'une build de débogage. Les builds de débogage des applications Capacitor activent la débogage de WebView par défaut.
Troubleshooting
Le numéro de version ne fait rien. Vous pouvez taper sur le champ incorrect (par exemple la version d'Android au lieu du numéro de version), ou le dispositif est géré par une organisation. Certains appareils Xiaomi nécessitent que vous cliquiez sur la version du système, et non sur le numéro de version.
Appareil manquant de adb devices.
adb kill-server
adb start-server
adb devices
Essayez ensuite un câble différent et un port directement sur l'ordinateur au lieu d'un hub. Allez dans les paramètres de notification USB et sélectionnez Transfert de fichiers.
Windows ne voit pas le téléphone. Installez le pilote USB OEM (Samsung, Xiaomi et autres publient leurs propres pilotes) ou le pilote USB Google 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 une version de la boutique Play versus votre version de débogage). Supprimez-la d'abord : adb uninstall com.example.app.
INSTALL_FAILED_USER_RESTRICTED sur Xiaomi. Activer Installez via USB dans les options du développeur.
La débogage sans fil se déactive sans cesse. L'Android l'éteint lorsque vous changez le réseau Wi-Fi. Certains économiseurs de batterie l'arrêtent également. Gardez le téléphone sur le même réseau et en charge pendant les sessions longues.
Non autorisé après mise à jour d'Android Studio. La clé adb dans ~/.android/adbkey modifié. Appuyez sur les options du développeur Révoquez les autorisations de débogage USB, reconnectez-vous et acceptez à nouveau la demande.
Comment désactiver les options du développeur
- Ouvrez les options du développeur.
- Activer Utiliser les options de développeur (ou Options de développeur les options de développeur
The menu stays visible on some devices but every switch inside resets to default. To hide the menu completely, go to sur Samsung) en haut pour les désactiver. et vider le stockage pour l'application Paramètres. Cela réinitialise également d'autres préférences de paramètres, ce qui n'est donc rarement utile.
Avant de remettre un téléphone de test à quelqu'un d'autre, appuyez également Annuler les autorisations de débogage USB les anciens ordinateurs ne peuvent plus se connecter.
Remarques de sécurité
- La débogage USB permet à un ordinateur autorisé d'installer des applications et de lire les données des applications à partir de builds de débogage. N'acceptez pas la prompt RSA sur les stations de recharge publique ou les ordinateurs que vous ne confiez pas.
- Certains applications bancaires et de paiement refusent de fonctionner tant que les options de développeur ou la débogage USB sont activés. Désactivez-les sur votre téléphone personnel lorsque vous avez terminé.
- Ne livre jamais un build de version finale avec
android:debuggable="true"Les builds de version Capacitor ne sont pas déboguables par défaut.
L'équivalent iOS
Les iPhones ont leur propre Mode Développeur activez l'option Développeur avant de lancer des builds de développement ou hors ligne. Voir comment activer le Mode Développeur sur iOS. Pour obtenir des builds sur les téléphones des testeurs sans câble, consultez comment distribuer des applications iOS et Android aux testeurs.