Команда adb devices возвращает пустой список или ошибку «adb не является внутренней или внешней командой» — именно с этой проблемы чаще всего начинается знакомство пользователя с Android Debug Bridge, и причина почти всегда одна: утилита либо не установлена, либо путь к ней не прописан в системе. Установка ADB на компьютер занимает несколько минут, если выполнять шаги в правильном порядке и использовать только официальный пакет SDK Platform Tools от Google.
В этой инструкции разберём установку на Windows, macOS и Linux, настройку переменной PATH, включение отладки по USB на смартфоне и проверку соединения. Отдельно рассмотрим типичные ошибки: неопознанное устройство, статус unauthorized и конфликты драйверов.
Что такое ADB и зачем он нужен
ADB (Android Debug Bridge) — это консольная утилита из состава Android SDK, которая позволяет управлять смартфоном или планшетом с компьютера: устанавливать и удалять приложения, передавать файлы, снимать логи, перезагружать устройство в режимы recovery и fastboot, выполнять команды оболочки. Работает инструмент по схеме «клиент — сервер»: на компьютере запускается демон, который обменивается командами с устройством по USB-кабелю или по Wi-Fi.
Хотя ADB изначально создан для разработчиков, он полезен и обычным пользователям. С его помощью удаляют предустановленные приложения без root, делают скриншоты и записи экрана из командной строки, разблокируют загрузчик на поддерживаемых моделях и восстанавливают устройства после сбоев. Установка утилиты не требует прав администратора на уровне прошивки телефона — достаточно включить отладку по USB в настройках самого смартфона.
Что понадобится перед установкой
Перед началом убедитесь, что у вас есть всё необходимое. Список короткий, но пропуск любого пункта приведёт к ошибкам на этапе подключения.
- 💻 Компьютер с Windows 10/11, macOS или дистрибутивом Linux и свободным USB-портом.
- 🔌 Исправный USB-кабель, поддерживающий передачу данных — кабели «только для зарядки» не подойдут.
- 📱 Смартфон или планшет на Android с возможностью включить режим разработчика.
- 🌐 Доступ в интернет для загрузки архива SDK Platform Tools (размер — несколько мегабайт).
Отдельно проверьте кабель: это самая частая скрытая причина проблем. Если компьютер «не видит» телефон даже после корректной установки ADB, первым делом замените кабель на заведомо рабочий и попробуйте другой USB-порт, желательно напрямую на материнской плате, а не через хаб.
⚠️ Внимание: не скачивайте ADB с торрентов, файлообменников и «сборников драйверов». Единственный надёжный источник — официальная страница Android Developers. Архивы из непроверенных источников могут содержать устаревшую или модифицированную версию утилиты.
Шаг 1. Скачивание SDK Platform Tools
Пакет SDK Platform Tools распространяется Google бесплатно и включает три ключевые утилиты: adb, fastboot и etc1tool. Откройте официальную страницу разработчиков Android, найдите раздел загрузки Platform Tools и выберите архив под свою операционную систему — версии для Windows, macOS и Linux публикуются отдельно.
Установщика у пакета нет: это портативный набор утилит. Достаточно распаковать архив в удобную папку, например C:\platform-tools на Windows или ~/platform-tools на macOS и Linux. Избегайте путей с кириллицей и пробелами — некоторые скрипты и сторонние инструменты работают с такими путями некорректно.
Шаг 2. Установка и настройка на Windows
На Windows после распаковки архива ADB уже работоспособен — можно открыть командную строку прямо в папке platform-tools и выполнять команды. Но гораздо удобнее добавить путь к утилите в системную переменную PATH, чтобы запускать adb из любого каталога.
Порядок действий для Windows 10 и 11:
- ⚙️ Нажмите
Win + R, введитеsysdm.cplи откройте вкладку «Дополнительно». - 📝 Нажмите «Переменные среды», в списке системных переменных найдите
Pathи нажмите «Изменить». - 📂 Добавьте новую строку с полным путём к папке, например
C:\platform-tools, и сохраните изменения. - 🔄 Закройте и заново откройте командную строку — старые окна терминала не подхватывают новые переменные.
Проверьте результат командой adb version. Если в ответ выводится номер версии Android Debug Bridge — установка завершена. Если система отвечает, что команда не найдена, перепроверьте путь в PATH и убедитесь, что терминал был перезапущен.
☑️ Проверка установки ADB на Windows
Шаг 3. Установка на macOS и Linux
На macOS есть два пути. Первый — вручную: распаковать архив Platform Tools и добавить путь в файл ~/.zshrc строкой export PATH="$HOME/platform-tools:$PATH", после чего выполнить source ~/.zshrc. Второй — через пакетный менеджер Homebrew, если он уже установлен в системе:
brew install android-platform-toolsНа дистрибутивах Linux утилита обычно доступна в штатных репозиториях. В системах на базе Debian и Ubuntu установка выполняется одной командой:
sudo apt install adb fastbootДля Fedora и производных используется пакет android-tools. Учтите, что версия из репозиториев может отставать от актуальной сборки Google — для работы с самыми новыми версиями Android надёжнее вручную распаковать свежий архив Platform Tools. Также на Linux может потребоваться настройка udev-правил, чтобы система давала доступ к подключённому Android-устройству без запуска ADB от root; если устройство не определяется, проверьте наличие соответствующего пакета правил в документации вашего дистрибутива.
Зачем нужны udev-правила в Linux
По умолчанию обычный пользователь Linux не имеет доступа к USB-устройствам в режиме отладки. Udev-правила задают права на конкретные модели устройств по идентификатору производителя (Vendor ID). Без них команда adb devices может показывать «no permissions». Решение — установить пакет android-udev-rules из репозитория дистрибутива либо добавить правила вручную по документации.
Шаг 4. Включение отладки по USB на смартфоне
Без активированной отладки по USB компьютер не получит доступ к устройству, даже если ADB установлен идеально. Сначала нужно разблокировать скрытое меню «Для разработчиков»: откройте настройки телефона, перейдите в раздел «О телефоне» и несколько раз подряд нажмите на пункт «Номер сборки», пока система не сообщит, что вы стали разработчиком. На некоторых прошивках потребуется ввести PIN-код или пароль разблокировки.
Затем вернитесь в настройки, найдите появившийся раздел «Для разработчиков» (обычно внутри «Система» или «Расширенные настройки») и включите переключатель Отладка по USB. Точное расположение пункта зависит от оболочки — MIUI, One UI, ColorOS и «чистый» Android размещают его в разных местах, поэтому при затруднениях сверьтесь с инструкцией для вашей модели.
⚠️ Внимание: держать отладку по USB постоянно включённой небезопасно — при подключении к чужому компьютеру или зарядной станции злоумышленник теоретически может получить доступ к данным. Включайте режим только на время работы с ADB и отзывайте авторизацию компьютеров в настройках разработчика после завершения.
Шаг 5. Первое подключение и проверка
Подключите смартфон к компьютеру кабелем, разблокируйте экран и выполните в терминале команду:
adb devicesПри первом подключении на экране телефона появится запрос «Разрешить отладку по USB?» с отпечатком ключа компьютера. Отметьте пункт «Всегда разрешать с этого компьютера» и подтвердите. После этого устройство должно отображаться в списке со статусом device — это означает, что связь установлена и ADB полностью готов к работе.
Если вместо device отображается unauthorized, значит, запрос на разрешение не был подтверждён на телефоне: отключите и заново подключите кабель, следя за экраном смартфона. Если список пуст вовсе — проблема в кабеле, порте, драйверах или отключённой отладке.
Типичные ошибки и их решение
Большинство проблем при установке ADB сводится к нескольким повторяющимся сценариям. Сводная таблица поможет быстро найти своё состояние и действие для исправления.
| Симптом | Вероятная причина | Что проверить |
|---|---|---|
| «adb не является командой» | Путь не добавлен в PATH | Переменную Path и перезапуск терминала |
| Пустой список в adb devices | Кабель без передачи данных или отключена отладка | Другой кабель, другой порт, настройки разработчика |
| Статус unauthorized | Не подтверждён запрос на телефоне | Экран смартфона, повторное подключение |
| Устройство с восклицательным знаком в Диспетчере устройств | Отсутствует драйвер (Windows) | Обновление драйвера через Диспетчер устройств |
| no permissions (Linux) | Нет udev-правил | Пакет правил для Android-устройств |
На Windows отдельного внимания заслуживают драйверы. Современные версии системы часто подхватывают устройство автоматически, но если в Диспетчере устройств смартфон отображается с ошибкой, попробуйте вручную выбрать для него стандартный драйвер «Android ADB Interface» из списка доступных в системе либо установить драйвер с сайта производителя телефона. Перед этим убедитесь, что проблема не в кабеле — подмена драйверов не поможет при физической неисправности.
⚠️ Внимание: команды ADB вроде
adb reboot bootloaderи операции черезfastbootмогут привести к потере данных при неправильном использовании. Перед любыми действиями с прошивкой или разблокировкой загрузчика сделайте резервную копию и изучите инструкцию именно для вашей модели устройства.
Полезные команды ADB для начала работы
После успешной установки имеет смысл освоить базовый набор команд. Они безопасны и позволяют убедиться, что инструмент работает в полном объёме.
- 📋
adb devices— список подключённых устройств и их статус. - 📦
adb install app.apk— установка APK-файла на смартфон. - 📁
adb push file /sdcard/— копирование файла с компьютера на устройство. - 📥
adb pull /sdcard/DCIM/ ./— скачивание файлов с телефона на ПК. - 🐚
adb shell— открытие командной оболочки Android на компьютере. - 🔄
adb reboot— перезагрузка устройства.
Полный список возможностей доступен по команде adb help, а подробное описание каждой — в официальной документации Android. Начинайте с безобидных операций чтения информации, прежде чем переходить к командам, изменяющим систему.
Часто задаваемые вопросы
Можно ли установить ADB без прав администратора?
Да. Platform Tools — портативный пакет, он работает из любой папки пользователя. Без прав администратора не получится только изменить системную переменную PATH, но можно добавить путь в пользовательские переменные среды или запускать adb из папки, где лежит утилита.
Чем ADB отличается от Fastboot?
ADB работает, когда на устройстве загружена система Android (или recovery с поддержкой ADB). Fastboot используется, когда телефон находится в режиме загрузчика, и применяется для прошивки разделов и разблокировки bootloader. Обе утилиты входят в один пакет Platform Tools.
Работает ли ADB через Wi-Fi без кабеля?
Да, современные версии Android поддерживают беспроводную отладку: она включается в настройках разработчика, после чего устройство сопрягается с компьютером по сети. На старых версиях Android первичное подключение по Wi-Fi требовало сначала выполнить команду через USB-кабель.
Почему телефон виден в системе, но adb devices его не показывает?
То, что смартфон определяется как накопитель, не означает готовности к отладке. Проверьте, включена ли отладка по USB, подтверждён ли запрос на разрешение на экране телефона и установлены ли драйверы. Также попробуйте другой кабель и порт.
Нужно ли обновлять ADB?
Google периодически выпускает новые версии Platform Tools, добавляя поддержку свежих версий Android и исправляя ошибки. Если при работе с новым смартфоном возникают странные сбои, скачайте актуальный архив с официального сайта и замените содержимое папки — это безопасно и не требует переустановки.