Команда adb devices возвращает пустой список или строку unauthorized — это самая частая причина, по которой пользователь открывает командную строку ADB впервые. В большинстве подобных случаев проблема решается не переустановкой драйверов, а проверкой трёх вещей: включена ли отладка по USB на смартфоне, подтверждён ли запрос на разрешение отладки на экране устройства и видит ли ПК устройство на уровне системы.
ADB (Android Debug Bridge) — официальная утилита из состава Android SDK Platform Tools, которая позволяет управлять смартфоном или планшетом через команды: устанавливать приложения, передавать файлы, снимать скриншоты, читать системные журналы и удалять предустановленные программы. Инструмент работает на Windows, macOS и Linux и не требует root-прав для базовых операций.
Что такое ADB и как устроена командная строка
ADB состоит из трёх компонентов: клиента (командная строка на ПК), демона adbd (фоновый процесс на устройстве) и сервера, который связывает их между собой. Когда вы вводите команду в терминале, клиент отправляет её серверу, а тот передаёт запрос демону на смартфоне. Поэтому при сбоях первым делом проверяют, какое звено цепочки не отвечает.
Работа ведётся через обычную командную строку — cmd.exe или PowerShell в Windows. Открывать терминал нужно в папке, где лежит исполняемый файл adb.exe, либо добавить путь к нему в переменную окружения PATH, чтобы команда работала из любой директории.
Установка ADB на компьютер
Установка сводится к загрузке архива SDK Platform Tools с официального сайта для разработчиков Android и распаковке его в удобную папку, например C:\adb. Отдельный инсталлятор не требуется — утилита портативная. После распаковки зажмите Shift, кликните правой кнопкой по папке и выберите пункт открытия окна команд, либо вручную перейдите в каталог через команду cd.
Дополнительно может понадобиться USB-драйвер от производителя смартфона — особенно для устройств с нестандартными контроллерами. Google распространяет драйвер для своих устройств отдельно, а для других брендов драйвер обычно доступен на сайте производителя. Если ПК не видит устройство даже в диспетчере устройств Windows, начинать диагностику нужно именно с драйвера и кабеля.
Как добавить ADB в переменную PATH
Откройте «Система» → «Дополнительные параметры системы» → «Переменные среды». В списке системных переменных найдите Path, нажмите «Изменить» и добавьте путь к папке с adb.exe. После перезапуска терминала команда adb будет работать из любой директории.
Включение отладки по USB на смартфоне
Прежде чем вводить первую команду, на устройстве необходимо активировать режим разработчика. Стандартный путь: открыть настройки, перейти в раздел «О телефоне» и несколько раз нажать на пункт «Номер сборки» до появления уведомления о разблокировке режима разработчика. Точные названия пунктов зависят от оболочки и версии Android, поэтому при расхождениях сверьтесь с инструкцией для вашей модели.
Затем в разделе «Для разработчиков» включите переключатель «Отладка по USB» (USB debugging). При первом подключении к ПК на экране смартфона появится запрос на разрешение отладки с отпечатком ключа компьютера — его нужно подтвердить, при желании установив галочку «Всегда разрешать с этого компьютера». Без этого подтверждения устройство будет отображаться со статусом unauthorized.
☑️ Подготовка к первому подключению ADB
Базовые команды командной строки ADB
Начинать работу стоит с проверки связи. Команда ниже выводит список подключённых устройств и их состояние:
adb devicesЕсли устройство определилось со статусом device, доступен весь основной функционал. Вот команды, которые используются чаще всего:
- 📦
adb install app.apk— установка APK-файла на устройство - 🗑️
adb uninstall com.example.app— удаление приложения по имени пакета - 📁
adb push file.txt /sdcard/— копирование файла с ПК на смартфон - 📥
adb pull /sdcard/file.txt— скачивание файла с устройства на ПК - 🔄
adb reboot— перезагрузка устройства из командной строки
Для диагностики полезны команды adb shell (доступ к консоли устройства) и adb logcat (чтение системного журнала в реальном времени). Просмотр списка установленных пакетов выполняется командой adb shell pm list packages — она нужна, например, чтобы узнать точное имя пакета перед удалением предустановленного приложения.
| Команда | Назначение | Требуется root |
|---|---|---|
| adb devices | Список подключённых устройств | Нет |
| adb install | Установка APK | Нет |
| adb reboot bootloader | Перезагрузка в режим fastboot | Нет |
| adb shell pm uninstall --user 0 | Отключение системного приложения | Нет |
| adb logcat | Просмотр системного журнала | Нет |
Решение типичных ошибок
Ошибка device not found означает, что сервер ADB не видит устройство. Проверьте по порядку: работает ли кабель на передачу данных (некоторые кабели поддерживают только зарядку), определяется ли смартфон в диспетчере устройств Windows, не занят ли порт ADB другой программой. Перезапуск сервера часто помогает:
adb kill-server
adb start-server
Статус unauthorized говорит о том, что запрос на разрешение отладки не подтверждён. Отключите и снова подключите кабель, следя за экраном смартфона. Если запрос не появляется, отзовите все разрешения в разделе «Для разработчиков» (пункт вроде «Отозвать разрешения на отладку по USB») и подключите устройство заново.
⚠️ Внимание: командыadb shell pm uninstallдля системных пакетов могут нарушить работу устройства, если удалить критичный компонент. Перед удалением убедитесь, что пакет действительно относится к ненужному приложению, и предпочитайте вариант с флагом--user 0, который позволяет вернуть приложение сбросом настроек.
⚠️ Внимание: команды adb reboot bootloader и работа в режиме fastboot открывают доступ к разделам прошивки. Не выполняйте команды стирания или записи разделов без полного понимания последствий — ошибка может привести к невозможности загрузки устройства.
Ещё одна частая ситуация — команда adb не распознаётся системой с сообщением «не является внутренней или внешней командой». Это значит, что терминал открыт не в папке с adb.exe и путь не добавлен в PATH. Вернитесь к разделу об установке и проверьте переменную окружения.
Беспроводное подключение по Wi-Fi
Начиная с Android 11, доступна беспроводная отладка без предварительного подключения кабелем: в разделе «Для разработчиков» активируется соответствующий переключатель, после чего сопряжение выполняется по коду или QR-коду. На более ранних версиях Android сначала требовалось подключение по USB и команда перевода демона в сетевой режим:
adb tcpip 5555
adb connect 192.168.1.50:5555
IP-адрес устройства смотрят в настройках Wi-Fi. Учтите, что беспроводное соединение менее стабильно и потенциально менее безопасно: после завершения работы отладку по сети разумно отключить, особенно если смартфон бывает в общественных сетях. Точные названия пунктов беспроводной отладки различаются между оболочками — сверяйтесь с документацией своей модели.
Проверка подключения в сетевом режиме
После команды adb connect снова выполните adb devices — устройство должно отображаться в формате IP:порт со статусом device. Если статус offline, отключите соединение командой adb disconnect и повторите сопряжение.
Меры безопасности при работе с ADB
Открытая отладка по USB — это потенциальный вектор доступа к данным устройства. Держите её включённой только на время работы и не подтверждайте запросы на отладку от чужих компьютеров и публичных зарядных станций. Отпечаток ключа в запросе позволяет убедиться, что подключается именно ваш ПК.
⚠️ Внимание: не загружайте Platform Tools и драйверы со сторонних сайтов и «сборок» — используйте только официальный источник для разработчиков Android. Модифицированные версии утилиты встречаются в дистрибутивах с вредоносным кодом.
Если вы экспериментируете с удалением системных приложений, заранее запишите имена пакетов, которые меняете — это упростит восстановление. А перед любыми операциями, затрагивающими разделы прошивки, сделайте резервную копию важных данных штатными средствами устройства.
Часто задаваемые вопросы
Нужен ли root для работы с ADB?
Нет. Подавляющее большинство команд — установка приложений, передача файлов, чтение логов, перезагрузка, отключение системных пакетов через --user 0 — работают без root-прав. Root требуется лишь для отдельных операций внутри adb shell, затрагивающих защищённые области системы.
Почему команда adb не распознаётся в командной строке?
Терминал не находит файл adb.exe. Либо откройте командную строку непосредственно в папке Platform Tools, либо добавьте путь к ней в системную переменную PATH и перезапустите терминал.
Что означает статус unauthorized в adb devices?
Устройство подключено, но не подтверждён запрос на разрешение отладки по USB. Разблокируйте смартфон и подтвердите запрос на его экране. Если запрос не появляется, отзовите ранее выданные разрешения в настройках разработчика и подключите кабель заново.
Можно ли пользоваться ADB без USB-кабеля?
Да. На Android 11 и новее есть штатная беспроводная отладка с сопряжением по коду. На более ранних версиях требуется первичное подключение по USB для перевода ADB в сетевой режим командами adb tcpip и adb connect.
Опасно ли удалять системные приложения через ADB?
Команда с флагом --user 0 удаляет приложение только для текущего пользователя и обратима сбросом настроек, однако удаление критичных компонентов может нарушить работу функций устройства. Проверяйте назначение каждого пакета перед удалением и не трогайте пакеты, назначение которых вам неизвестно.