Débogage sans fil sur Mac : associer un téléphone Android

Le débogage sans fil, c’est la connexion développeur d’Android, adb, transportée par votre réseau Wi-Fi au lieu d’un câble USB. Il vous faut Android 11 ou ultérieur, les options pour les développeurs activées, et le téléphone et le Mac sur le même réseau. Sur le téléphone, ouvrez Options pour les développeurs > Débogage sans fil, activez-le et appuyez sur Associer l’appareil avec un code d’association. Le téléphone affiche un code à six chiffres, que vous donnez une fois au Mac. Ensuite, les deux peuvent se connecter chaque fois qu’ils sont sur le même réseau.

Il y a deux façons de faire la partie côté Mac : l’outil adb de Google dans le Terminal, ou une app qui associe pour vous. Les deux sont décrites plus bas, suivies de ce qu’il faut essayer quand le téléphone et le Mac refusent de s’associer.

Avant de commencer

Android 11 ou ultérieur. Vérifiez dans Paramètres > À propos du téléphone. Les versions plus anciennes ne proposent adb en Wi-Fi qu’après une connexion USB, avec adb tcpip 5555.
Les options pour les développeurs activées. Appuyez sept fois sur le numéro de build. Comment activer le débogage USB montre où se trouve le numéro de build selon la marque. Sur un Pixel, les options pour les développeurs apparaissent ensuite dans Paramètres > Système.
Le même réseau. Le téléphone en Wi-Fi, et le Mac sur le même Wi-Fi ou relié par câble au même routeur. Pas un réseau invité : on y revient plus bas.

Activer le débogage sans fil

Ouvrez Options pour les développeurs et trouvez Débogage sans fil. Appuyez sur le texte plutôt que sur l’interrupteur, pour que sa propre page s’ouvre, puis activez-le. Le téléphone demande s’il faut autoriser le débogage sans fil sur ce réseau. Cochez Toujours autoriser sur ce réseau si c’est le vôtre, et appuyez sur Autoriser.

La page affiche maintenant l’adresse et le port du téléphone, une liste d’appareils associés, et deux façons d’associer : Associer l’appareil avec un QR code et Associer l’appareil avec un code d’association. Le QR code sert à Android Studio et aux apps qui en affichent un. Le code d’association fonctionne avec tout.

Si vous comptez l’activer et le désactiver souvent, ajoutez le bloc : Options pour les développeurs > Blocs Réglages rapides pour les développeurs > Débogage sans fil.

Associer avec adb dans le Terminal

Installez les SDK Platform-Tools de Google, qui contiennent adb. Avec Homebrew, c’est une ligne ; sinon, téléchargez-les sur le site Android Developers de Google.

brew install --cask android-platform-tools

Sur le téléphone, appuyez sur Associer l’appareil avec un code d’association. Une boîte de dialogue affiche un code à six chiffres et une adresse avec un port, comme 192.168.1.23:37155. Laissez-la ouverte. Sur le Mac, lancez adb pair avec cette adresse et tapez le code quand il est demandé :

adb pair 192.168.1.23:37155

Le Terminal indique que l’association a réussi, et le Mac apparaît sur le téléphone sous Appareils associés. Ce port ne servait qu’à l’association. Pour vous connecter, utilisez l’adresse et le port affichés en haut de la page Débogage sans fil, qui est un autre port :

adb connect 192.168.1.23:41689
adb devices

Les versions récentes d’adb trouvent souvent toutes seules un téléphone associé sur le réseau et s’y connectent, donc adb devices peut le lister avant même que vous tapiez adb connect. Le port de connexion peut changer quand le débogage sans fil est désactivé puis réactivé, donc relisez-le sur le téléphone à chaque fois.

À partir de là, adb fonctionne comme par câble : adb pull /sdcard/DCIM/Camera ~/Desktop/Camera copie le dossier de l’appareil photo, adb shell ouvre un shell. Pour dissocier, appuyez sur le Mac sous Appareils associés et choisissez Retirer.

Associer avec SideMount

SideMount monte un téléphone comme un volume dans le Finder, par le câble ou, une fois associé, en Wi-Fi. Il parle lui-même adb, donc vous n’avez pas besoin des platform-tools. Ouvrez son panneau depuis la barre des menus et choisissez Connect over Wi-Fi, qui s’affiche quand aucun téléphone n’est branché, ou Pair à côté de Pair a phone over Wi-Fi dans ses réglages. Le panneau affiche un QR code pour Associer l’appareil avec un QR code, ou, si vous choisissez Use a pairing code instead, il attend un téléphone qui affiche un code. Appuyez sur Associer l’appareil avec un code d’association sur le téléphone, et tapez les six chiffres dans le panneau.

La première fois, macOS demande si l’app peut trouver des appareils sur votre réseau local. Autorisez-le, sinon rien n’apparaîtra. Vous pouvez changer votre réponse dans Réglages Système > Confidentialité et sécurité > Réseau local.

