Когда команда adb connect возвращает «connection refused» или устройство просто не появляется в списке девайсов Android Studio, чаще всего причина в том, что смартфон и компьютер находятся в разных подсетях либо на телефоне не активирована беспроводная отладка. Проверка начинается с простого: оба устройства должны быть подключены к одной и той же Wi-Fi сети, а в настройках разработчика включён соответствующий переключатель.
Отладка по Wi-Fi избавляет от необходимости держать телефон привязанным кабелем к компьютеру: приложение устанавливается, логи снимаются, а breakpoints срабатывают так же, как при USB-подключении. В этом руководстве разберём два рабочих способа — через встроенную беспроводную отладку на Android 11 и новее и через классическую связку adb tcpip для более старых версий, а также типичные ошибки и способы их устранения.
Что нужно подготовить перед подключением
Беспроводная отладка требует минимальной подготовки, но пропуск любого пункта приводит к тому, что устройство не обнаруживается. Убедитесь, что на компьютере установлен Android SDK Platform-Tools — именно оттуда берётся утилита adb. В Android Studio она обычно уже есть: путь к ней можно посмотреть в настройках SDK.
На смартфоне необходимо активировать режим разработчика. Для этого откройте Настройки → О телефоне и несколько раз нажмите на пункт «Номер сборки», пока система не сообщит, что вы стали разработчиком. Точное название пункта может отличаться в зависимости от оболочки производителя — сверьтесь с документацией своей модели, если путь выглядит иначе.
- 📶 Компьютер и смартфон подключены к одной Wi-Fi сети
- 🔧 Включён режим разработчика на телефоне
- 🛠️ Установлены Platform-Tools с актуальной версией adb
- 🔓 На устройстве разрешена отладка по USB (в разделе для разработчиков)
⚠️ Внимание: некоторые корпоративные и гостевые Wi-Fi сети блокируют трафик между клиентами (функция изоляции клиентов, AP isolation). В такой сети adb-подключение работать не будет — используйте домашний роутер или раздайте точку доступа с телефона.
Способ 1: беспроводная отладка на Android 11 и новее
Начиная с Android 11, в систему встроена штатная беспроводная отладка, которая не требует предварительного подключения по кабелю. Это самый удобный и безопасный метод: сопряжение происходит по коду, а соединение шифруется.
Порядок действий следующий. Откройте Настройки → Для разработчиков → Беспроводная отладка и включите переключатель. Затем нажмите на пункт «Сопряжение устройства с кодом» — на экране появятся шестизначный код, IP-адрес и порт. Эти данные понадобятся для команды сопряжения на компьютере.
adb pair 192.168.1.50:37025
введите код сопряжения с экрана телефона
После успешного сопряжения выполните подключение. Обратите внимание: порт для adb connect отличается от порта сопряжения — он указан на главном экране раздела «Беспроводная отладка».
adb connect 192.168.1.50:40417
adb devices
Если всё сделано верно, в выводе adb devices устройство появится со статусом device, а в Android Studio оно станет доступно в списке целей запуска. Команда adb devices — ваш главный инструмент проверки на каждом этапе.
☑️ Подключение через беспроводную отладку
Способ 2: adb tcpip для старых версий Android
На устройствах с Android 10 и ниже штатной беспроводной отладки нет, поэтому используется классический метод: сначала телефон подключается по USB, затем ADB-демон переводится в сетевой режим, и только после этого кабель можно отсоединить.
adb tcpip 5555
adb connect 192.168.1.50:5555
После выполнения adb tcpip 5555 отключите USB-кабель и проверьте соединение командой adb devices. IP-адрес телефона можно посмотреть в настройках Wi-Fi на самом устройстве. Учтите, что после перезагрузки смартфона режим сбрасывается, и процедуру с adb tcpip придётся повторить с подключением кабеля.
⚠️ Внимание: порт 5555 в режиме adb tcpip не защищён сопряжением — любое устройство в той же сети теоретически может попытаться подключиться. Не используйте этот метод в публичных сетях и отключайте режим командой adb usb, когда отладка завершена.
Сравнение способов подключения
Выбор метода зависит от версии Android на устройстве и требований к безопасности. Ниже — сводная таблица ключевых различий.
| Критерий | Беспроводная отладка (Android 11+) | adb tcpip (старые версии) |
|---|---|---|
| Нужен ли USB-кабель | Нет | Да, для первичной настройки |
| Сопряжение по коду | Да, шестизначный код | Нет |
| Шифрование соединения | Да | Нет |
| Порт | Динамический, меняется | Фиксированный 5555 |
| Работает после перезагрузки | Да, при включённой опции | Нет, требует повторной настройки |
Типичные ошибки и их решение
Самая частая проблема — ответ failed to connect или connection refused при выполнении adb connect. Возможные причины: неверный порт (для беспроводной отладки он меняется при каждом включении), устройства в разных сетях, либо брандмауэр на компьютере блокирует исходящее соединение. Проверьте, что телефон отвечает — например, командой ping на его IP-адрес.
Вторая распространённая ситуация — статус unauthorized в выводе adb devices. Это значит, что на телефоне не подтверждён запрос на разрешение отладки: разблокируйте экран и примите диалог с RSA-отпечатком. Если диалог не появляется, отзовите все разрешения через пункт «Отозвать разрешения для отладки по USB» в настройках разработчика и подключитесь заново.
- 🔄 Порт изменился — возьмите актуальный с экрана «Беспроводная отладка»
- 🚫 Статус unauthorized — подтвердите диалог разрешения на телефоне
- 🌐 Устройства в разных подсетях — подключите оба к одной сети
- 🧱 Брандмауэр или антивирус блокирует adb — добавьте исключение
Как ускорить и стабилизировать работу
Задержка при установке APK и снятии логов по Wi-Fi зависит от качества сети. Если сборка загружается заметно медленнее, чем по кабелю, проверьте загруженность канала: другие устройства, качающие файлы, или слабый сигнал роутера напрямую влияют на скорость. По возможности используйте сеть 5 ГГц — она обычно менее загружена.
Чтобы не вводить команды вручную при каждом подключении, можно сохранить короткий скрипт с adb connect и нужным адресом. А если телефон периодически «отваливается», проверьте настройки энергосбережения: агрессивные режимы сна на некоторых оболочках разрывают фоновые сетевые соединения, и возможная причина обрывов кроется именно в этом.
Почему порт беспроводной отладки постоянно меняется
В Android 11+ при каждом включении беспроводной отладки система назначает новый случайный порт из соображений безопасности. Поэтому сохранённые команды adb connect со старым портом перестают работать — актуальный порт всегда указан на экране настроек беспроводной отладки.
FAQ: частые вопросы об отладке по Wi-Fi
Работает ли отладка по Wi-Fi без USB-кабеля вообще?
Да, на Android 11 и новее — благодаря штатной беспроводной отладке с сопряжением по коду. На более старых версиях кабель нужен один раз для активации режима adb tcpip.
Почему устройство пропадает из списка после перезагрузки телефона?
При использовании метода adb tcpip сетевой режим сбрасывается при перезагрузке — нужно снова подключить кабель и повторить команду. Штатная беспроводная отладка на Android 11+ сохраняется, если переключатель остался включённым, но потребуется повторный adb connect с актуальным портом.
Можно ли отлаживать несколько устройств по Wi-Fi одновременно?
Да, подключите каждое устройство командой adb connect с его IP-адресом и портом. Все они появятся в выводе adb devices, а в Android Studio можно будет выбрать нужную цель запуска.
Чем отличается adb pair от adb connect?
adb pair выполняет одноразовое сопряжение по коду — это аналог подтверждения RSA-ключа при USB-подключении. adb connect устанавливает само рабочее соединение уже после сопряжения. Оба шага обязательны при первом подключении.
Безопасно ли оставлять беспроводную отладку включённой постоянно?
На Android 11+ соединение защищено сопряжением, поэтому риск минимален, но в недоверенных сетях функцию лучше отключать. Режим adb tcpip на порту 5555 без сопряжения оставлять включённым не следует.