Androids Debugging über WLAN mit einem Mac koppeln

Debugging über WLAN ist die Entwicklerverbindung von Android, adb, über dein WLAN statt über ein USB-Kabel. Du brauchst Android 11 oder neuer, eingeschaltete Entwickleroptionen und Smartphone und Mac im selben Netzwerk. Öffne auf dem Smartphone Entwickleroptionen > Debugging über WLAN, schalte es ein und tippe auf Gerät über einen Kopplungscode koppeln. Das Smartphone zeigt einen sechsstelligen Code, den du dem Mac einmal gibst. Danach können sich die beiden verbinden, wann immer sie im selben Netzwerk sind.

Für den Teil auf dem Mac gibt es zwei Wege: Googles eigenes Werkzeug adb im Terminal oder eine App, die das Koppeln für dich übernimmt. Beide stehen unten, gefolgt von dem, was du versuchen kannst, wenn sich Smartphone und Mac nicht koppeln lassen.

Bevor du anfängst

• Android 11 oder neuer. Prüf das unter Einstellungen > Über das Telefon. Ältere Versionen bieten adb über WLAN nur nach einer USB-Verbindung an, mit adb tcpip 5555.
• Entwickleroptionen eingeschaltet. Tippe siebenmal auf die Build-Nummer. So schaltest du USB-Debugging ein zeigt, wo die Build-Nummer bei jedem Hersteller liegt. Auf einem Pixel erscheinen die Entwickleroptionen dann unter Einstellungen > System.
• Dasselbe Netzwerk. Das Smartphone im WLAN und der Mac im selben WLAN oder per Kabel am selben Router. Kein Gastnetzwerk: mehr dazu unten.

Debugging über WLAN einschalten

Öffne Entwickleroptionen und such Debugging über WLAN. Tippe auf den Text statt auf den Schalter, damit sich die eigene Seite öffnet, und schalte es dann ein. Das Smartphone fragt, ob Debugging über WLAN in diesem Netzwerk zugelassen werden soll. Setz ein Häkchen bei Immer in diesem Netzwerk zulassen, wenn es dein eigenes ist, und tippe auf Zulassen.

Die Seite zeigt jetzt die Adresse und den Port des Smartphones, eine Liste gekoppelter Geräte und zwei Wege zum Koppeln: Gerät über einen QR-Code koppeln und Gerät über einen Kopplungscode koppeln. Der QR-Code ist für Android Studio und Apps, die einen anzeigen. Der Kopplungscode funktioniert mit allem.

Wenn du es oft ein- und ausschaltest, füg die Kachel hinzu: Entwickleroptionen > Kacheln für Schnelleinstellungen für Entwickler > Debugging über WLAN.

Mit adb im Terminal koppeln

Installier Googles SDK Platform-Tools, die adb enthalten. Mit Homebrew ist das eine Zeile; sonst lädst du sie von Googles Website für Android-Entwickler herunter.

brew install --cask android-platform-tools

Tippe auf dem Smartphone auf Gerät über einen Kopplungscode koppeln. Ein Dialog zeigt einen sechsstelligen Code und eine Adresse mit Port, etwa 192.168.1.23:37155. Lass ihn offen. Führ auf dem Mac adb pair mit dieser Adresse aus und gib den Code ein, wenn du danach gefragt wirst:

adb pair 192.168.1.23:37155

Das Terminal meldet die erfolgreiche Kopplung, und der Mac erscheint auf dem Smartphone unter Gekoppelte Geräte. Dieser Port war nur zum Koppeln da. Zum Verbinden nimmst du die Adresse und den Port oben auf der Seite Debugging über WLAN, und das ist ein anderer Port:

adb connect 192.168.1.23:41689
adb devices

Neuere Versionen von adb finden ein gekoppeltes Smartphone im Netzwerk oft selbst und verbinden sich, adb devices listet es also womöglich schon, bevor du adb connect eintippst. Der Port für die Verbindung kann sich ändern, wenn Debugging über WLAN aus- und wieder eingeschaltet wird, lies ihn also jedes Mal am Smartphone ab.

Von hier an funktioniert adb wie über ein Kabel: adb pull /sdcard/DCIM/Camera ~/Desktop/Camera kopiert den Kameraordner, adb shell öffnet eine Shell. Zum Entkoppeln tippst du unter Gekoppelte Geräte auf den Mac und wählst Entfernen.

