Команда adb devices возвращает пустой список или статус unauthorized — самая частая причина, по которой пользователи попадают на страницу developer.android.com с документацией по ADB. В большинстве случаев проблема решается за пару минут: либо не включена отладка по USB на смартфоне, либо на компьютере отсутствует нужный драйвер, либо на экране устройства не подтверждён запрос на разрешение отладки.
Android Debug Bridge (ADB) — это официальная консольная утилита от Google, входящая в состав пакета SDK Platform Tools. Она позволяет компьютеру взаимодействовать с Android-устройством: устанавливать приложения, передавать файлы, выполнять команды оболочки, снимать логи и перезагружать устройство в различные режимы. Ниже разберём, как правильно установить инструмент, подключить смартфон и использовать базовые команды без риска для данных.
Что такое ADB и зачем он нужен
ADB работает по клиент-серверной модели. На компьютере запускается ADB-сервер, который принимает команды от клиента (окна терминала) и передаёт их на устройство через демон adbd, работающий на смартфоне. Связь возможна по USB-кабелю или по сети Wi-Fi — во втором случае потребуется беспроводная отладка, доступная в свежих версиях Android.
Возможности инструмента шире, чем кажется на первый взгляд:
- 📦 Установка и удаление APK-файлов без магазина приложений
- 📁 Передача файлов между компьютером и смартфоном командами
pushиpull - 🐛 Снятие системных журналов через
logcatдля диагностики ошибок - 🔄 Перезагрузка в режимы recovery и bootloader
- 🛠️ Выполнение команд оболочки напрямую на устройстве
Инструментом пользуются не только разработчики. Обычные пользователи применяют ADB для отключения предустановленных приложений, снятия скриншотов с записью экрана и тонкой настройки системы без root-доступа.
Установка SDK Platform Tools
Официальный и единственный рекомендуемый источник загрузки — страница SDK Platform Tools на сайте developer.android.com. Сторонние «установщики ADB» часто содержат устаревшие версии, которые несовместимы с новыми устройствами и могут вызывать конфликты.
Порядок установки на Windows выглядит так:
- ⬇️ Скачайте архив Platform Tools для своей ОС с официальной страницы
- 📂 Распакуйте его в простую папку, например
C:\platform-tools - 💻 Откройте командную строку в этой папке или добавьте путь в переменную
PATH - ✅ Проверьте установку командой
adb version
☑️ Подготовка ADB к работе
На macOS и Linux установка аналогична, но команды вводятся в терминале. На Linux дополнительно может потребоваться настройка правил udev, чтобы система видела устройство без прав суперпользователя.
Включение отладки по USB на смартфоне
Без активации режима разработчика устройство просто не ответит на команды компьютера. Сначала нужно открыть скрытое меню: перейдите в настройки, найдите раздел «О телефоне» и несколько раз подряд нажмите на пункт Номер сборки до появления уведомления о том, что вы стали разработчиком. Точное название пункта зависит от оболочки производителя — у некоторых брендов это «Версия MIUI», «Версия прошивки» и т.п.
После этого в настройках появится раздел «Для разработчиков» (обычно внутри «Системы» или «Расширенных настроек»). В нём активируйте переключатель Отладка по USB. При первом подключении к компьютеру на экране смартфона появится запрос «Разрешить отладку по USB?» — подтвердите его, при желании отметив «Всегда разрешать с этого компьютера».
⚠️ Внимание: включённая отладка по USB даёт подключённому компьютеру широкий доступ к устройству. Не подтверждайте запрос на отладку на чужих компьютерах и в общественных местах, а после завершения работы режим можно отключить.
Базовые команды ADB
Начинать работу стоит с проверки соединения. Команда ниже выводит список подключённых устройств:
adb devicesЕсли устройство определилось корректно, рядом с его серийным номером будет статус device. Статус unauthorized означает, что на смартфоне не подтверждён запрос на отладку. Далее — самые востребованные команды:
| Команда | Назначение |
|---|---|
adb install app.apk | Установка приложения из APK-файла |
adb uninstall com.example.app | Удаление приложения по имени пакета |
adb push file.txt /sdcard/ | Копирование файла на устройство |
adb pull /sdcard/file.txt | Копирование файла с устройства на ПК |
adb reboot recovery | Перезагрузка в режим восстановления |
Для выполнения команд непосредственно в системе Android используется adb shell — она открывает интерактивную оболочку устройства. Например, adb shell pm list packages покажет список всех установленных пакетов, что удобно перед удалением лишних приложений.
Решение типичных проблем с подключением
Что делать, если adb devices показывает пустой список? Проверку стоит вести от простого к сложному. Сначала замените USB-кабель — многие дешёвые кабели передают только питание, но не данные. Затем попробуйте другой USB-порт компьютера, желательно напрямую, без хабов.
На Windows частая причина — отсутствие драйвера. В Диспетчере устройств смартфон может отображаться с восклицательным знаком; в этом случае установите драйвер с сайта производителя устройства или универсальный Google USB Driver из SDK Manager. На macOS и современных Linux-дистрибутивах отдельный драйвер обычно не требуется.
⚠️ Внимание: если устройство определяется как offline или unauthorized, отзовите авторизации в разделе «Для разработчиков» (пункт вроде «Отменить авторизацию отладки по USB»), перезапустите сервер командой adb kill-server и подключите устройство заново, подтвердив запрос на экране.
Как перезапустить ADB-сервер
Выполните последовательно две команды: adb kill-server, затем adb start-server. Это помогает при зависших соединениях и «застрявших» устройствах в списке. После перезапуска снова выполните adb devices и подтвердите запрос на экране смартфона.
Ещё одна возможная причина — режим подключения по USB. На некоторых устройствах нужно в шторке уведомлений переключить режим с «Только зарядка» на «Передача файлов (MTP)», чтобы отладка заработала. Наличие и название этой настройки зависят от модели.
Беспроводная отладка по Wi-Fi
В Android 11 и новее появилась беспроводная отладка, позволяющая обойтись без кабеля. Она включается в разделе «Для разработчиков» отдельным переключателем. Смартфон и компьютер должны находиться в одной сети Wi-Fi.
Подключение выполняется через сопряжение по коду:
adb pair IP_адрес:портКод сопряжения и адрес отображаются на экране смартфона в настройках беспроводной отладки. После успешного сопряжения устройство подключается командой adb connect. Учтите, что порт при каждом включении может меняться — сверяйте актуальные данные на экране устройства.
Часто задаваемые вопросы
Нужен ли root-доступ для работы ADB?
Нет. Большинство команд ADB работают на устройствах без root. Права суперпользователя требуются лишь для отдельных операций внутри shell, затрагивающих защищённые разделы системы.
Где скачать ADB отдельно от Android Studio?
Пакет SDK Platform Tools распространяется отдельно и доступен на официальной странице developer.android.com. Устанавливать полную Android Studio для работы с ADB не требуется.
Почему команда adb не распознаётся в командной строке?
Командная строка открыта не в папке с Platform Tools, либо путь к ней не добавлен в переменную PATH. Либо перейдите в папку с adb перед вводом команд, либо пропишите путь в системных переменных окружения.
Опасно ли включать отладку по USB?
Сам режим не вредит устройству, но даёт расширенный доступ подключённому компьютеру. Подтверждайте запросы только на доверенных ПК и отключайте режим, когда он не нужен.
Можно ли удалять системные приложения через ADB?
Удаление предустановленных приложений для текущего пользователя возможно командой с флагом --user 0, однако удаление критических системных компонентов способно нарушить работу устройства. Перед удалением проверяйте назначение пакета и делайте резервную копию важных данных.