Configurer l’appareil Android pour le débogage

2025-02-25

Bien que l’émulateur Android soit un excellent moyen de développer et de tester rapidement votre application, vous souhaiterez tester vos applications sur un appareil Android réel. Pour s’exécuter sur un appareil, vous devez activer le mode développeur sur l’appareil et le connecter à votre ordinateur. Pour plus d’informations, consultez Exécuter des applications sur un appareil matériel sur developer.android.com.

Important

Les étapes décrites dans cet article sont écrites de manière générique pour travailler sur autant d’appareils que possible. Si vous ne trouvez pas ces paramètres sur votre appareil, consultez la documentation du fabricant de votre appareil.

Activer le mode développeur sur l’appareil

Un appareil doit activer le mode développeur pour déployer et tester une application Android. Le mode développeur est activé en procédant comme suit :

Accédez à l’écran paramètres .
Sélectionnez À propos du téléphone.
Appuyez sur numéro de build sept fois jusqu’à Vous êtes maintenant développeur ! est visible.

Selon l’interface utilisateur que votre appareil exécute, l’option À propos du téléphone peut se trouver dans un autre emplacement. Consultez la documentation de votre appareil si vous ne trouvez pas À propos du téléphone.

Activer le débogage USB

Après avoir activé le mode développeur sur votre appareil, activez le débogage USB en procédant comme suit :

Accédez à l'écran des paramètres .
Sélectionnez Options Développeur.
Activez l’option débogage USB.

Selon l’interface utilisateur utilisée par votre appareil, l’option débogage USB peut se trouver dans un autre emplacement. Consultez la documentation de votre appareil si vous ne trouvez pas débogage USB.

Connecter l’appareil à l’ordinateur

La dernière étape consiste à connecter l’appareil à l’ordinateur. Le moyen le plus simple et le plus fiable est de le faire via USB.

Vous recevrez une notification pour faire confiance à l’ordinateur sur votre appareil si vous ne l’avez jamais utilisé pour le débogage auparavant. Vous pouvez également cocher Toujours autoriser à partir de cet ordinateur pour éviter d'exiger cette demande chaque fois que vous connectez l’appareil.

demande de confiance Android depuis l'ordinateur pour utiliser le débogage USB.

Si votre ordinateur ne reconnaît pas l’appareil lorsqu’il est branché, essayez d’installer un pilote pour l’appareil. Consultez la documentation de support de votre fabricant d’appareils. Vous pouvez également essayer d’installer le pilote Google USB par le biais du Gestionnaire du Kit de développement logiciel (SDK) Android :

Android SDK Manager avec le pilote de périphérique USB Google sélectionné.

Activer le débogage Wi-Fi

Il est possible de déboguer un appareil Android via wi-fi, sans garder l’appareil physiquement connecté à l’ordinateur. Cette technique nécessite plus d’efforts, mais peut être utile lorsque l’appareil est trop éloigné de l’ordinateur pour rester constamment branché via un câble.

Connexion via wi-fi

Par défaut, le pont de débogage Android (adb) est configuré pour communiquer avec un appareil Android via USB. Il est possible de le reconfigurer pour utiliser TCP/IP au lieu de USB. Pour ce faire, l’appareil et l’ordinateur doivent se trouver sur le même réseau Wi-Fi.

Note

Le pilote USB de Google est nécessaire pour effectuer le débogage adb sur Windows avec des appareils Google. Pour plus d’informations, consultez pour obtenir le Google-USB Driver sur developer.android.com. Les pilotes Windows pour tous les autres appareils sont fournis par le fabricant de matériel respectif. Pour plus d’informations, consultez Installer des pilotes USB OEM sur developer.android.com.

Tout d’abord, activez le débogage sans fil sur votre appareil Android :

Suivez les étapes décrites dans la section Activer le mode développeur sur l’appareil section.
Suivez les étapes décrites dans la section Activer le débogage USB.
Accédez à l’écran des paramètres .
Sélectionnez Options Développeur.
Activez l’option débogage sans fil.

Selon l’interface utilisateur que votre appareil exécute, l’option débogage sans fil peut se trouver dans un autre emplacement. Consultez la documentation de votre appareil si vous ne parvenez pas à trouver débogage sans fil.

Ensuite, utilisez adb pour vous connecter à votre appareil, tout d’abord via une connexion USB :

Déterminez l’adresse IP de votre appareil Android. L’une des façons de déterminer l’adresse IP consiste à examiner sous Paramètres > Réseau & Internet >Wi-Fi, puis appuyez sur le réseau Wi-Fi auquel l’appareil est connecté, puis appuyez sur avancé. Cela ouvre une liste déroulante montrant des informations sur la connexion réseau, comme ce qui est vu dans la capture d’écran ci-dessous :

Sur certaines versions d’Android, l’adresse IP n’est pas répertoriée, mais vous pouvez la trouver sous Paramètres > À propos du téléphone > État.
Dans Visual Studio, ouvrez l’invite de commandes adb pour Android en sélectionnant l’option de menu : Outils>Android>Invite de commandes adb pour Android....
Dans l’invite de commandes, utilisez la commande adb tcpip pour indiquer à l’appareil d’écouter les connexions TCP/IP sur le port 5555.
```
adb tcpip 5555
```
Déconnectez le câble USB de votre appareil.
Connectez-vous à l’adresse IP de l’appareil avec le port 5555 :
```
adb connect 192.168.1.28:5555
```
Une fois cette commande terminée, l’appareil Android est connecté à l’ordinateur via wi-fi.

Une fois le débogage terminé via wi-fi, vous pouvez rétablir la base de données ADB en mode USB avec la commande suivante :
```
adb usb
```
Pour afficher les appareils connectés à l’ordinateur, utilisez la commande adb devices :
```
adb devices
```

Configurer les options du développeur sur l’appareil

L’application Paramètres sur Android inclut un écran appelé options développeur où vous pouvez configurer des comportements système qui vous aident à profiler et à déboguer les performances de votre application. Pour plus d’informations, consultez Configurer les options de développement sur appareil sur developer.android.com.

Déboguer une application sur un appareil Android

Pour déboguer une application sur un appareil Android :

Connectez l’appareil à votre machine et sélectionnez-le en tant que cible de débogage dans Visual Studio ou Visual Studio Code.
Exécutez l’application.

Pour plus d’informations sur la sélection d’une cible de débogage dans Visual Studio, consultez Générer votre première application. Pour plus d’informations sur la sélection d’une cible de débogage dans Visual Studio Code, consultez Créer votre première application.