Команда adb devices возвращает пустой список — значит, Android Debug Bridge запущен, но смартфон не авторизован: проверьте, включена ли отладка по USB в меню разработчика и подтвержден ли RSA-отпечаток на экране устройства. Именно с этой проверки начинается любая работа с Android Debug Bridge (ADB) — официальной утилитой Google для управления Android-устройством с компьютера.
ADB входит в пакет Android SDK Platform Tools и работает на Windows, macOS и Linux без установки полноценной IDE. В этом материале разберём, как запустить ADB с нуля, какие команды нужны чаще всего и что делать, когда устройство «не видно», появляется статус unauthorized или соединение обрывается.
Что такое Android Debug Bridge и как он устроен
Android Debug Bridge — это клиент-серверная утилита командной строки. Архитектура состоит из трёх компонентов: клиента (команды, которые вы вводите в терминале), демона adbd на самом устройстве и сервера на компьютере, который связывает их между собой. Когда вы запускаете любую команду adb, клиент сначала проверяет, работает ли сервер, и при необходимости запускает его автоматически.
Инструмент позволяет устанавливать и удалять приложения, передавать файлы, читать системные логи, выполнять команды в оболочке устройства и перезагружать его в разные режимы. Большинство операций не требует root-доступа — достаточно включённой отладки по USB.
Установка Platform Tools и запуск ADB
Загрузите архив SDK Platform Tools с официального сайта для разработчиков Android и распакуйте его в отдельную папку, например C:\platform-tools. Установщика нет — утилита портативная, достаточно распаковки. Для удобства путь к папке можно добавить в системную переменную PATH, чтобы запускать adb из любой директории.
Откройте терминал (в Windows — командную строку или PowerShell), перейдите в папку с утилитой и выполните первую команду:
cd C:\platform-tools
adb version
Если в ответ отображается версия утилиты — ADB запущен корректно. Далее подключите смартфон кабелем и проверьте видимость устройства:
adb devicesНа macOS и Linux синтаксис аналогичен, но в папке с утилитой команды запускаются через ./adb devices, если путь не добавлен в окружение.
Включение отладки по USB на смартфоне
Без активированной отладки устройство не появится в списке adb devices в принципе. Сначала нужно открыть скрытый раздел «Для разработчиков»: перейдите в настройки, найдите пункт «О телефоне» и несколько раз подряд нажмите на строку «Номер сборки», пока система не подтвердит активацию режима разработчика. Точное название пункта и его расположение зависят от оболочки производителя, поэтому при расхождениях сверяйтесь с документацией своей модели.
Затем в разделе «Для разработчиков» включите переключатель «Отладка по USB». При первом подключении к компьютеру на экране смартфона появится запрос на разрешение отладки с отпечатком ключа — подтвердите его и при желании отметьте «Всегда разрешать с этого компьютера».
☑️ Подготовка устройства к работе с ADB
Базовые команды ADB для ежедневной работы
После успешного подключения доступен весь набор команд. Начать стоит с самых востребованных — они покрывают установку приложений, передачу файлов и диагностику.
- 📱
adb install app.apk— установка APK-файла на устройство - 📂
adb push file.zip /sdcard/— копирование файла с компьютера на смартфон - 📥
adb pull /sdcard/file.zip— скачивание файла с устройства на ПК - 🐚
adb shell— вход в командную оболочку устройства - 📋
adb logcat— просмотр системных логов в реальном времени - 🔄
adb reboot— перезагрузка устройства (варианты:adb reboot bootloader,adb reboot recovery)
Если к компьютеру подключено несколько устройств, указывайте целевое явно: adb -s <серийный_номер> команда. Серийный номер берётся из вывода adb devices.
Частые ошибки при запуске и их решение
Самая распространённая проблема — пустой вывод adb devices или статус unauthorized. В первом случае виноваты драйверы, кабель или отключённая отладка; во втором — не подтверждён запрос на экране смартфона. Отзовите авторизации в настройках разработчика («Отозвать доступ для отладки по USB») и подключите устройство заново.
Ещё одна типичная ситуация — зависший или конфликтующий сервер ADB. Помогает полный перезапуск:
adb kill-server
adb start-server
adb devices
На Windows дополнительно проверьте Диспетчер устройств: смартфон должен определяться без восклицательных знаков. Если устройство видно системе, но не видно ADB, возможная причина — устаревшая версия Platform Tools, которую стоит обновить до актуальной.
| Симптом | Вероятная причина | Что проверить |
|---|---|---|
| Пустой список в adb devices | Отключена отладка или нет драйвера | Настройки разработчика, Диспетчер устройств |
| Статус unauthorized | Не подтверждён RSA-ключ | Запрос на экране смартфона, отзыв авторизаций |
| Устройство «отваливается» при работе | Кабель или порт USB | Другой кабель, порт USB напрямую без хаба |
| «adb не является командой» | Путь не добавлен в PATH | Запуск из папки platform-tools или настройка PATH |
| offline в списке устройств | Зависший adb-сервер | adb kill-server и повторное подключение |
⚠️ Внимание: команды adb reboot bootloader и последующие операции через fastboot (разблокировка загрузчика, прошивка разделов) могут привести к потере данных и аннулированию гарантии. Выполняйте их только с полным пониманием последствий и по официальной инструкции для вашей модели.
ADB по Wi-Fi: запуск без кабеля
На современных версиях Android (начиная с Android 11) доступна беспроводная отладка без предварительного USB-подключения. В разделе «Для разработчиков» активируйте «Беспроводная отладка» и используйте сопряжение по коду:
adb pair <IP-адрес>:<порт>
adb connect <IP-адрес>:<порт>
Компьютер и смартфон должны находиться в одной сети Wi-Fi. Учтите, что порт для сопряжения и порт для подключения могут отличаться — оба отображаются в меню беспроводной отладки на устройстве.
Беспроводная отладка на старых версиях Android
На Android 10 и ниже сначала нужно подключить устройство кабелем, выполнить adb tcpip 5555, затем отключить кабель и подключиться командой adb connect <IP>:5555. После перезагрузки устройства процедуру придётся повторить.
⚠️ Внимание: не оставляйте беспроводную отладку включённой постоянно, особенно в публичных сетях Wi-Fi — открытый порт ADB теоретически позволяет стороннему устройству в той же сети выполнять команды на вашем смартфоне.
Меры безопасности при работе с ADB
Отладка по USB снимает часть штатных ограничений системы, поэтому к ней стоит относиться как к инструменту с повышенными правами. Придерживайтесь нескольких правил.
- 🔒 Выключайте отладку по USB, когда она не нужна
- 💻 Подтверждайте RSA-отпечаток только на собственном компьютере
- 📦 Скачивайте Platform Tools только с официального сайта разработчиков Android
- 🚫 Не выполняйте команды из непроверенных инструкций, если не понимаете их действие
Отдельного упоминания заслуживают команды удаления системных приложений через adb shell pm uninstall --user 0 <пакет>. Они не требуют root, но удаление критичных компонентов может нарушить работу устройства. Перед удалением любого системного пакета убедитесь, что он не участвует в загрузке системы или работе телефонии — восстановить его без сброса к заводским настройкам бывает затруднительно.
FAQ: частые вопросы о запуске Android Debug Bridge
Нужен ли root-доступ для работы ADB?
Нет. Базовые команды — установка приложений, передача файлов, logcat, перезагрузка — работают на стоковой прошивке без root. Права суперпользователя расширяют возможности внутри adb shell, но для большинства задач не требуются.
Почему adb devices показывает unauthorized?
На экране смартфона не подтверждён запрос на разрешение отладки. Разблокируйте устройство, отключите и снова подключите кабель, затем подтвердите запрос. Если окно не появляется, отзовите все авторизации в настройках разработчика и повторите подключение.
Можно ли запустить ADB на macOS или Linux?
Да, Platform Tools выпускаются для всех трёх платформ. На macOS и Linux команды запускаются через терминал с префиксом ./ из папки с утилитой, либо путь добавляется в переменную окружения. Драйверы, как в Windows, обычно не требуются.
Что делать, если команда adb не распознаётся в терминале?
Терминал не находит исполняемый файл. Либо перейдите в папку platform-tools командой cd и запускайте оттуда, либо добавьте путь к папке в системную переменную PATH и откройте новое окно терминала.
Опасно ли держать отладку по USB включённой?
При подключении к чужому компьютеру потребуется подтверждение на экране, поэтому самопроизвольный доступ маловероятен. Тем не менее разумная практика — отключать отладку, когда она не используется, и никогда не подтверждать запросы на незнакомых устройствах.