Команда adb devices возвращает пустой список — типичная ситуация при первой попытке подключить смартфон к компьютеру для отладки. Причина почти всегда одна из трёх: не включена отладка по USB в настройках разработчика, не установлен драйвер или не подтверждён запрос на сопряжение на экране телефона. Ниже разберём каждый шаг подключения к ADB — от подготовки телефона до работы по Wi-Fi.
ADB (Android Debug Bridge) — официальная утилита от Google для взаимодействия компьютера с Android-устройством. С её помощью устанавливают приложения, снимают логи, передают файлы и выполняют системные команды. Инструмент работает на Windows, macOS и Linux, а само подключение занимает несколько минут, если соблюсти порядок действий.
Шаг 1: Включение режима разработчика и отладки по USB
На стоковом Android режим разработчика скрыт по умолчанию. Чтобы его активировать, откройте Настройки → О телефоне и несколько раз подряд (обычно семь) нажмите на пункт Номер сборки. Система попросит ввести PIN-код или пароль блокировки, после чего появится сообщение «Вы стали разработчиком».
Далее вернитесь в настройки и найдите раздел Для разработчиков — в зависимости от оболочки он может находиться в Система или Расширенные настройки. Внутри включите переключатель Отладка по USB (USB debugging). На некоторых прошивках, например MIUI или HyperOS, дополнительно требуется пункт «Установка через USB» — включите его, если планируете ставить приложения через ADB.
⚠️ Внимание: точные названия пунктов меню и их расположение зависят от производителя и версии прошивки. Если перечисленных пунктов нет на указанных местах, воспользуйтесь поиском по настройкам или официальной инструкцией для вашей модели.
Шаг 2: Установка ADB на компьютер
Утилита ADB распространяется в составе пакета SDK Platform Tools — это официальный архив от Google, который не требует установки. Достаточно скачать его с официального сайта Android Developers и распаковать в удобную папку, например C:\platform-tools на Windows.
Чтобы вызывать ADB из любого каталога, добавьте путь к папке в системную переменную PATH. Альтернатива — открыть терминал прямо в папке с утилитой: в проводнике Windows зажмите Shift, кликните правой кнопкой по папке и выберите «Открыть окно PowerShell здесь». На macOS и Linux используйте cd для перехода в каталог, а команды запускайте с префиксом ./adb.
Для Windows может потребоваться USB-драйвер производителя смартфона. Устройства Google Pixel работают с драйвером Google USB Driver из состава SDK, для остальных брендов драйвер скачивается с сайта производителя. На macOS и Linux отдельные драйверы обычно не нужны.
☑️ Подготовка к подключению
Шаг 3: Подключение по USB-кабелю
Соедините смартфон и компьютер кабелем. Важно использовать кабель с поддержкой передачи данных — некоторые дешёвые кабели рассчитаны только на зарядку, и через них ADB не заработает. Если устройство не определяется, первым делом замените кабель и попробуйте другой USB-порт, желательно напрямую, без хабов.
После подключения на экране телефона появится диалог «Разрешить отладку по USB?» с отпечатком RSA-ключа компьютера. Отметьте «Всегда разрешать с этого компьютера» и нажмите «ОК». Теперь проверьте соединение командой:
adb devicesВ выводе должна появиться строка с серийным номером устройства и статусом device. Если вместо этого вы видите unauthorized — диалог на телефоне не был подтверждён: отключите кабель, подключите снова и разрешите доступ. Пустой список означает проблему с драйвером, кабелем или тем, что отладка не включена.
Шаг 4: Подключение по Wi-Fi
Начиная с Android 11, в систему встроена беспроводная отладка без необходимости предварительного подключения кабелем. Откройте Настройки → Для разработчиков → Беспроводная отладка и включите её. Телефон и компьютер должны находиться в одной сети Wi-Fi.
Есть два способа сопряжения. Первый — через QR-код: нажмите «Сопряжение устройства с помощью QR-кода» и в терминале выполните:
adb pair ip_адрес:портАдрес и порт для сопряжения показаны на экране телефона в разделе беспроводной отладки. После ввода кода сопряжения подключитесь командой adb connect ip_адрес:порт — обратите внимание, что порт подключения отличается от порта сопряжения и указан на главном экране раздела.
На устройствах с Android 10 и старше встроенной беспроводной отладки нет. Там используется классическая схема: сначала подключите телефон по USB, выполните adb tcpip 5555, затем отсоедините кабель и подключитесь командой adb connect ip_адрес:5555. После перезагрузки телефона процедуру придётся повторить.
Как узнать IP-адрес телефона
Откройте Настройки → О телефоне (или «Сведения о телефоне») и найдите строку «IP-адрес». Альтернативный путь: Настройки → Wi-Fi → нажмите на текущую сеть — адрес будет указан в сведениях о подключении.
Типичные ошибки и их решение
Даже при правильной настройке подключение иногда сбоит. В таблице собраны частые состояния и способы их устранения.
| Симптом | Вероятная причина | Что делать |
|---|---|---|
| Пустой список в adb devices | Нет драйвера или отладка выключена | Проверить Диспетчер устройств, включить отладку |
| Статус unauthorized | Не подтверждён RSA-ключ | Переподключить кабель и разрешить доступ на экране |
| Статус offline | Устаревшая версия ADB или сбой сервера | Выполнить adb kill-server и adb start-server |
| adb connect: connection refused | Беспроводная отладка выключена или другой порт | Проверить порт на экране телефона |
| Устройство пропадает после блокировки | Энергосбережение разрывает соединение | Отключить оптимизацию батареи для отладки, если такая опция есть |
Универсальное средство при странном поведении — перезапуск ADB-сервера. Команды adb kill-server и затем adb start-server сбрасывают зависшие соединения без перезагрузки компьютера и телефона.
⚠️ Внимание: не оставляйте отладку по USB включённой постоянно, если она вам не нужна. Через ADB при разблокированном устройстве возможен доступ к данным, поэтому после завершения работы функцию лучше выключить, а список авторизованных компьютеров очистить пунктом «Отозвать доступ для отладки по USB».
Базовые команды для проверки работы
После успешного подключения полезно убедиться, что основные функции работают. Вот минимальный набор команд для проверки:
- 📱
adb devices— список подключённых устройств и их статус; - 📦
adb shell— открытие командной оболочки устройства; - 📂
adb push файл /sdcard/— отправка файла на телефон; - 📥
adb pull /sdcard/файл— скачивание файла с телефона; - 🧩
adb install app.apk— установка APK-файла.
Если к компьютеру подключено несколько устройств одновременно, указывайте целевое флагом -s с серийным номером: adb -s серийный_номер shell. Иначе команда завершится ошибкой «more than one device».
⚠️ Внимание: команды adb shell pm uninstall и другие операции с системными пакетами могут нарушить работу прошивки. Удаляйте только те приложения, в назначении которых уверены, и предварительно сделайте резервную копию важных данных.
Часто задаваемые вопросы
Можно ли подключиться к ADB без USB-кабеля вообще?
Да, если на устройстве Android 11 или новее — функция «Беспроводная отладка» позволяет выполнить сопряжение и подключение полностью по Wi-Fi. На Android 10 и старше первичная активация TCP-режима через кабель обязательна.
Почему телефон не показывает запрос на разрешение отладки?
Возможные причины: отладка по USB не включена, кабель передаёт только питание, сбой ADB-сервера. Перезапустите сервер командами adb kill-server и adb start-server, замените кабель и проверьте, что переключатель отладки активен.
Работает ли ADB без root-прав?
Да, базовые функции — установка приложений, передача файлов, чтение логов, выполнение shell-команд — доступны без root. Права суперпользователя нужны только для операций с защищёнными разделами и системными файлами.
Что делать, если Windows не видит телефон в Диспетчере устройств?
Проверьте кабель и порт, переключите режим USB на телефоне с «Только зарядка» на «Передача файлов (MTP)». Если устройство отображается с жёлтым восклицательным знаком, установите драйвер производителя вручную через «Обновить драйвер».
Безопасно ли подключаться к ADB по Wi-Fi?
Беспроводная отладка использует шифрованное сопряжение с кодом подтверждения, поэтому в домашней сети это безопасно. В публичных сетях Wi-Fi включать её не стоит — держите функцию выключенной вне доверенной сети.