Команда adb devices возвращает пустой список или ошибку «adb не является внутренней или внешней командой» — именно с этой проверки стоит начать, если вы пытаетесь запустить ADB через командную строку. Первая ошибка означает, что система не находит исполняемый файл adb.exe, вторая указывает на проблему с подключением смартфона или драйверами. Обе ситуации решаются за несколько минут, если действовать в правильном порядке.
ADB (Android Debug Bridge) — это консольная утилита из состава Android SDK Platform Tools, которая позволяет управлять Android-устройством с компьютера: устанавливать приложения, передавать файлы, снимать логи и выполнять отладку. Ниже разберём, где взять инструмент, как его правильно запустить из командной строки и что делать, если устройство не определяется.
Что нужно перед запуском ADB
Прежде чем открывать командную строку, убедитесь, что выполнены базовые условия. Без них утилита либо не запустится, либо не увидит смартфон.
- 📦 Скачанный архив SDK Platform Tools с официального сайта для разработчиков Android — это единственный безопасный источник утилиты.
- 🔌 Включённая отладка по USB на смартфоне: сначала активируется режим разработчика (несколько нажатий на пункт «Номер сборки» в разделе «О телефоне»), затем в меню «Для разработчиков» включается соответствующий переключатель.
- 🖥️ Рабочий USB-кабель и порт — часть проблем с подключением связана именно с кабелями, которые поддерживают только зарядку, но не передачу данных.
- 💾 Установленные USB-драйверы производителя смартфона, если Windows не определяет устройство автоматически.
Точные названия пунктов меню могут отличаться в зависимости от оболочки (MIUI, One UI, ColorOS и других), поэтому при расхождениях сверяйтесь с документацией своей модели.
Установка Platform Tools на компьютер
Распакуйте скачанный архив в папку с простым путём без кириллицы и пробелов — например, C:\platform-tools. Это важно: кириллические символы в пути иногда вызывают ошибки при работе консольных утилит.
Внутри папки должны находиться файлы adb.exe, fastboot.exe и несколько библиотек .dll. Установка как таковая не требуется — утилита портативная и запускается напрямую. Проверить её работоспособность можно сразу: откройте командную строку и выполните команду с полным путём.
C:\platform-tools\adb.exe versionЕсли в ответ выводится версия Android Debug Bridge, значит файл рабочий, и можно переходить к удобному запуску без указания полного пути.
Запуск ADB из командной строки: три способа
Способ первый — через адресную строку проводника. Откройте папку platform-tools в проводнике, введите в адресной строке cmd и нажмите Enter. Командная строка откроется сразу в нужной директории, и команды adb будут работать без полного пути.
Способ второй — команда cd. Откройте командную строку любым привычным способом (Win + R → cmd) и перейдите в папку с утилитой:
cd /d C:\platform-toolsСпособ третий — добавление в переменную PATH. Это самый удобный вариант для постоянной работы: команда adb станет доступна из любой директории. Откройте «Система» → «Дополнительные параметры системы» → «Переменные среды», найдите переменную Path и добавьте в неё путь C:\platform-tools. После сохранения перезапустите командную строку — изменения применяются только к новым окнам консоли.
☑️ Проверка готовности к запуску ADB
Проверка подключения устройства
Подключите смартфон к компьютеру и выполните главную диагностическую команду:
adb devicesПри первом подключении на экране смартфона появится запрос «Разрешить отладку по USB?» — подтвердите его, при желании отметив пункт «Всегда разрешать с этого компьютера». Без этого подтверждения устройство будет отображаться со статусом unauthorized и не примет ни одну команду.
Корректный результат выглядит как серийный номер устройства со статусом device. Если вместо этого вы видите offline, помогает перезапуск сервера:
adb kill-server
adb start-server
⚠️ Внимание: запрос на разрешение отладки появляется только при разблокированном экране смартфона. Если устройство заблокировано или экран погас, диалог может не отобразиться, и команда зависнет в статусе unauthorized.
Основные команды ADB для начала работы
После успешного подключения становятся доступны базовые операции. Вот те, с которых обычно начинают:
| Команда | Назначение |
|---|---|
adb devices | Список подключённых устройств и их статус |
adb install app.apk | Установка APK-файла на устройство |
adb push файл /sdcard/ | Копирование файла с ПК на смартфон |
adb pull /sdcard/файл | Копирование файла со смартфона на ПК |
adb reboot | Перезагрузка устройства |
Для просмотра системных журналов в реальном времени используется команда adb logcat — она незаменима при диагностике сбоев приложений. Полный справочник по любой команде выводится через adb help.
Решение типичных ошибок
«adb не является внутренней или внешней командой» — система не находит исполняемый файл. Либо командная строка открыта не в той папке, либо путь не добавлен в PATH, либо в переменной опечатка. Проверьте путь и откройте новое окно консоли.
Пустой список в adb devices. Последовательно проверьте: включена ли отладка по USB, работает ли кабель (попробуйте другой), определяется ли смартфон в диспетчере устройств Windows. Если устройство видно с жёлтым значком — проблема в драйверах, их нужно установить с сайта производителя.
⚠️ Внимание: не скачивайте adb.exe со сторонних сайтов «в одном файле». Такие сборки нередко устарели или содержат посторонний код. Модифицированная утилита с правами отладки — серьёзный риск для данных на устройстве.
Если смартфон определяется только в режиме «зарядка», переключите USB-режим в шторке уведомлений на «Передача файлов (MTP)» — на части устройств отладка не работает в режиме «только зарядка». Также проверьте, не блокирует ли подключение антивирус или корпоративная политика безопасности.
ADB через Wi-Fi — возможно ли?
На устройствах с Android 11 и новее предусмотрена беспроводная отладка: она включается в меню «Для разработчиков» и работает через сопряжение по коду. На более старых версиях Android беспроводное подключение требовало первичной настройки по кабелю командой adb tcpip. Точный порядок зависит от версии системы, поэтому сверяйтесь с документацией своей прошивки.
Часто задаваемые вопросы
Можно ли запустить ADB без установки Android Studio?
Да. Пакет SDK Platform Tools распространяется отдельно и содержит всё необходимое: adb и fastboot. Полная среда Android Studio для работы с ADB не требуется.
Почему команда adb работает в одной папке, но не работает в другой?
Командная строка ищет исполняемый файл в текущей директории и в путях, перечисленных в переменной PATH. Если папка platform-tools не добавлена в PATH, команда сработает только из этой папки. Добавьте путь в переменные среды и откройте новое окно консоли.
Что означает статус unauthorized в adb devices?
Устройство подключено, но отладка с этого компьютера не разрешена. Разблокируйте смартфон и подтвердите запрос «Разрешить отладку по USB?». Если диалог не появляется, отключите и включите отладку заново и перезапустите сервер командами adb kill-server и adb start-server.
Опасно ли держать отладку по USB включённой постоянно?
При повседневном использовании риск невелик, но включённая отладка расширяет возможности доступа к устройству при физическом подключении. Если ADB нужен лишь эпизодически, разумно отключать отладку после завершения работы и не подтверждать запросы на незнакомых компьютерах.
Работает ли ADB в PowerShell и Windows Terminal?
Да, утилита одинаково работает в классической командной строке, PowerShell и Windows Terminal. В PowerShell при запуске из текущей папки может потребоваться синтаксис .\adb devices.