Команда adb devices возвращает пустой список или ошибку «adb is not recognized» — это первый сигнал того, что ADB либо не установлен, либо система не видит путь к исполняемым файлам. В обоих случаях проблема решается за несколько минут: нужно скачать официальный пакет Platform Tools от Google, распаковать его и настроить переменную окружения PATH.
ADB (Android Debug Bridge) — универсальная консольная утилита для взаимодействия компьютера с Android-устройством: установка приложений, доступ к shell, передача файлов, снятие логов и прошивка отдельных разделов. В этой инструкции разберём установку для трёх операционных систем, настройку драйверов и проверку подключения, а также типичные ошибки, с которыми сталкиваются пользователи после установки.
Что понадобится перед установкой
Перед началом подготовьте три вещи: компьютер с доступом в интернет, исправный USB-кабель (желательно оригинальный или качественный, с поддержкой передачи данных, а не только зарядки) и само Android-устройство. Дешёвые кабели «только для зарядки» — частая причина того, что ADB не видит смартфон даже при корректной установке.
Скачивать ADB следует только с официального сайта Android Developers — пакет называется SDK Platform Tools и распространяется бесплатно в виде ZIP-архива. Сторонние «установщики ADB в один клик» часто содержат устаревшие версии утилит или лишние компоненты, поэтому их лучше избегать.
- 💾 Архив SDK Platform Tools с официального сайта разработчиков Android
- 🔌 USB-кабель с поддержкой передачи данных
- 📱 Android-устройство с включённой отладкой по USB
- 🖥️ Права администратора на компьютере для настройки PATH
Установка ADB на Windows
На Windows установка сводится к распаковке архива — инсталлятора у Platform Tools нет. Скачайте ZIP-файл для Windows, распакуйте его, например, в C:\platform-tools и запомните этот путь. Внутри папки находятся исполняемые файлы adb.exe, fastboot.exe и вспомогательные библиотеки.
Чтобы запускать ADB из любой папки, а не только из каталога утилиты, добавьте путь в системную переменную PATH. Откройте «Параметры» → «Система» → «О системе» → «Дополнительные параметры системы» → «Переменные среды». В разделе системных переменных найдите Path, нажмите «Изменить» и добавьте новую строку с путём к папке.
Проверка выполняется через командную строку. Откройте новое окно cmd (старые окна не подхватывают обновлённый PATH) и выполните:
adb versionЕсли в ответ выводится номер версии Android Debug Bridge — установка завершена. Если появляется сообщение «не является внутренней или внешней командой», перепроверьте путь в PATH и перезапустите терминал.
☑️ Установка ADB на Windows — чек-лист
Установка ADB на macOS и Linux
На macOS проще всего воспользоваться пакетным менеджером Homebrew, если он уже установлен. В этом случае Platform Tools ставятся одной командой и автоматически прописываются в PATH:
brew install android-platform-toolsАльтернатива — ручная распаковка архива, как на Windows: скачайте ZIP для macOS, распакуйте в домашнюю папку и добавьте путь в файл ~/.zshrc строкой export PATH="$HOME/platform-tools:$PATH", после чего перезапустите терминал или выполните source ~/.zshrc.
В Linux-дистрибутивах на базе Debian и Ubuntu пакет доступен в стандартных репозиториях:
sudo apt install adbУчтите, что версия из репозиториев может отставать от актуальной. Для свежей версии используйте официальный архив Platform Tools. Дополнительно на Linux может потребоваться настройка правил udev, чтобы система разрешала доступ к устройству без прав root — признаком проблемы служит вывод no permissions в списке устройств.
Настройка Android-устройства и драйверов
Сама по себе установка ADB на компьютер — только половина дела. Смартфон нужно перевести в режим отладки. Откройте «Настройки» → «О телефоне» и семь раз нажмите на пункт «Номер сборки», чтобы разблокировать меню «Для разработчиков». Точное расположение этого пункта зависит от оболочки (MIUI, One UI, ColorOS и др.), поэтому при необходимости сверьтесь с документацией производителя.
Затем в меню «Для разработчиков» активируйте переключатель Отладка по USB. Подключите устройство кабелем к компьютеру — на экране смартфона появится запрос на разрешение отладки с отпечатком RSA-ключа. Отметьте «Всегда разрешать с этого компьютера» и подтвердите.
⚠️ Внимание: режим отладки по USB даёт компьютеру расширенный доступ к устройству. Не подтверждайте запрос на отладку при подключении к чужим или общественным компьютерам, а после завершения работы отладку можно отключить.
На Windows дополнительно может понадобиться USB-драйвер производителя устройства. Если в «Диспетчере устройств» смартфон отображается с жёлтым восклицательным знаком или как «Неизвестное устройство», установите драйвер с официального сайта производителя либо универсальный Google USB Driver через SDK Manager.
Где найти USB-драйвер для моего смартфона
Google публикует список ссылок на драйверы OEM-производителей на сайте Android Developers (раздел «Get OEM USB Drivers»). Для устройств Google Pixel подходит Google USB Driver. Samsung, Xiaomi, Huawei и другие производители распространяют драйверы через свои сайты поддержки или фирменные утилиты.
Проверка подключения и первые команды
После настройки обеих сторон выполните ключевую проверку:
adb devicesВ ответ должен появиться серийный номер устройства со статусом device. Статус unauthorized означает, что на экране смартфона не подтверждён запрос на отладку — отключите и снова подключите кабель, затем разрешите доступ. Пустой список указывает на проблему с кабелем, драйвером или отключённой отладкой.
Для уверенности в работоспособности связки выполните пару базовых команд. Команда adb shell открывает терминал устройства прямо на компьютере, а adb devices -l показывает расширенную информацию о подключённом аппарате.
Типичные ошибки и их решение
Большинство проблем после установки укладывается в несколько повторяющихся сценариев. Таблица ниже поможет быстро сориентироваться.
| Ошибка / симптом | Вероятная причина | Решение |
|---|---|---|
| «adb is not recognized» / «command not found» | PATH не настроен или терминал не перезапущен | Проверить переменную Path, открыть новое окно терминала |
| Пустой список в adb devices | Отключена отладка, неисправный кабель, нет драйвера | Включить отладку, сменить кабель/порт, установить драйвер |
| Статус unauthorized | Не подтверждён запрос RSA на устройстве | Переподключить кабель и разрешить отладку на экране |
| no permissions (Linux) | Отсутствуют правила udev | Настроить udev-правила или запустить adb с sudo |
| error: more than one device | Подключено несколько устройств или эмуляторов | Указать цель: adb -s <серийный_номер> |
Если устройство «отваливается» посреди работы, попробуйте перезапустить сервер ADB: команда adb kill-server с последующим adb start-server сбрасывает зависшие соединения без переустановки утилиты. Также имеет смысл проверить другой USB-порт — предпочтительны порты непосредственно на материнской плате, а не на хабах.
⚠️ Внимание: командыadb reboot bootloaderи особенно любые операции черезfastboot flashизменяют состояние разделов устройства. Выполняйте их только с пониманием последствий и по инструкции для конкретной модели — ошибка может привести к невозможности загрузки системы.
Обновление и удаление ADB
Поскольку Platform Tools не имеет инсталлятора, обновление выполняется вручную: скачайте свежий архив с официального сайта и распакуйте его поверх существующей папки, заменив файлы. Проверить текущую версию поможет уже знакомая команда adb version. При установке через Homebrew или apt обновление выполняется штатными средствами пакетного менеджера.
Удаление столь же простое: достаточно удалить папку с утилитами и убрать её путь из переменной PATH. Никаких следов в реестре или системных каталогах ручная установка не оставляет — это одно из преимуществ портабельной поставки.
Часто задаваемые вопросы
Можно ли установить ADB без прав администратора?
Да. Распакуйте Platform Tools в пользовательскую папку и запускайте команды из неё или добавьте путь в пользовательскую (не системную) переменную PATH — права администратора для этого не требуются. Исключение — установка USB-драйверов на Windows, для неё права обычно нужны.
Чем ADB отличается от Fastboot?
ADB работает, когда устройство загружено в Android, и предназначен для отладки, передачи файлов и управления системой. Fastboot работает в режиме загрузчика и используется для прошивки разделов. Обе утилиты входят в один пакет Platform Tools.
Работает ли ADB по Wi-Fi без кабеля?
На устройствах с Android 11 и новее предусмотрена беспроводная отладка: она включается в меню «Для разработчиков» и сопрягается командой adb pair с кодом сопряжения. На более старых версиях первичное подключение по кабелю обычно обязательно.
Безопасно ли держать отладку по USB включённой постоянно?
Риск умеренный, но существует: при подключении к недоверенному компьютеру отладка теоретически может быть использована для доступа к данным. Разумная практика — включать отладку только на время работы и не подтверждать RSA-запросы на чужих машинах.
ADB видит эмулятор, но не видит телефон. Что делать?
Это указывает на проблему между компьютером и телефоном: проверьте кабель (передача данных), включённую отладку, драйвер в «Диспетчере устройств» и другой USB-порт. Эмулятор работает через виртуальное соединение, поэтому его видимость ничего не говорит о состоянии USB-подключения.