Команда adb devices возвращает пустой список или ошибку «adb не является внутренней или внешней командой» — это верный признак того, что ADB либо не установлен, либо путь к нему не прописан в системной переменной PATH. Обе проблемы решаются за несколько минут, если действовать в правильном порядке.
ADB (Android Debug Bridge) — это официальная утилита от Google, входящая в пакет Android SDK Platform Tools. Она позволяет управлять Android-устройством с компьютера: устанавливать приложения, снимать логи, перезагружать смартфон в разные режимы и выполнять множество других операций. Ниже разберём установку на Windows, macOS и Linux, настройку драйверов и типичные ошибки.
Что понадобится перед установкой
Для работы ADB нужны три вещи: сам пакет Platform Tools, смартфон с включённой отладкой по USB и качественный USB-кабель. Кабель — не мелочь: дешёвые «зарядные» провода часто не имеют линий передачи данных, и устройство просто не определится компьютером.
На смартфоне предварительно активируйте режим разработчика. Для этого откройте Настройки → О телефоне и несколько раз нажмите на пункт «Номер сборки», пока система не сообщит, что вы стали разработчиком. Точное название пункта может отличаться в зависимости от оболочки (MIUI, One UI, ColorOS), поэтому при необходимости сверьтесь с инструкцией к вашей модели.
- 🔌 USB-кабель с поддержкой передачи данных
- 📱 Включённая отладка по USB в настройках разработчика
- 💻 Доступ к интернету для загрузки Platform Tools
- 🔑 Права администратора на компьютере (для настройки PATH)
Загрузка Android SDK Platform Tools
Скачивать ADB нужно только с официального сайта разработчиков Android — страницы developer.android.com, посвящённой SDK Platform Tools. Сторонние «сборки ADB» с файлообменников могут содержать устаревшие версии или вредоносный код.
На странице доступны три архива: для Windows, macOS и Linux. Выберите версию под свою систему и распакуйте архив в удобную папку, например C:\platform-tools на Windows или домашнюю директорию на других системах. Путь к папке лучше делать без кириллицы и пробелов — это исключит часть ошибок при работе из командной строки.
⚠️ Внимание: не скачивайте «установщики ADB» с неофициальных сайтов. Google распространяет Platform Tools только в виде ZIP-архива без инсталлятора. Любой .exe-файл, обещающий «установить ADB в один клик», — потенциальный риск.
Установка ADB на Windows
На Windows установка сводится к распаковке архива и добавлению папки в переменную окружения PATH, чтобы команда adb работала из любого каталога командной строки. Распакуйте архив, например, в C:\platform-tools.
Далее откройте Параметры → Система → О системе → Дополнительные параметры системы → Переменные среды. В списке системных переменных найдите Path, нажмите «Изменить» и добавьте новую строку с путём к папке. Сохраните изменения и перезапустите командную строку.
Проверка выполняется одной командой:
adb versionЕсли в ответ выводится номер версии Android Debug Bridge — установка прошла успешно. Если система пишет, что команда не найдена, проверьте правильность пути в PATH и то, что вы открыли новое окно терминала после изменения переменных.
☑️ Проверка установки ADB на Windows
Установка на macOS и Linux
На macOS есть два пути. Первый — аналогичный Windows: распаковать архив и добавить папку в PATH через файл ~/.zshrc, добавив строку вида export PATH="$HOME/platform-tools:$PATH". Второй вариант — установка через пакетный менеджер Homebrew:
brew install android-platform-toolsНа Linux помимо ручной распаковки можно использовать репозитории дистрибутива. В Debian и Ubuntu пакет обычно называется adb или android-tools-adb, в Fedora — android-tools. Установка из репозитория удобна автоматическими обновлениями, но версия там может отставать от официальной.
Для Linux также может потребоваться настройка правил udev, чтобы система видела подключённое устройство без запуска ADB от имени суперпользователя. Если устройство не определяется, проверьте документацию вашего дистрибутива — набор правил зависит от производителя смартфона.
Драйверы и подключение устройства
На Windows для корректного определения смартфона могут понадобиться USB-драйверы производителя. Google публикует драйвер для своих устройств Pixel, а для аппаратов Samsung, Xiaomi и других брендов драйверы обычно доступны на официальных сайтах производителей. На macOS и Linux отдельные драйверы, как правило, не требуются.
Подключите смартфон кабелем, разблокируйте экран и выполните:
adb devicesПри первом подключении на экране телефона появится запрос «Разрешить отладку по USB?» — подтвердите его, при желании отметив «Всегда разрешать с этого компьютера». Если запрос не появился, отзовите ранее выданные разрешения в настройках разработчика и переподключите кабель.
⚠️ Внимание: не подтверждайте запрос на отладку, если смартфон подключён к чужому или общественному компьютеру. Через ADB возможен глубокий доступ к устройству, поэтому разрешайте его только на своём ПК.
Типичные ошибки и их решение
Чаще всего пользователи сталкиваются с горсткой повторяющихся проблем. В таблице ниже собраны основные сценарии и способы их устранения.
| Проблема | Вероятная причина | Решение |
|---|---|---|
| «adb не является командой» | Папка не добавлена в PATH | Проверить переменную Path, перезапустить терминал |
| Пустой список в adb devices | Кабель без линий данных или нет драйвера | Сменить кабель, установить драйвер производителя |
| Статус unauthorized | Не подтверждён запрос на телефоне | Разблокировать экран и разрешить отладку |
| Статус offline | Конфликт версий ADB или сбой сервера | Выполнить adb kill-server, затем adb start-server |
| Устройство не видно на Linux | Отсутствуют правила udev | Настроить правила по документации дистрибутива |
Если ничего не помогает, перезапустите сервер ADB командой adb kill-server и подключите устройство заново. Также попробуйте другой USB-порт — желательно напрямую на материнской плате, без хабов и удлинителей: нестабильное соединение — частая скрытая причина сбоев.
Что такое fastboot и нужен ли он
Fastboot — второй инструмент из пакета Platform Tools, работающий с устройством в режиме загрузчика. Он используется для разблокировки bootloader и прошивки разделов. Устанавливать его отдельно не нужно — он уже лежит в той же папке platform-tools.
Первые команды для проверки работы
После успешного подключения можно выполнить несколько безопасных команд, чтобы убедиться, что всё функционирует. Они не изменяют данные на устройстве и подходят для первого знакомства с инструментом.
- 📋
adb devices— список подключённых устройств - 📦
adb shell pm list packages— перечень установленных пакетов - 🔋
adb shell dumpsys battery— информация о батарее - 📁
adb pull /sdcard/DCIM ./photos— копирование файлов на ПК
С осторожностью относитесь к командам удаления пакетов и изменения системных настроек — необдуманные действия через ADB могут нарушить работу смартфона. Перед любыми необратимыми операциями делайте резервную копию важных данных.
Часто задаваемые вопросы
Можно ли установить ADB без прав администратора?
Да. Распакуйте Platform Tools в папку пользователя и запускайте команды из этой папки, указывая полный путь или открыв терминал внутри неё. Добавление в PATH без прав администратора возможно только для пользовательских переменных среды.
Работает ли ADB без кабеля, по Wi-Fi?
На современных версиях Android предусмотрена беспроводная отладка, которая включается в настройках разработчика. Порядок сопряжения зависит от версии Android на устройстве, поэтому сверяйтесь с актуальной документацией для своей прошивки.
Нужно ли обновлять Platform Tools?
Да, периодически стоит скачивать свежую версию с официального сайта — в обновлениях исправляются ошибки и добавляется поддержка новых версий Android. Старая версия ADB иногда не может корректно работать с новыми устройствами.
Почему антивирус реагирует на adb.exe?
Если архив скачан с официального сайта Google, срабатывание антивируса — ложное. Проверьте цифровую подпись файла и добавьте папку в исключения защитника. Файлы из сторонних источников при таком срабатывании лучше удалить.
Можно ли пользоваться ADB без включения отладки по USB?
Нет, отладка по USB — обязательное условие для подключения. Без неё компьютер не получит доступ к интерфейсу отладки устройства, и команда adb devices покажет пустой список.