Ensuite, le téléphone se monte dans le Finder dès qu’il est sur le même réseau avec le débogage sans fil activé, et si vous branchez aussi le câble, le câble prend le relais. Il faut macOS 26 ou ultérieur ; le guide de configuration couvre le reste de la première connexion.

Soyez réaliste sur la vitesse. Selon nos mesures, un téléphone monté sur notre Wi-Fi à la maison transférait de 13 à 18 MB/s, contre 270 à 280 MB/s pour le même téléphone sur le câble. C’est très bien pour quelques documents ou photos, et lent pour toutes les vidéos d’un téléphone. Toutes les façons sans fil d’Android vers un Mac compare les solutions.

	adb des platform-tools de Google	SideMount
Association	Code à six chiffres, ou QR code via Android Studio	Code à six chiffres ou QR code, dans le panneau
Les fichiers apparaissent dans le Finder	Non, des commandes dans le Terminal	Oui, comme un volume
Se reconnecte tout seul	Souvent, si le réseau laisse passer la découverte	Oui, tant que le débogage sans fil est activé
Android 10 et antérieur	Seulement avec adb tcpip après une connexion USB	Non, Android 11 ou ultérieur
Prix	Gratuit	$1.99 par mois ou $19 une seule fois, essai de 7 jours
Vitesse par rapport au câble	Plus lent, limité par le Wi-Fi	Plus lent, limité par le Wi-Fi

Deux façons d’utiliser le débogage sans fil d’Android depuis un Mac.

Quand l’association échoue

Le code a expiré ou la boîte de dialogue s’est fermée

Le téléphone n’accepte un code que tant que la boîte de dialogue d’association est ouverte à l’écran. Si l’écran s’est verrouillé, ou si vous avez changé d’app, appuyez de nouveau sur Associer l’appareil avec un code d’association et utilisez le nouveau code. Un code mal tapé échoue sans explication, donc un code neuf est aussi le remède dans ce cas.

Un réseau invité, ou un réseau qui isole les appareils

Beaucoup de réseaux invités, et beaucoup de réseaux d’hôtel, d’école ou de bureau, pratiquent l’isolation des clients : chaque appareil peut atteindre Internet mais pas les autres appareils. Le débogage sans fil a besoin que le téléphone et le Mac se joignent directement, et tout ce qui trouve le téléphone pour vous compte sur le fait que le téléphone s’annonce sur le réseau, ce que ces réseaux bloquent souvent. Utilisez votre réseau domestique, et si l’association échoue encore, cherchez dans les réglages du routeur isolation des clients ou isolation AP et vérifiez qu’elle est désactivée pour le réseau que vous utilisez.

Un VPN sur le Mac ou sur le téléphone

Un VPN peut envoyer le trafic local hors de votre réseau, si bien que les deux ne se rencontrent jamais. Désactivez-le pendant l’association, ou autorisez l’accès au réseau local dans ses réglages, puis réessayez.

Le débogage sans fil s’est désactivé tout seul

Sous Android 16 et antérieur, le débogage sans fil se désactive souvent de lui-même quand le téléphone change de réseau ou redémarre. Réactivez-le, et vérifiez le port, qui a pu changer. Sous Android 17, avec les platform-tools 37.0.0 ou ultérieurs sur le Mac, l’ADB Wi-Fi 2.0 de Google fait que le téléphone le réactive de lui-même sur les réseaux que vous avez autorisés.

Un vieil adb, ou un serveur adb bloqué

L’association demande un adb récent. Mettez à jour les platform-tools, lancez adb kill-server, et réessayez. Si c’est la découverte qui échoue, adb connect avec l’adresse et le port lus sur le téléphone fonctionne sans elle.

Questions

Quelle version d’Android faut-il pour le débogage sans fil ?

Android 11 ou ultérieur sur un téléphone. Les téléphones plus anciens ne peuvent utiliser adb en Wi-Fi qu’après une connexion USB, en lançant « adb tcpip 5555 » avec le câble branché, puis « adb connect » avec l’adresse du téléphone.

Pourquoi adb connect échoue-t-il après une association réussie ?

En général parce qu’on lui a donné le port d’association. L’association et la connexion utilisent des ports différents. Fermez la boîte de dialogue d’association et utilisez l’adresse et le port affichés en haut de la page Débogage sans fil, qui peuvent changer à chaque activation du débogage sans fil.

Le téléphone et le Mac doivent-ils être sur le même Wi-Fi ?

Oui. Ils doivent être sur le même réseau et pouvoir se joindre directement. Les réseaux invités et les réseaux avec isolation des clients séparent les appareils, donc l’association y échoue même si les deux sont en ligne.

Le débogage sans fil est-il aussi rapide qu’un câble USB ?

Non. Le Wi-Fi est bien plus lent qu’un câble USB pour transférer des fichiers, et la vitesse dépend de votre routeur, de la distance et des murs entre les deux. Il convient aux documents et à quelques photos. Pour de grosses vidéos ou une sauvegarde complète, branchez le téléphone.

Associer le débogage sans fil d’Android à un Mac