Команда adb devices возвращает пустой список или статус unauthorized — с этой ситуацией сталкивается почти каждый, кто впервые подключает смартфон к компьютеру для отладки. Причина обычно кроется не в неисправности, а в том, что на устройстве не включена отладка по USB, не подтверждён цифровой отпечаток компьютера или в системе отсутствует нужный драйвер.
ADB (Android Debug Bridge) — это консольная утилита из состава Android SDK Platform Tools, которая позволяет компьютеру обмениваться командами с Android-устройством: устанавливать приложения, копировать файлы, читать системные журналы и выполнять shell-команды. Инструмент используют разработчики, тестировщики и опытные пользователи, которым нужен доступ к функциям, недоступным через обычный интерфейс системы.
Что такое ADB и из чего он состоит
ADB работает по клиент-серверной схеме из трёх компонентов. Клиент — это команда, которую вы вводите в терминале на компьютере. Демон (adbd) — фоновый процесс на самом Android-устройстве, который исполняет поступающие команды. Сервер — посредник на компьютере, который управляет соединением между клиентом и демоном через USB или сеть.
Раньше для работы ADB требовалось скачивать полный Android SDK весом в сотни мегабайт. Сейчас Google распространяет пакет SDK Platform Tools отдельно: это компактный архив, в который входят adb, fastboot и несколько вспомогательных утилит. Для большинства задач достаточно именно его, полная среда Android Studio не обязательна.
Установка SDK Platform Tools на компьютер
Загрузите архив SDK Platform Tools с официального сайта Android Developers — там доступны версии для Windows, macOS и Linux. Распакуйте его в папку с простым путём без кириллицы и пробелов, например C:\platform-tools. Это упростит запуск и настройку переменных окружения.
Чтобы вызывать adb из любой директории, а не только из папки с утилитой, добавьте путь к ней в системную переменную PATH. В Windows это делается через «Система → Дополнительные параметры системы → Переменные среды». В macOS и Linux путь прописывается в профиле командной оболочки, например в файле ~/.zshrc или ~/.bashrc.
☑️ Подготовка ADB к работе
Проверьте установку командой:
adb versionЕсли терминал выводит номер версии утилиты — установка прошла успешно. Ошибка «команда не найдена» означает, что либо путь в PATH указан неверно, либо терминал не был перезапущен после изменения переменных окружения.
Включение отладки по USB на устройстве
На смартфоне или планшете отладка по умолчанию скрыта. Сначала активируйте режим разработчика: откройте Настройки → О телефоне и несколько раз подряд нажмите на пункт «Номер сборки» — система покажет уведомление о включении режима. Точное название пункта может отличаться в зависимости от оболочки производителя.
После этого в настройках появится раздел «Для разработчиков», где нужно включить переключатель «Отладка по USB». При первом подключении к компьютеру на экране устройства появится запрос на разрешение отладки с отпечатком ключа RSA — подтвердите его, при желании отметив «Всегда разрешать с этого компьютера».
⚠️ Внимание: отладка по USB даёт подключённому компьютеру широкий доступ к устройству. Не подтверждайте запрос на авторизацию на чужих или общедоступных компьютерах и выключайте отладку, когда она не нужна.
Проверка подключения и решение типичных проблем
Подключите устройство кабелем и выполните:
adb devicesВ ответ выводится список подключённых устройств с их состоянием. Возможны три варианта: device — всё готово к работе; unauthorized — на смартфоне не подтверждён запрос на отладку, проверьте экран; пустой список — компьютер вообще не видит устройство.
- 🔌 Попробуйте другой USB-кабель: часть кабелей поддерживает только зарядку и не передаёт данные.
- 🖥️ Смените USB-порт, желательно подключившись напрямую к материнской плате, без хабов.
- 💾 На Windows проверьте в Диспетчере устройств, установлен ли драйвер — неизвестное устройство с восклицательным знаком указывает на его отсутствие.
- 🔄 Перезапустите сервер командами
adb kill-serverиadb start-server. - 🔓 Убедитесь, что экран устройства разблокирован — на некоторых прошивках запрос авторизации не появляется на заблокированном экране.
⚠️ Внимание: на Windows отсутствие драйвера — самая частая причина пустого списка adb devices. Драйверы публикуют производители устройств; для многих моделей подходит универсальный драйвер Google USB Driver, но совместимость зависит от конкретного устройства.
Основные команды ADB
Набор команд ADB обширен, но на практике чаще всего используется ограниченный список. Ниже — базовые команды, которых достаточно для повседневной работы.
| Команда | Назначение |
|---|---|
adb devices | Список подключённых устройств и их статус |
adb install app.apk | Установка APK-файла на устройство |
adb uninstall com.example.app | Удаление приложения по имени пакета |
adb shell | Интерактивная командная оболочка устройства |
adb logcat | Просмотр системных журналов в реальном времени |
Для передачи файлов служат команды adb push (с компьютера на устройство) и adb pull (в обратную сторону). Например, adb pull /sdcard/DCIM ./photos скопирует папку со снимками на компьютер. Команда adb reboot перезагружает устройство, а её варианты adb reboot bootloader и adb reboot recovery переводят его в соответствующие режимы — если они поддерживаются конкретной моделью.
Если к компьютеру подключено несколько устройств, уточняйте целевое через параметр -s с серийным номером из вывода adb devices, например: adb -s ABCD1234 shell. Без этого параметра ADB выдаст ошибку о неоднозначности выбора.
ADB по Wi-Fi: отладка без кабеля
Современные версии Android поддерживают беспроводную отладку: устройство и компьютер должны находиться в одной сети Wi-Fi. В разделе «Для разработчиков» активируйте пункт «Беспроводная отладка» — система покажет IP-адрес, порт и код сопряжения.
Подключение выполняется в два этапа:
adb pair 192.168.1.50:37000
adb connect 192.168.1.50:5555
Адрес и порты в примере условные — подставьте значения, которые показывает ваше устройство. На старых версиях Android беспроводной режим включается иначе: сначала по USB выполняется adb tcpip 5555, после чего кабель можно отключить и подключаться через adb connect. Беспроводная отладка автоматически отключается при смене сети или перезагрузке — это нормальное поведение, а не сбой.
Почему ADB по Wi-Fi периодически отваливается
Беспроводное соединение чувствительно к энергосбережению: когда экран устройства гаснет, система может приостанавливать сетевые службы. Также роутер может выдать устройству другой IP-адрес после переподключения. Решение — заново выполнить adb connect с актуальным адресом или закрепить статический IP за устройством в настройках роутера.
Безопасность и типичные ошибки
ADB — мощный инструмент, и ряд команд способен нарушить работу системы. Удаление системных пакетов через adb shell pm uninstall может привести к сбоям оболочки, а команды с fastboot — к потере данных. Перед экспериментами с системными приложениями убедитесь, что у вас есть резервная копия важных данных.
- 🛡️ Выполняйте команды из незнакомых инструкций только если понимаете, что каждая из них делает.
- 📦 Перед удалением системного пакета проверьте его назначение — часть пакетов критична для загрузки системы.
- 🔑 После завершения работы отключите отладку по USB и отзовите авторизации через пункт «Отозвать разрешения на отладку» в настройках разработчика.
- 📱 Не используйте ADB на устройствах с корпоративными политиками без согласования — это может нарушать политику безопасности организации.
Часто задаваемые вопросы
Нужен ли root-доступ для работы ADB?
Нет. Большинство команд ADB работает на устройствах без root-прав: установка приложений, передача файлов, чтение логов, перезагрузка. Root требуется лишь для отдельных операций внутри adb shell, затрагивающих защищённые разделы системы.
Чем ADB отличается от Fastboot?
ADB работает, когда устройство загружено в Android, и взаимодействует с системой. Fastboot работает на уровне загрузчика (bootloader) и используется для прошивки разделов, разблокировки загрузчика и восстановления. Оба инструмента входят в один пакет Platform Tools, но запускаются в разных режимах устройства.
Почему adb devices показывает unauthorized?
Устройство видит подключение, но компьютер не авторизован. Разблокируйте экран смартфона — должен появиться диалог с запросом разрешения отладки, подтвердите его. Если диалог не появляется, отзовите прежние авторизации в настройках разработчика и переподключите кабель.
Можно ли пользоваться ADB без установки Android Studio?
Да. Для работы ADB достаточно пакета SDK Platform Tools, который скачивается отдельно. Android Studio нужна только для полноценной разработки приложений — эмуляторов, SDK-платформ и инструментов сборки.
Работает ли ADB на macOS и Linux?
Да, Platform Tools выпускается для всех трёх платформ. На macOS и Linux, как правило, не требуется устанавливать отдельные USB-драйверы — система распознаёт устройства штатно, в отличие от Windows. На Linux может понадобиться настройка правил udev для доступа к устройству без прав суперпользователя.