Команда adb devices возвращает пустой список или ошибку «adb не является внутренней или внешней командой» — это верный признак того, что Android Debug Bridge либо не установлен, либо путь к нему не прописан в системной переменной PATH. Обе проблемы решаются за несколько минут, если выполнить установку и настройку в правильном порядке.
ADB — это официальная утилита из состава Android SDK Platform Tools, которую Google распространяет бесплатно. Она позволяет управлять смартфоном с компьютера: устанавливать приложения, передавать файлы, снимать логи, выполнять команды оболочки. Ниже разберём установку на Windows, macOS и Linux, а также типичные ошибки при первом подключении.
Что понадобится перед установкой
Прежде чем скачивать файлы, проверьте три вещи. Во-первых, у вас должен быть кабель USB, поддерживающий передачу данных, — некоторые кабели от зарядных устройств передают только питание, и компьютер физически не увидит телефон. Во-вторых, на смартфоне потребуется включить отладку по USB — без неё ADB-клиент не сможет авторизоваться на устройстве.
В-третьих, для Windows может понадобиться USB-драйвер производителя смартфона. На современных версиях Windows драйвер часто устанавливается автоматически, но для некоторых устройств его нужно ставить вручную с сайта производителя. На macOS и Linux отдельный драйвер обычно не требуется.
- 🔌 Исправный USB-кабель с поддержкой передачи данных
- 📱 Смартфон с включённым режимом разработчика
- 💻 Доступ к интернету для загрузки Platform Tools
- 🔑 Права администратора на компьютере (для изменения PATH)
Скачивание Android SDK Platform Tools
ADB больше не требует установки полного Android Studio. Достаточно загрузить архив SDK Platform Tools — это официальный пакет, в который входят adb, fastboot и вспомогательные библиотеки. На странице загрузки Google предлагает отдельные архивы для Windows, macOS и Linux.
Архив не имеет инсталлятора — его просто распаковывают в удобную папку. Для Windows логично выбрать короткий путь без пробелов и кириллицы, например C:\platform-tools. Это упростит настройку переменных окружения и исключит ошибки при вызове команд из консоли.
После распаковки проверьте, что в папке присутствует файл adb.exe (на macOS и Linux — просто adb). Если антивирус поместил его в карантин, восстановите файл и добавьте папку в исключения — это известная ложная реакция некоторых антивирусов на инструменты разработчика.
Установка ADB на Windows
На Windows есть два рабочих способа: запускать команды из папки с утилитой или добавить её в переменную PATH, чтобы вызывать adb из любого каталога. Второй вариант удобнее для постоянной работы. Откройте «Параметры» → «Система» → «О системе» → «Дополнительные параметры системы» → «Переменные среды».
В списке системных переменных найдите Path, нажмите «Изменить» и добавьте новую строку с полным путём к папке platform-tools. Сохраните изменения и перезапустите командную строку — уже открытые окна консоли не подхватят новое значение.
Проверка выполняется одной командой:
adb versionЕсли в ответ выводится номер версии Android Debug Bridge, установка прошла успешно. Если снова появляется ошибка «не является командой», проверьте, что путь указан без опечаток и ведёт именно к папке с adb.exe, а не к родительскому каталогу.
☑️ Установка ADB на Windows
⚠️ Внимание: не распаковывайте Platform Tools в каталоги вроде «Рабочий стол» или «Загрузки» с русскими буквами в пути. Некоторые скрипты и сторонние инструменты некорректно обрабатывают кириллицу и пробелы, из-за чего команды завершаются с ошибкой.
Установка на macOS и Linux
На macOS самый простой путь — пакетный менеджер Homebrew. Если он установлен, достаточно одной команды в терминале:
brew install android-platform-toolsБез Homebrew можно скачать архив Platform Tools, распаковать его и вызывать утилиту через полный путь, например ~/platform-tools/adb devices, либо добавить папку в PATH через файл ~/.zshrc.
На Linux дистрибутивах семейства Debian и Ubuntu пакет доступен в репозиториях:
sudo apt install adbУчтите, что версия из репозитория может отставать от актуальной. Для свежей версии используйте официальный архив Platform Tools. Дополнительно на Linux иногда требуется настроить udev-правила, чтобы система давала доступ к подключённому устройству без прав root — признаком проблемы служит вывод no permissions в списке устройств.
Включение отладки по USB на смартфоне
Компьютер готов, теперь нужно подготовить телефон. Откройте «Настройки» → «О телефоне» и семь раз подряд нажмите на пункт Номер сборки — появится сообщение о том, что вы стали разработчиком. Точное название пункта зависит от оболочки: у Xiaomi это может быть «Версия MIUI», у Samsung — «Сведения о ПО» → «Номер сборки». Сверьтесь с инструкцией к вашей модели, если пункт не находится.
После этого в настройках появится раздел «Для разработчиков» (обычно внутри «Система» или «Расширенные настройки»). В нём активируйте переключатель Отладка по USB. Смартфон может показать предупреждение о рисках — подтвердите включение.
Подключите устройство кабелем к компьютеру и выполните:
adb devicesНа экране телефона появится запрос «Разрешить отладку по USB?» с отпечатком RSA-ключа компьютера — без подтверждения этого запроса компьютер не получит доступ к устройству. Отметьте «Всегда разрешать с этого компьютера» и нажмите «ОК». В консоли устройство должно отобразиться со статусом device.
Типичные ошибки и их решение
Разберём статусы, которые выводит команда adb devices. Статус unauthorized означает, что запрос на авторизацию не был подтверждён на смартфоне: отключите кабель, в настройках разработчика выполните «Отозвать доступ для отладки по USB» и подключите устройство заново. Статус offline обычно лечится перезапуском сервера командами adb kill-server и adb start-server.
Пустой список устройств чаще всего указывает на проблему с кабелем или драйвером. Попробуйте другой порт USB, другой кабель и проверьте в Диспетчере устройств Windows, нет ли неопознанного оборудования с жёлтым значком. Если оно есть — установите USB-драйвер от производителя смартфона.
| Проблема | Возможная причина | Что проверить |
|---|---|---|
| «adb не является командой» | Папка не добавлена в PATH | Путь в переменных среды, перезапуск консоли |
| Пустой список устройств | Кабель без передачи данных или нет драйвера | Другой кабель, Диспетчер устройств |
| Статус unauthorized | Не подтверждён запрос на телефоне | Экран смартфона, отзыв и повторная выдача доступа |
| Статус offline | Сбой ADB-сервера | adb kill-server и повторное подключение |
| no permissions (Linux) | Отсутствуют udev-правила | Права доступа к USB-устройству |
⚠️ Внимание: не включайте отладку по USB на постоянной основе, если подключаете телефон к чужим или общедоступным компьютерам. Через ADB можно получить широкий доступ к данным устройства, поэтому после работы функцию разумно отключать.
Как проверить, какая версия ADB установлена
Выполните в консоли команду adb version — в первой строке выводится номер версии Android Debug Bridge и путь к исполняемому файлу. Сравните номер с актуальной версией Platform Tools на сайте developer.android.com. Если ваша версия сильно старше, скачайте свежий архив и замените содержимое папки.
Обновление и удаление ADB
Обновление сводится к замене файлов: скачайте свежий архив Platform Tools и распакуйте его поверх старой папки, либо выполните brew upgrade android-platform-tools на macOS. Переменную PATH менять не нужно, если путь остался прежним.
Удаление ещё проще: поскольку утилита не вносит записей в реестр, достаточно удалить папку platform-tools и убрать её путь из переменной Path. Драйверы смартфона при этом остаются в системе и не мешают дальнейшей работе.
Часто задаваемые вопросы
Нужен ли root-доступ для работы ADB?
Нет. Большинство команд ADB — установка приложений, передача файлов, просмотр логов, перезагрузка в recovery — работают на устройствах без root. Права суперпользователя требуются лишь для отдельных операций с системными разделами.
Можно ли использовать ADB без кабеля?
Да, на современных версиях Android поддерживается беспроводная отладка по Wi-Fi. Она включается в разделе «Для разработчиков» пунктом «Беспроводная отладка», после чего устройство сопрягается с компьютером по коду или QR-коду. Название и наличие функции зависят от версии Android и оболочки.
Почему телефон не показывает запрос на разрешение отладки?
Проверьте, что отладка по USB включена, кабель поддерживает передачу данных, а на телефоне разблокирован экран. Попробуйте сменить режим USB-подключения в шторке уведомлений на «Передача файлов (MTP)» и выполнить adb kill-server перед повторным подключением.
Чем ADB отличается от Fastboot?
ADB работает, когда система Android загружена, и управляет устройством в обычном режиме. Fastboot используется в режиме загрузчика — для прошивки разделов и разблокировки bootloader. Обе утилиты входят в один пакет Platform Tools.
Безопасно ли скачивать ADB со сторонних сайтов?
Рискованно. Официальный и проверенный источник — страница Platform Tools на developer.android.com. Сторонние «установщики ADB в один клик» могут содержать устаревшие версии или нежелательное ПО, поэтому доверять им не стоит.