Команда adb shell не запускается чаще всего по одной из трёх причин: на смартфоне не включена отладка по USB, компьютер не видит устройство из-за драйвера или утилита ADB просто не установлена в системе. Прежде чем вводить саму команду, нужно убедиться, что связка «ПК — кабель — смартфон» настроена правильно, иначе терминал вернёт ошибку device not found или вообще «не является внутренней или внешней командой».
В этом руководстве разберём весь путь от установки Android Debug Bridge до открытия интерактивной оболочки на устройстве. Инструкция подходит для Windows, macOS и Linux, а команды одинаковы для любых смартфонов и планшетов на Android — различия касаются только расположения пунктов меню в оболочках разных производителей.
Что такое ADB Shell и зачем он нужен
ADB (Android Debug Bridge) — это официальная утилита от Google, входящая в состав Android SDK Platform Tools. Она создаёт мост между компьютером и Android-устройством, позволяя выполнять команды, устанавливать приложения, передавать файлы и диагностировать систему без root-доступа.
Команда adb shell открывает удалённую командную оболочку прямо на смартфоне. После её запуска вы работаете с файловой системой и процессами Android так, словно перед вами терминал самого устройства. Это нужно для просмотра логов (logcat), очистки кэша приложений, проверки системных свойств и многих других задач.
- 🔧 Диагностика системы и просмотр журналов событий в реальном времени.
- 📦 Удаление предустановленных приложений без root-прав.
- 🗂️ Доступ к файловой системе устройства через команды
ls,cd,cat. - ⚙️ Изменение скрытых настроек через
settings putиsetprop.
Шаг 1. Установка ADB на компьютер
Утилита распространяется бесплатно в составе пакета SDK Platform Tools, который Google публикует на официальном сайте для разработчиков Android. Скачайте архив для своей операционной системы и распакуйте его в удобную папку, например C:\platform-tools на Windows или ~/platform-tools на macOS и Linux.
Установщика у пакета нет — это портативный набор утилит. Чтобы запустить ADB, откройте терминал в папке с распакованными файлами. В Windows это делается так: откройте папку в Проводнике, введите cmd в адресной строке и нажмите Enter — командная строка откроется сразу в нужной директории.
Проверьте, что утилита работает, командой:
adb versionЕсли терминал вывел номер версии — всё готово. Если появилась ошибка «команда не найдена», вы либо находитесь не в той папке, либо путь к утилите не добавлен в PATH.
Шаг 2. Включение отладки по USB на смартфоне
Без активированной отладки по USB компьютер не получит доступ к оболочке устройства. Сначала нужно разблокировать скрытое меню «Для разработчиков»: откройте Настройки → О телефоне и несколько раз подряд нажмите на пункт «Номер сборки», пока не появится уведомление о том, что вы стали разработчиком.
Затем вернитесь в настройки и найдите раздел Для разработчиков (на некоторых оболочках он находится внутри «Система» или «Расширенные настройки»). Включите в нём переключатель «Отладка по USB». Точное расположение пунктов зависит от оболочки — MIUI, One UI, ColorOS и другие размещают их по-разному, поэтому при затруднениях сверьтесь с документацией своего устройства.
☑️ Подготовка к запуску adb shell
⚠️ Внимание: используйте кабель, поддерживающий передачу данных. Некоторые кабели от зарядных устройств содержат только линии питания — через них смартфон заряжается, но компьютер его не видит. Это одна из самых частых причин «невидимого» устройства.
Шаг 3. Подключение устройства и проверка связи
Подключите смартфон к компьютеру кабелем USB и разблокируйте экран устройства. Выполните в терминале команду:
adb devicesПри первом подключении на экране смартфона появится диалог «Разрешить отладку по USB?» с отпечатком ключа компьютера. Отметьте галочку «Всегда разрешать с этого компьютера» и нажмите «ОК». Если диалог не появился — отключите и снова подключите кабель, либо отзовите ранее выданные разрешения в разделе разработчика и повторите попытку.
Результат команды adb devices интерпретируется так:
| Вывод команды | Что означает | Действие |
|---|---|---|
| серийный номер + device | Устройство подключено и готово | Можно запускать adb shell |
| серийный номер + unauthorized | Отладка не подтверждена на смартфоне | Подтвердите запрос на экране устройства |
| серийный номер + offline | Сбой соединения | Переподключите кабель, выполните adb kill-server |
| пустой список | Устройство не обнаружено | Проверьте кабель, драйверы, отладку по USB |
Шаг 4. Запуск adb shell
Когда статус устройства — device, запустите оболочку одной командой:
adb shellПосле выполнения приглашение терминала сменится — вы увидите что-то вроде device_name:/ $. Это и есть интерактивная оболочка Android: все последующие команды выполняются уже на смартфоне, а не на компьютере. Выйти из оболочки можно командой exit.
Если нужно выполнить одну команду без входа в интерактивный режим, передайте её аргументом: adb shell pm list packages выведет список установленных пакетов и сразу вернёт вас в терминал ПК. Такой формат удобен для скриптов и быстрых проверок.
Когда к компьютеру подключено несколько устройств одновременно, укажите целевое явно:
adb -s серийный_номер shellТипичные ошибки и их решение
Ошибка adb is not recognized (Windows) или command not found (macOS/Linux) означает, что терминал не находит исполняемый файл. Перейдите в папку platform-tools и запускайте команду оттуда, а на macOS и Linux используйте форму ./adb shell — она явно указывает на исполняемый файл в текущем каталоге.
На Windows статус «пустой список» в adb devices нередко связан с драйвером. Возможная причина — система установила устройство как обычный MTP-накопитель без интерфейса ADB. Проверьте Диспетчер устройств: если смартфон отображается с предупреждением, установите драйвер от производителя устройства или универсальный драйвер Google из состава SDK.
⚠️ Внимание: команды внутри adb shell выполняются напрямую в системе Android. Не запускайте команды удаления или изменения системных файлов, если не понимаете их назначения, — ошибка может нарушить работу устройства вплоть до необходимости перепрошивки.
Как перезапустить ADB-сервер при сбоях
Если устройство «зависло» в статусе offline или перестало отвечать, выполните две команды подряд: adb kill-server, затем adb start-server. После этого снова проверьте список устройств командой adb devices. Это безопасная процедура — она перезапускает только фоновый процесс на компьютере и никак не затрагивает данные на смартфоне.
Запуск ADB Shell без кабеля (по Wi-Fi)
В современных версиях Android предусмотрена беспроводная отладка: в разделе «Для разработчиков» включите опцию Беспроводная отладка, если она предусмотрена вашей версией системы. Смартфон и компьютер должны находиться в одной сети Wi-Fi.
Сопряжение выполняется командой adb pair IP:порт с вводом кода, показанного на экране устройства, после чего подключение устанавливается через adb connect IP:порт. Точные пункты меню и поведение зависят от версии Android и оболочки производителя, поэтому при расхождениях ориентируйтесь на подсказки в самом разделе беспроводной отладки.
Полезные команды внутри adb shell
После входа в оболочку доступен широкий набор стандартных и специфичных для Android команд. Вот базовый набор для знакомства:
- 📋
pm list packages— список всех установленных пакетов приложений. - 📊
dumpsys battery— сведения о состоянии аккумулятора. - 📁
ls /sdcard— содержимое внутреннего хранилища. - 🔍
getprop ro.build.version.release— версия Android устройства.
Начинайте с команд чтения информации — они ничего не изменяют в системе и полностью безопасны. Команды, модифицирующие настройки или удаляющие пакеты, применяйте только после того, как убедитесь в их назначении по документации.
Часто задаваемые вопросы
Нужен ли root-доступ для запуска adb shell?
Нет. Оболочка запускается на любом устройстве с включённой отладкой по USB, root-права не требуются. Однако часть команд внутри оболочки (доступ к системным разделам, изменение защищённых файлов) будет недоступна без root — оболочка работает с правами системного пользователя shell.
Почему adb devices показывает пустой список?
Проверьте по порядку: включена ли отладка по USB, поддерживает ли кабель передачу данных, установлен ли драйвер устройства на Windows, не заблокирован ли экран смартфона. Также попробуйте другой USB-порт и перезапуск ADB-сервера командами adb kill-server и adb start-server.
Как выйти из adb shell?
Введите команду exit и нажмите Enter — вы вернётесь в обычный терминал компьютера. Само ADB-подключение при этом не разрывается, и повторный вход в оболочку выполняется мгновенно.
Можно ли запустить adb shell без компьютера, прямо на смартфоне?
Да, существуют приложения-терминалы и способы локального запуска ADB на самом устройстве, но их настройка существенно зависит от версии Android и оболочки. Классический и наиболее предсказуемый сценарий — подключение к ПК, описанное в этой статье.
Безопасно ли оставлять отладку по USB включённой постоянно?
Включённая отладка сама по себе не даёт доступа к данным без вашего подтверждения на экране устройства. Тем не менее разумная практика — отключать её, когда она не используется, особенно если вы часто подключаете смартфон к чужим компьютерам и зарядным станциям.