Команда adb devices выдаёт пустой список или ошибку «adb не является внутренней или внешней командой» — именно с этой ситуации начинается знакомство большинства пользователей с Android Debug Bridge. Причина почти всегда одна: утилита либо не установлена, либо не прописана в системную переменную PATH, либо на смартфоне не включена отладка по USB. Всё это решается за несколько минут, если действовать в правильном порядке.
ADB — это консольный инструмент из состава Android SDK Platform Tools, который позволяет компьютеру обмениваться командами со смартфоном: устанавливать приложения, снимать логи, перезагружать устройство в разные режимы, удалять системные пакеты и многое другое. Ниже разберём установку на Windows, macOS и Linux, а также типовые ошибки подключения.
Что нужно перед установкой ADB
Прежде чем скачивать файлы, убедитесь, что выполнены базовые условия. Без них установка пройдёт, но подключение к устройству работать не будет.
- 💻 Компьютер с Windows, macOS или Linux и правами администратора для настройки системных переменных.
- 🔌 Исправный USB-кабель, поддерживающий передачу данных — кабели «только для зарядки» не подойдут.
- 📱 Смартфон с включённой отладкой по USB в меню разработчика.
- 🌐 Доступ в интернет для загрузки архива Platform Tools с официального сайта Google.
Отдельно отметим: устанавливать полный Android Studio ради одного ADB не нужно. Google распространяет Platform Tools отдельным компактным архивом, в котором уже есть adb и fastboot.
Загрузка Android SDK Platform Tools
Официальный и единственный рекомендуемый источник — страница разработчиков Google, где выложены архивы SDK Platform Tools для трёх операционных систем. Скачивание с сторонних сайтов чревато устаревшими версиями и модифицированными файлами.
Архив не требует классической установки. Достаточно распаковать его в удобную папку — например, C:\platform-tools на Windows или ~/platform-tools на macOS и Linux. Внутри находятся исполняемые файлы adb (на Windows — adb.exe), fastboot и вспомогательные библиотеки.
⚠️ Внимание: не распаковывайте архив в папки с кириллическими символами и пробелами в пути — например, в «Рабочий стол» с русским именем пользователя. Некоторые команды и сторонние скрипты могут некорректно обрабатывать такие пути.
Установка и настройка ADB на Windows
На Windows ADB можно запускать двумя способами: открыв командную строку прямо в папке с утилитой либо добавив путь в переменную PATH, чтобы команда работала из любого каталога. Второй вариант удобнее для постоянного использования.
Чтобы добавить ADB в PATH, откройте Параметры → Система → О системе → Дополнительные параметры системы → Переменные среды. В списке системных переменных найдите Path, нажмите «Изменить» и добавьте новую строку с путём к папке, например C:\platform-tools. После сохранения перезапустите командную строку.
Проверка выполняется одной командой:
adb versionЕсли в ответ выводится номер версии Android Debug Bridge, установка прошла успешно. Если появляется сообщение, что команда не найдена, проверьте правильность пути в переменных среды и то, что терминал был перезапущен после изменений.
☑️ Проверка установки ADB на Windows
Установка ADB на macOS и Linux
На macOS проще всего воспользоваться пакетным менеджером Homebrew, если он уже установлен:
brew install android-platform-toolsАльтернатива — вручную распаковать архив Platform Tools и добавить путь в файл ~/.zshrc строкой вида export PATH="$HOME/platform-tools:$PATH", после чего выполнить source ~/.zshrc. Оба способа дают одинаковый результат, отличие лишь в удобстве обновлений.
На Linux во многих дистрибутивах ADB доступен из штатных репозиториев. Например, в Ubuntu и Debian используется команда:
sudo apt install adbУчтите, что версия из репозитория может отставать от актуальной сборки Google. Для свежих функций надёжнее использовать официальный архив Platform Tools, распакованный в домашний каталог, с добавлением пути в ~/.bashrc или ~/.zshrc.
Включение отладки по USB на смартфоне
Без активированной отладки по USB компьютер не увидит устройство, даже если ADB установлен идеально. Сначала необходимо разблокировать скрытое меню разработчика: откройте Настройки → О телефоне и несколько раз подряд нажмите на пункт Номер сборки, пока не появится подтверждение. На некоторых прошивках потребуется ввести код блокировки экрана.
После этого в настройках появится раздел Для разработчиков (точное расположение зависит от оболочки — иногда он находится внутри «Расширенных настроек» или «Системы»). В этом разделе включите переключатель Отладка по USB. Пути в меню отличаются у разных производителей, поэтому при затруднениях сверьтесь с документацией своей модели.
Теперь подключите смартфон к компьютеру кабелем и выполните:
adb devicesНа экране смартфона появится запрос на разрешение отладки с этого компьютера — подтвердите его, при желании отметив «Всегда разрешать». После этого устройство должно отображаться в списке со статусом device.
⚠️ Внимание: запрос на разрешение отладки появляется только при разблокированном экране смартфона. Если окно не показывается, отключите и заново подключите кабель, затем повторите команду
adb devices.
Драйверы и типичные проблемы подключения
Если устройство не определяется или отображается со статусом unauthorized либо offline, причина обычно находится в одном из нескольких мест. Ниже — сравнение частых симптомов и способов их устранения.
| Симптом | Вероятная причина | Что проверить |
|---|---|---|
| Пустой список в adb devices | Кабель без передачи данных или нет драйвера | Другой кабель и порт, диспетчер устройств Windows |
| Статус unauthorized | Не подтверждён запрос на смартфоне | Разблокировать экран, отозвать разрешения и подключить заново |
| Команда adb не найдена | Путь не добавлен в PATH | Переменные среды и перезапуск терминала |
| Устройство пропадает периодически | Энергосбережение USB или нестабильный порт | Порт напрямую без хаба, настройки питания USB |
На Windows отдельная тема — драйверы. Современные версии системы часто подхватывают устройство автоматически, но если в Диспетчере устройств смартфон отображается с восклицательным знаком, установите драйвер от производителя смартфона или универсальный Google USB Driver. Точный набор драйверов зависит от бренда устройства.
Что делать, если ничего не помогает
Выполните adb kill-server, затем adb start-server и повторите adb devices. На смартфоне отключите и снова включите отладку по USB, а также используйте пункт «Отозвать разрешения на отладку» в меню разработчика. Попробуйте другой USB-порт и кабель. На Linux проверьте права доступа — иногда требуется настройка правил udev или запуск adb с sudo.
На Linux встречается ситуация, когда устройство видно только с правами root. Это признак того, что не настроены правила udev для вашего устройства. Решение зависит от дистрибутива, поэтому корректнее обратиться к документации используемой системы.
Проверка работы и базовые команды
После успешного подключения полезно освоить минимальный набор команд, ради которых ADB обычно и устанавливают. Все они выполняются из командной строки на компьютере при подключённом смартфоне.
- 📦
adb install app.apk— установка APK-файла на устройство. - 🔄
adb reboot— перезагрузка смартфона; вариантыadb reboot recoveryиadb reboot bootloaderпереводят в соответствующие режимы. - 📋
adb logcat— просмотр системного журнала в реальном времени. - 🗑️
adb uninstall имя.пакета— удаление приложения по имени пакета. - 📂
adb pushиadb pull— передача файлов между компьютером и смартфоном.
Работа с ADB не требует рут-прав на самом смартфоне — отладка по USB доступна на стоковых прошивках, и это одно из главных преимуществ инструмента. Однако команды, изменяющие системные разделы, всё равно могут быть ограничены производителем.
⚠️ Внимание: команды удаления системных пакетов и перезагрузки в режим bootloader выполняйте осознанно. Удаление важных компонентов прошивки способно нарушить работу устройства, а действия в режиме fastboot при неправильном применении — привести к потере данных.
Часто задаваемые вопросы
Можно ли установить ADB без Android Studio?
Да. Пакет SDK Platform Tools распространяется Google отдельным архивом и содержит всё необходимое: adb, fastboot и вспомогательные библиотеки. Полная среда разработки не требуется.
Почему команда adb не распознаётся в командной строке?
Наиболее вероятная причина — путь к папке Platform Tools не добавлен в переменную PATH либо терминал не был перезапущен после изменения переменных среды. Проверьте путь и откройте новое окно командной строки.
Что означает статус unauthorized в adb devices?
Это значит, что на смартфоне не подтверждён запрос на разрешение отладки. Разблокируйте экран, отключите и заново подключите кабель, затем подтвердите запрос. Если окно не появляется, отзовите прежние разрешения в меню разработчика и повторите подключение.
Нужен ли root для работы с ADB?
Нет. Базовые функции — установка приложений, просмотр логов, передача файлов, перезагрузка — работают на стоковой прошивке без рут-прав. Достаточно включённой отладки по USB.
Можно ли использовать ADB без кабеля, по Wi-Fi?
Да, на современных версиях Android предусмотрена беспроводная отладка — она включается в меню разработчика. Порядок сопряжения зависит от версии системы, поэтому ориентируйтесь на подсказки в самом меню устройства и официальную документацию.