Команда adb devices возвращает пустой список, хотя смартфон подключён кабелем — с этой ситуации начинается знакомство большинства пользователей с Android Debug Bridge, и почти всегда причина в отключённой отладке по USB или отсутствии подтверждения на экране телефона. ADB — это официальная утилита из состава Android SDK Platform-Tools, которая позволяет управлять устройством с компьютера: устанавливать приложения, передавать файлы, снимать скриншоты, перезагружать в recovery и многое другое без рут-прав.
В этом материале собраны основные команды ADB с пояснениями: как подготовить смартфон и компьютер, как проверить соединение, какие команды использовать для работы с приложениями, файлами и системой, а также что делать, если устройство не определяется. Команды приведены в том виде, в каком их вводят в терминале Windows, macOS или Linux.
Подготовка: включение отладки по USB и установка ADB
Прежде чем выполнять любые команды, на смартфоне нужно активировать отладку по USB. Для этого откройте «Настройки» → «О телефоне» и несколько раз нажмите на пункт «Номер сборки», пока не появится сообщение о разблокировке режима разработчика. Затем в разделе «Для разработчиков» включите переключатель «Отладка по USB». Точные названия пунктов могут отличаться в зависимости от оболочки — уточните их в документации к своей модели.
На компьютере необходимо скачать архив SDK Platform-Tools с официального сайта для разработчиков Android и распаковать его в удобную папку. Отдельная установка не требуется — достаточно открыть терминал или командную строку в каталоге с файлами adb. В Windows для этого можно зажать Shift, кликнуть правой кнопкой по папке и выбрать «Открыть окно PowerShell здесь».
☑️ Подготовка к работе с ADB
При первом подключении на экране смартфона появится запрос «Разрешить отладку по USB?» с отпечатком ключа компьютера. Подтвердите его, при желании отметив «Всегда разрешать с этого компьютера» — тогда запрос не будет появляться повторно.
Проверка подключения и базовые команды
Начните с диагностики — она покажет, видит ли компьютер устройство:
adb devicesВ ответ вы должны увидеть серийный номер устройства и статус device. Если статус unauthorized — на телефоне не подтверждён запрос на отладку. Если список пуст — проверьте кабель, драйверы (в Windows может потребоваться установка USB-драйвера производителя) и сам факт включённой отладки.
- 🔌
adb devices— список подключённых устройств и их статус - 🔄
adb reboot— обычная перезагрузка смартфона - 🛠️
adb reboot recovery— перезагрузка в режим восстановления - ⚡
adb reboot bootloader— перезагрузка в режим загрузчика (fastboot) - 🛑
adb kill-server— остановка сервера ADB (помогает при «зависших» подключениях)
⚠️ Внимание: команда adb reboot bootloader переводит устройство в режим, предназначенный для низкоуровневых операций. Не выполняйте в нём действий, которых не понимаете, — ошибочные команды fastboot способны повредить разделы системы.
Управление приложениями через ADB
Одна из самых востребованных задач — установка APK-файлов без переноса их на телефон. Команда выглядит так:
adb install путь/к/файлу.apkЕсли приложение уже установлено и нужно обновить его с сохранением данных, добавьте флаг -r: adb install -r app.apk. Для удаления приложения используется команда adb uninstall com.example.app, где вместо примера указывается реальное имя пакета — его можно узнать командой adb shell pm list packages, которая выведет список всех установленных пакетов.
Отдельного внимания заслуживает отключение предустановленных системных приложений без рута. Команда adb shell pm disable-user --user 0 имя.пакета отключает приложение для текущего пользователя, не удаляя его физически. Вернуть всё обратно можно через adb shell pm enable имя.пакета. Это обратимая операция, однако отключать стоит только те компоненты, назначение которых вам известно.
Передача файлов между компьютером и смартфоном
Команды adb push и adb pull заменяют файловый менеджер и работают даже тогда, когда MTP-подключение глючит или недоступно:
adb push file.zip /sdcard/Download/
adb pull /sdcard/DCIM/Camera/ ./photos/
Первая команда копирует файл с компьютера в папку «Загрузки» на смартфоне, вторая — забирает каталог с фотографиями на компьютер. Обратите внимание: пути на устройстве указываются в стиле Linux, через прямой слэш, а внутренняя память обычно доступна по пути /sdcard/.
| Команда | Назначение | Пример |
|---|---|---|
adb push | Копирование файла на устройство | adb push music.mp3 /sdcard/Music/ |
adb pull | Копирование файла на компьютер | adb pull /sdcard/log.txt |
adb shell ls | Просмотр содержимого каталога | adb shell ls /sdcard/Download |
adb shell rm | Удаление файла на устройстве | adb shell rm /sdcard/old.apk |
adb shell df -h | Проверка свободного места | adb shell df -h /sdcard |
При передаче больших файлов не отключайте кабель до завершения команды — обрыв соединения оставит недозаписанный файл на устройстве. Прогресс в терминале не всегда отображается, поэтому дождитесь возврата приглашения командной строки.
Скриншоты, запись экрана и логи
Сделать скриншот и сразу забрать его на компьютер можно двумя командами:
adb shell screencap /sdcard/screen.png
adb pull /sdcard/screen.png
Для записи видео с экрана служит команда adb shell screenrecord /sdcard/video.mp4 — запись останавливается комбинацией Ctrl+C в терминале. Утилита имеет ограничения по длительности и не записывает внутренний звук системы, что стоит учитывать при подготовке инструкций или баг-репортов.
Команда adb logcat выводит системный журнал в реальном времени — незаменимый инструмент при поиске причин вылетов приложений. Поток сообщений очень плотный, поэтому его обычно фильтруют по тегу или уровню важности, например adb logcat *:E покажет только ошибки.
Как сохранить лог в файл
Выполните adb logcat -d > log.txt — параметр -d выгружает текущий буфер журнала и завершает команду, а весь вывод сохранится в файл log.txt в текущей папке. Это удобно для отправки отчёта разработчику приложения.
Работа через Wi-Fi и типичные ошибки
ADB умеет работать без кабеля. На устройствах с Android 11 и новее в настройках разработчика есть пункт «Беспроводная отладка» с сопряжением по коду. На более старых версиях сначала подключите телефон по USB и выполните adb tcpip 5555, затем узнайте IP-адрес устройства в настройках Wi-Fi и подключитесь:
adb connect 192.168.1.50:5555После этого кабель можно отключить — команды будут выполняться по сети. Оба устройства должны находиться в одной Wi-Fi сети. Для возврата в USB-режим используется adb usb.
- ❌ device not found — устройство не подключено или отладка не подтверждена; проверьте
adb devices - 🔑 unauthorized — отзовите разрешения в настройках разработчика и подтвердите запрос заново
- 🔀 more than one device — подключено несколько устройств; укажите нужное через
adb -s серийный_номер команда - 🚫 permission denied — операция требует прав, которых нет у ADB на данном устройстве
⚠️ Внимание: беспроводная отладка открывает порт на устройстве. Не используйте её в общественных Wi-Fi сетях и отключайте функцию после завершения работы — иначе теоретически возможен несанкционированный доступ из локальной сети.
Ограничения ADB и меры предосторожности
ADB не даёт полного контроля над системой: без разблокированного загрузчика и рут-прав недоступны изменение системных разделов, удаление части защищённых приложений и низкоуровневая прошивка. Это сделано намеренно — так Android защищает пользовательские данные. Если инструкция из интернета требует команд, которые у вас не выполняются с ошибкой доступа, вероятно, она рассчитана на устройство с особыми правами.
Несколько правил безопасной работы: не выполняйте команды, смысла которых не понимаете, особенно содержащие rm, wipe или работу с разделами; делайте резервные копии важных данных перед экспериментами; используйте Platform-Tools только из официального источника. Команды вроде adb shell pm uninstall на системных пакетах способны нарушить работу устройства, даже если выполняются без ошибок.
⚠️ Внимание: команда adb shell pm uninstall --user 0 с неизвестным системным пакетом может привести к сбоям интерфейса или потере функций телефона. Перед отключением любого компонента выясните его назначение и убедитесь, что знаете, как вернуть его обратно.
Часто задаваемые вопросы
Нужны ли рут-права для работы с ADB?
Нет. Базовые команды — установка приложений, передача файлов, скриншоты, логи, перезагрузка — работают на любых устройствах с включённой отладкой по USB. Рут расширяет возможности команд adb shell, но для большинства задач не требуется.
Что делать, если adb devices показывает пустой список?
Проверьте по порядку: включена ли отладка по USB, исправен ли кабель (попробуйте другой, поддерживающий передачу данных), подтверждён ли запрос на экране телефона, установлены ли драйверы в Windows. Затем выполните adb kill-server и снова adb devices.
Можно ли удалить предустановленные приложения через ADB?
Частично. Команда adb shell pm uninstall --user 0 имя.пакета удаляет приложение для текущего пользователя без рута, но файл остаётся в системном разделе и вернётся после сброса настроек. Отключение через pm disable-user — более безопасная обратимая альтернатива.
Работает ли ADB на macOS и Linux?
Да, Platform-Tools выпускаются для Windows, macOS и Linux. Синтаксис команд идентичен; в macOS и Linux исполняемый файл иногда запускают как ./adb из папки с утилитой. Драйверы, как в Windows, обычно не нужны.
Опасно ли оставлять отладку по USB включённой постоянно?
При подключении к чужому компьютеру потребуется подтверждение на экране, поэтому риск умеренный. Тем не менее разумнее отключать отладку, когда она не нужна, и никогда не подтверждать запросы на незнакомых устройствах и зарядных станциях.