Roman Kryvolapov Engineering Blog

Как включить отладку по Wi-Fi в Android Studio

Подробная инструкция, как подключить устройство к Android Studio по Wi-Fi вместо кабеля. Ниже два способа: классический, через adb tcpip, он работает на любой версии Android, и встроенная беспроводная отладка Android 11 и новее, для которой кабель не нужен вовсе.

Через adb tcpip

  1. Заходим в настройки роутера и присваиваем устройству статический IP-адрес — обычно это раздел DHCP-сервера для LAN. Здесь для примера используется 192.168.1.128. Пункт «Изолировать клиентов точки доступа» должен быть выключен, а устройство и компьютер — подключены к одной сети.
  2. Переподключаемся к точке доступа или перезагружаем роутер.
  3. Открываем на устройстве меню разработчика: для этого нужно несколько раз нажать на номер сборки в разделе «Об устройстве».
  4. В меню разработчика включаем отладку по USB.
  5. Подключаем устройство кабелем к компьютеру с запущенной Android Studio и разрешаем на устройстве доступ для отладки. После этого устройство должно появиться в списке устройств.
  6. Открываем терминал и проверяем IP-адрес устройства:
Terminal window
adb shell ip -f inet addr show wlan0

В ответе будет строка вида inet 192.168.1.128/24 brd 192.168.1.255 scope global wlan0.

Если adb не находится, укажите полный путь к нему: ~/Library/Android/sdk/platform-tools/adb на macOS, C:\Users\<user>\AppData\Local\Android\Sdk\platform-tools\adb на Windows.

  1. Переводим adb на устройстве в сетевой режим:
Terminal window
adb tcpip 5555

Должна появиться строка restarting in TCP mode port: 5555.

  1. Подключаемся по сети:
Terminal window
adb connect 192.168.1.128:5555

При успехе появится connected to 192.168.1.128:5555. Теперь кабель можно отключить. Проверить, что устройство на связи, можно командой adb devices: в списке будет 192.168.1.128:5555 device. Если устройств нет, список будет пустым, а команды вроде adb shell ответят adb: no devices/emulators found.

Отключиться и вернуть adb в режим USB:

Terminal window
adb disconnect 192.168.1.128:5555
adb usb

После перезагрузки устройства режим TCP сбрасывается, и шаги 5–8 придётся повторить.

Беспроводная отладка Android 11+

С Android 11 отладка по Wi-Fi встроена в систему, и кабель не нужен даже для первого подключения.

  1. В меню разработчика включаем Беспроводную отладку (Wireless debugging).
  2. Проще всего в Android Studio: в списке устройств выбираем Pair Devices Using Wi-Fi и сканируем QR-код с устройства через пункт Сопряжение устройства с помощью QR-кода.
  3. Или из терминала: на устройстве открываем Сопряжение устройства с помощью кода, там будут адрес с портом и шестизначный код, и выполняем
Terminal window
adb pair 192.168.1.128:<порт сопряжения>
adb connect 192.168.1.128:<порт подключения>

adb pair запросит шестизначный код. Порт подключения — другой: он показан на главном экране беспроводной отладки, рядом с IP-адресом.

Есть ещё сторонний плагин ADB Wi-Fi: подключаем устройство по USB и нажимаем Connect в его панели, после чего кабель можно отключить. Сейчас встроенного сопряжения обычно хватает.