Mit SideMount koppeln

SideMount bindet ein Smartphone als Volume im Finder ein, über das Kabel oder, einmal gekoppelt, über WLAN. Es spricht adb selbst, du brauchst also keine Platform-Tools. Öffne sein Panel in der Menüleiste und wähle Connect over Wi-Fi, das erscheint, solange kein Smartphone angeschlossen ist, oder Pair neben Pair a phone over Wi-Fi in seinen Einstellungen. Das Panel zeigt einen QR-Code für Gerät über einen QR-Code koppeln, oder es wartet, wenn du Use a pairing code instead wählst, auf ein Smartphone, das einen Code anzeigt. Tippe auf dem Smartphone auf Gerät über einen Kopplungscode koppeln und gib die sechs Ziffern im Panel ein.

Beim ersten Mal fragt macOS, ob die App Geräte in deinem lokalen Netzwerk finden darf. Erlaube es, sonst erscheint nichts. Du kannst deine Antwort unter Systemeinstellungen > Datenschutz & Sicherheit > Lokales Netzwerk ändern.

Danach wird das Smartphone im Finder eingebunden, sobald es mit eingeschaltetem Debugging über WLAN im selben Netzwerk ist, und wenn du zusätzlich das Kabel einsteckst, übernimmt das Kabel. Es braucht macOS 26 oder neuer; die Einrichtungsanleitung behandelt den Rest der ersten Verbindung.

Erwarte beim Tempo nicht zu viel. In unseren Messungen übertrug ein über das WLAN zu Hause eingebundenes Smartphone 13 bis 18 MB/s, dasselbe Smartphone am Kabel 270 bis 280 MB/s. Das reicht für ein paar Dokumente oder Fotos und ist langsam für die Videos eines ganzen Smartphones. Alle drahtlosen Wege von Android zum Mac vergleicht die Alternativen.

Wenn das Koppeln scheitert

Der Code ist abgelaufen oder der Dialog wurde geschlossen

Das Smartphone nimmt einen Code nur an, solange der Kopplungsdialog auf seinem Bildschirm offen ist. Wenn sich der Bildschirm gesperrt hat oder du die App gewechselt hast, tippe erneut auf Gerät über einen Kopplungscode koppeln und nimm den neuen Code. Ein vertippter Code scheitert ohne Erklärung, ein frischer Code ist also auch dafür die Lösung.

Ein Gastnetzwerk oder eines, das Geräte voneinander trennt

Viele Gastnetzwerke und viele Netzwerke in Hotels, Schulen und Büros nutzen Client-Isolation: Jedes Gerät erreicht das Internet, aber nicht die anderen Geräte. Debugging über WLAN braucht ein Smartphone und einen Mac, die sich direkt erreichen, und alles, was das Smartphone für dich findet, ist darauf angewiesen, dass sich das Smartphone im Netzwerk bekannt macht, was solche Netzwerke oft blockieren. Nimm dein Heimnetzwerk, und wenn das Koppeln dort trotzdem scheitert, such in den Einstellungen des Routers nach Client Isolation oder AP Isolation und stell sicher, dass sie für das Netzwerk, das du nutzt, ausgeschaltet ist.

Ein VPN auf dem Mac oder dem Smartphone

Ein VPN kann lokalen Datenverkehr aus deinem Netzwerk wegleiten, sodass sich die beiden nie begegnen. Schalte es zum Koppeln aus oder erlaube in seinen Einstellungen den Zugriff aufs lokale Netzwerk, und versuch es dann erneut.

Debugging über WLAN hat sich selbst ausgeschaltet

Unter Android 16 und älter schaltet sich Debugging über WLAN oft selbst aus, wenn das Smartphone das Netzwerk wechselt oder neu startet. Schalte es wieder ein und prüf den Port, der sich geändert haben kann. Unter Android 17, mit Platform-Tools 37.0.0 oder neuer auf dem Mac, lässt Googles ADB Wi-Fi 2.0 das Smartphone es in Netzwerken, die du erlaubt hast, selbst wieder einschalten.

Altes adb oder ein hängender adb-Server

Das Koppeln braucht ein aktuelles adb. Aktualisier die Platform-Tools, führ adb kill-server aus und versuch es erneut. Wenn die Erkennung das Problem ist, funktioniert adb connect mit der Adresse und dem Port vom Smartphone auch ohne sie.

Fragen