Команда adb devices возвращает пустой список, хотя смартфон подключён кабелем и заряжается — это самый частый симптом, с которого начинается знакомство с ADB. Причина почти всегда одна из трёх: не включена отладка по USB, не установлен драйвер на компьютере или не подтверждён запрос на авторизацию на экране телефона. Пока эти три условия не выполнены, ни одна команда ADB работать не будет.
ADB (Android Debug Bridge) — это официальная утилита из состава Android SDK Platform-Tools, которая позволяет управлять устройством с компьютера через командную строку: устанавливать приложения, снимать логи, удалять системные программы, перезагружаться в recovery и многое другое. В этом руководстве разберём установку, подключение и команды, которые реально используются на практике.
Установка ADB на компьютер
Утилита распространяется бесплатно в составе пакета Platform-Tools с официального сайта для разработчиков Android. Доступны версии для Windows, macOS и Linux. Установка как таковая не требуется: достаточно скачать архив и распаковать его в удобную папку, например C:\platform-tools.
Чтобы запускать adb из любой директории, путь к папке добавляют в системную переменную PATH. На Windows это делается через «Система → Дополнительные параметры системы → Переменные среды». Альтернативный вариант — открыть командную строку прямо в папке с утилитой: в проводнике зажать Shift, нажать правой кнопкой по папке и выбрать «Открыть окно PowerShell здесь».
Проверить корректность установки можно одной командой:
adb versionЕсли в ответ выводится номер версии — всё настроено правильно. Если система сообщает, что команда не найдена, проблема в переменной PATH или в том, что терминал открыт не в той директории.
Подключение устройства и включение отладки
Прежде чем вводить команды, необходимо активировать отладку по USB на самом смартфоне. Сначала открывается режим разработчика: в разделе «О телефоне» нужно несколько раз подряд нажать на пункт «Номер сборки» — точное название пункта и его расположение зависят от оболочки (MIUI, One UI, ColorOS и чистый Android отличаются), поэтому при затруднениях стоит свериться с инструкцией для конкретной модели.
После этого в настройках появляется раздел «Для разработчиков», где включается переключатель «Отладка по USB». При первом подключении к компьютеру на экране смартфона появится запрос на разрешение отладки — его нужно подтвердить, желательно с галочкой «Всегда разрешать».
☑️ Подготовка устройства к работе с ADB
adb devicesЕсли устройство определилось, в списке появится его серийный номер со статусом device. Статус unauthorized означает, что на телефоне не подтверждён запрос. Статус offline или пустой список чаще всего указывает на кабель «только для зарядки» без линий передачи данных — это первая вещь, которую стоит проверить физической заменой кабеля.
⚠️ Внимание: включённая отладка по USB снижает защиту устройства. Не подтверждайте запросы на авторизацию на чужих компьютерах и отключайте отладку, если она не нужна постоянно.
Базовые команды ADB
Этот набор команд покрывает большинство повседневных задач. Все они выполняются из командной строки компьютера при подключённом устройстве.
- 📱
adb devices— список подключённых устройств и их статус - 🔄
adb reboot— обычная перезагрузка смартфона - 📥
adb install app.apk— установка APK-файла на устройство - 🗑️
adb uninstall com.example.app— удаление приложения по имени пакета - 📤
adb push file.txt /sdcard/— копирование файла с компьютера на телефон - 📥
adb pull /sdcard/DCIM/ ./— копирование файлов с телефона на компьютер - 🔌
adb kill-serverиadb start-server— перезапуск ADB-сервера при зависаниях
Имя пакета приложения для команды удаления можно узнать через adb shell pm list packages — команда выведет полный список установленных пакетов. Чтобы найти конкретное приложение, список фильтруют по части названия.
Обратите внимание на разницу между uninstall и отключением системных приложений: стандартное удаление через ADB затрагивает только текущего пользователя, а сам пакет остаётся в системном разделе и вернётся после сброса настроек. Это делает операцию относительно безопасной, но удалять пакеты, назначение которых неизвестно, всё равно не стоит.
Работа с adb shell
Команда adb shell открывает терминал непосредственно внутри Android, где доступны Linux-утилиты и специальные менеджеры системы. Это самый мощный режим ADB: через него управляют разрешениями, настройками, процессами и файлами.
| Команда | Назначение |
|---|---|
pm list packages | Список всех установленных пакетов |
pm disable-user имя_пакета | Отключение приложения без удаления |
dumpsys battery | Информация о батарее и её состоянии |
screencap /sdcard/screen.png | Снятие скриншота с сохранением в файл |
logcat | Просмотр системного журнала в реальном времени |
Особого внимания заслуживает logcat — основной инструмент диагностики. Когда приложение вылетает, а причина непонятна, запускают adb logcat, воспроизводят ошибку и смотрят стек ошибки в выводе. Для удобства журнал фильтруют по тегу приложения или уровню важности сообщений.
Команда pm disable-user — безопасный способ отключить ненужное системное приложение: оно перестаёт работать и исчезает из меню, но при необходимости возвращается командой pm enable. Это предпочтительнее полного удаления.
Перезагрузка в особые режимы
ADB позволяет перезагружать устройство в служебные режимы без комбинаций кнопок, что особенно удобно, если аппаратные клавиши неисправны.
adb reboot recovery
adb reboot bootloader
Первая команда отправляет смартфон в recovery — режим восстановления, вторая — в bootloader (fastboot). Дальнейшие действия в этих режимах сильно зависят от модели: разблокировка загрузчика, прошивка разделов и сброс настроек выполняются по-разному у разных производителей, поэтому универсальной инструкции здесь нет — нужна документация конкретного устройства.
⚠️ Внимание: команды
fastboot flashing unlockи прошивка разделов стирают данные и могут нарушить условия гарантии. Выполняйте их только с чётким пониманием последствий и инструкцией для вашей модели.
Почему adb не видит устройство в режиме fastboot
В режиме bootloader обычный ADB не работает — там используется отдельный протокол fastboot и команда fastboot devices. Дополнительно на Windows в этом режиме может потребоваться отдельный драйвер, который система устанавливает не всегда автоматически.
Решение типичных ошибок ADB
Разберём ошибки, которые встречаются чаще всего, и порядок их диагностики.
- 🔍 device unauthorized — отзовите авторизации в настройках разработчика («Отменить авторизацию отладки USB»), переподключите кабель и подтвердите запрос заново
- 🔍 пустой вывод adb devices — замените кабель, попробуйте другой USB-порт, проверьте, установлен ли драйвер устройства в диспетчере устройств Windows
- 🔍 error: more than one device — подключено несколько устройств; укажите нужное через
adb -s серийный_номер команда - 🔍 adb server is out of date — выполните
adb kill-server, затемadb start-server
Если перечисленное не помогает, полезно проверить сам терминал: устаревшая версия Platform-Tools иногда конфликтует с новыми версиями Android. Обновление архива с официального сайта решает такие случаи.
FAQ: частые вопросы об ADB
Нужен ли root-доступ для работы ADB?
Нет. Большинство команд ADB работают на устройстве без root — отладка по USB является официальной функцией Android. Root требуется лишь для отдельных операций внутри shell, затрагивающих защищённые разделы системы.
Можно ли использовать ADB без кабеля, по Wi-Fi?
Да, на современных версиях Android в настройках разработчика есть «Беспроводная отладка» с сопряжением по коду. На старых версиях подключение по сети настраивалось через adb tcpip и adb connect, но первичная настройка требовала кабеля. Точная процедура зависит от версии Android на устройстве.
Удалённые через ADB приложения вернутся после сброса настроек?
Да. Команда adb uninstall для системных приложений удаляет их только для текущего пользователя — пакет остаётся в системном разделе и восстанавливается после сброса к заводским настройкам.
Чем ADB отличается от Fastboot?
ADB работает, когда Android загружен (или в recovery), и предназначен для управления системой и приложениями. Fastboot работает в режиме загрузчика и используется для прошивки разделов и разблокировки. Это разные протоколы, и команды одного не выполняются в режиме другого.
Безопасно ли отключать системные приложения через pm disable-user?
Отключение обратимо командой pm enable, поэтому риск минимален. Однако перед отключением пакета стоит выяснить его назначение: отключение критичных системных компонентов может нарушить работу отдельных функций устройства.