Отладка по Wi-Fi на Android: как связать телефон с Mac

Отладка по Wi-Fi передаёт подключение разработчика Android, adb, по вашей сети Wi-Fi вместо USB-кабеля. Вам нужны Android 11 или новее, включённый режим разработчика и телефон с Mac в одной сети. На телефоне откройте Для разработчиков > Отладка по Wi-Fi, включите её и нажмите Подключить устройство с помощью кода подключения. Телефон покажет шестизначный код, который вы один раз сообщаете Mac. После этого они смогут подключаться друг к другу всякий раз, когда оказываются в одной сети.

Со стороны Mac это можно сделать двумя способами: собственным инструментом adb от Google в Терминале или приложением, которое свяжет всё за вас. Оба описаны ниже, а за ними то, что стоит попробовать, если телефон и Mac не связываются.

Перед началом

• Android 11 или новее. Проверьте в разделе Настройки > О телефоне. Старые версии предлагают adb по Wi-Fi только после подключения по USB, командой adb tcpip 5555.
• Режим разработчика включён. Нажмите на номер сборки семь раз. Где номер сборки у каждого производителя, показано в статье Как включить отладку по USB. На Pixel после этого раздел «Для разработчиков» появится в меню Настройки > Система.
• Одна сеть. Телефон подключён к Wi-Fi, а Mac к той же сети Wi-Fi или кабелем к тому же роутеру. Только не гостевая сеть: подробнее об этом ниже.

Включите отладку по Wi-Fi

Откройте Для разработчиков и найдите Отладка по Wi-Fi. Нажмите на название, а не на переключатель, чтобы открылась отдельная страница, и включите отладку там. Телефон спросит, разрешить ли отладку по Wi-Fi в этой сети. Если сеть ваша, отметьте Всегда разрешать отладку в этой сети и нажмите Разрешить.

Теперь на странице видны адрес и порт телефона, список подключённых устройств и два способа связать: Подключить устройство с помощью QR-кода и Подключить устройство с помощью кода подключения. QR-код нужен для Android Studio и приложений, которые его показывают. Код подключения работает со всем.

Если вы будете часто включать и выключать отладку, добавьте плитку: Для разработчиков > Элементы в быстрых настройках > Отладка по Wi-Fi.

Как связать через adb в Терминале

Установите SDK Platform-Tools от Google, в которых есть adb. С Homebrew это одна строка; иначе скачайте их с сайта Google для разработчиков Android.

brew install --cask android-platform-tools

На телефоне нажмите Подключить устройство с помощью кода подключения. Появится окно с шестизначным кодом и адресом с портом, например 192.168.1.23:37155. Не закрывайте его. На Mac выполните adb pair с этим адресом и введите код, когда его спросят:

adb pair 192.168.1.23:37155

Терминал сообщит, что связь установлена, а Mac появится на телефоне в списке Подключённые устройства. Этот порт нужен был только для связывания. Для подключения используйте адрес и порт, показанные вверху страницы Отладка по Wi-Fi, а порт там другой:

adb connect 192.168.1.23:41689
adb devices

Свежие версии adb часто сами находят связанный телефон в сети и подключаются к нему, так что adb devices может показать его ещё до того, как вы введёте adb connect. Порт подключения может измениться, если выключить и снова включить отладку по Wi-Fi, поэтому каждый раз смотрите его на телефоне.

Дальше adb работает так же, как по кабелю: adb pull /sdcard/DCIM/Camera ~/Desktop/Camera копирует папку камеры, adb shell открывает командную оболочку. Чтобы разорвать связь, нажмите на Mac в списке Подключённые устройства и выберите Удалить.

Как связать через SideMount

SideMount монтирует телефон как том в Finder, по кабелю или, после связывания, по Wi-Fi. Он сам говорит на adb, так что platform-tools не нужны. Откройте его панель в строке меню и выберите Connect over Wi-Fi (эта кнопка видна, пока ни один телефон не подключён кабелем) или нажмите Pair рядом с Pair a phone over Wi-Fi в его настройках. Панель покажет QR-код для пункта Подключить устройство с помощью QR-кода, а если вы выберете Use a pairing code instead, будет ждать телефон, на котором показан код. Нажмите на телефоне Подключить устройство с помощью кода подключения и введите шесть цифр в панели.

В первый раз macOS спросит, может ли приложение искать устройства в вашей локальной сети. Разрешите, иначе ничего не появится. Ответ можно изменить в разделе Системные настройки > Конфиденциальность и безопасность > Локальная сеть.

После этого телефон монтируется в Finder всякий раз, когда он в той же сети и отладка по Wi-Fi включена, а если подключить ещё и кабель, работа перейдёт на кабель. Нужна macOS 26 или новее; остальное о первом подключении рассказано в руководстве по настройке.

Оценивайте скорость трезво. По нашим замерам телефон, смонтированный через домашнюю сеть Wi-Fi, передавал от 13 до 18 MB/s, а тот же телефон по кабелю от 270 до 280 MB/s. Для нескольких документов или фото это нормально, а для всех видео с телефона медленно. Все способы передать файлы с Android на Mac без кабеля сравниваются в отдельной статье.

Если связать не получается

Код устарел или окно закрылось

Телефон принимает код, только пока на экране открыто окно связывания. Если экран заблокировался или вы переключились на другое приложение, снова нажмите Подключить устройство с помощью кода подключения и используйте новый код. Код, введённый с ошибкой, отклоняется без объяснений, так что новый код лечит и это.

Гостевая сеть или сеть, которая разделяет устройства

Многие гостевые сети, а также многие сети в отелях, учебных заведениях и офисах используют изоляцию клиентов: каждое устройство может выйти в интернет, но не может связаться с другими устройствами. Для отладки по Wi-Fi телефон и Mac должны видеть друг друга напрямую, а всё, что находит телефон за вас, полагается на то, что телефон объявляет о себе в сети, и такие сети это часто блокируют. Используйте домашнюю сеть, а если и там не получается, найдите в настройках роутера изоляцию клиентов или изоляцию точки доступа (client isolation, AP isolation) и убедитесь, что для вашей сети она выключена.

VPN на Mac или телефоне

VPN может уводить локальный трафик из вашей сети, и тогда телефон и Mac не встретятся. Выключите его на время связывания или разрешите в его настройках доступ к локальной сети, затем попробуйте снова.

Отладка по Wi-Fi выключилась сама

На Android 16 и более ранних версиях отладка по Wi-Fi часто выключается сама, когда телефон меняет сеть или перезагружается. Включите её снова и проверьте порт, который мог измениться. На Android 17 с platform-tools 37.0.0 или новее на Mac функция ADB Wi-Fi 2.0 от Google заставляет телефон снова включать её самостоятельно в сетях, которые вы разрешили.

Старый adb или зависший сервер adb

Для связывания нужен свежий adb. Обновите platform-tools, выполните adb kill-server и попробуйте снова. Если не срабатывает обнаружение, adb connect с адресом и портом с телефона работает и без него.

Вопросы