Когда команда adb devices возвращает пустой список или ошибку «'adb' is not recognized», почти всегда причина одна: пакет Android SDK Platform Tools либо не установлен, либо его путь не добавлен в системную переменную PATH. Этот официальный набор утилит от Google распространяется через страницу developer.android.com и включает инструменты ADB и Fastboot, без которых невозможна отладка приложений, передача файлов на устройство, разблокировка загрузчика и прошивка заводских образов.
В отличие от полного Android SDK, который весит несколько гигабайтов и требует Android Studio, Platform Tools — это компактный архив, который не нужно «устанавливать» в классическом смысле: достаточно распаковать его в удобную папку и при необходимости прописать путь в переменные окружения. Ниже разберём, что входит в пакет, как его корректно развернуть на Windows, macOS и Linux, и какие команды понадобятся чаще всего.
Что входит в состав Platform Tools
Пакет SDK Platform Tools представляет собой набор консольных утилит, которые Google обновляет вместе с каждой новой версией Android. Скачивание доступно на официальной странице раздела SDK в виде ZIP-архивов для трёх операционных систем, и это единственный источник, которому стоит доверять.
- 🔧 ADB (Android Debug Bridge) — основной инструмент для связи ПК с устройством: установка APK, выполнение shell-команд, передача файлов, сбор логов.
- ⚡ Fastboot — утилита для работы с устройством в режиме загрузчика: прошивка разделов, разблокировка bootloader, перезагрузка в нужные режимы.
- 📦 etc1tool, mke2fs и вспомогательные библиотеки — служебные компоненты, которые обычному пользователю напрямую не нужны, но требуются для корректной работы пакета.
- 📝 Файлы лицензии и заметки о версии — позволяют убедиться, что архив официальный и актуальный.
Отдельно стоит понимать разницу между Platform Tools и драйверами. Сами утилиты работают на компьютере, но Windows может дополнительно потребовать установки USB-драйвера конкретного производителя смартфона — иначе устройство просто не определится в системе. На macOS и Linux в большинстве случаев дополнительные драйверы не нужны.
Как скачать пакет с developer.android.com
Процедура загрузки одинакова для всех платформ. На странице загрузки SDK Platform Tools нужно выбрать архив под свою операционную систему, принять условия лицензионного соглашения и сохранить ZIP-файл. Размер архива невелик, поэтому скачивание занимает считанные секунды даже на медленном соединении.
После загрузки архив распаковывается в любую удобную папку. Желательно выбирать путь без кириллицы и пробелов — например, C:\platform-tools на Windows или ~/platform-tools на macOS и Linux. Это избавит от проблем с экранированием путей при работе в командной строке и упростит добавление папки в PATH.
Установка и настройка PATH на Windows
Чтобы команды adb и fastboot работали из любой папки, а не только из каталога platform-tools, путь к ним добавляется в системную переменную PATH. Без этого шага придётся каждый раз открывать терминал внутри папки с утилитами или указывать полный путь к исполняемому файлу.
В Windows настройка выполняется через свойства системы: откройте Параметры → Система → О системе → Дополнительные параметры системы, нажмите кнопку «Переменные среды», найдите переменную Path в пользовательском разделе и добавьте новую строку с путём к папке platform-tools. После сохранения закройте и заново откройте окно командной строки — изменения подхватываются только в новых сессиях терминала.
☑️ Проверка установки Platform Tools
Если adb version выводит номер версии и путь к исполняемому файлу — настройка завершена. Если же система отвечает, что команда не найдена, проверьте, не допущена ли опечатка в пути и не открыт ли терминал до изменения переменных среды.
Установка на macOS и Linux
На macOS и Linux логика та же: архив распаковывается, а путь к папке добавляется в переменную PATH через конфигурационный файл командной оболочки. В зависимости от используемого shell это может быть ~/.zshrc или ~/.bashrc. Строка для добавления выглядит так:
export PATH="$HOME/platform-tools:$PATH"После редактирования файла нужно либо перезапустить терминал, либо применить изменения командой source ~/.zshrc (или соответствующим файлом вашей оболочки). На Linux дополнительно может потребоваться настройка правил udev, чтобы система разрешала доступ к подключённому Android-устройству без прав суперпользователя — конкретный набор правил зависит от дистрибутива, поэтому сверяйтесь с его документацией.
⚠️ Внимание: на macOS при первом запуске исполняемых файлов из распакованного архива система безопасности Gatekeeper может заблокировать их. Разрешение выдаётся в разделе «Конфиденциальность и безопасность» системных настроек после первой попытки запуска.
Подключение устройства и включение отладки по USB
Установленные утилиты сами по себе ничего не делают — им нужно устройство с активированной отладкой. Для этого на смартфоне или планшете сначала включается скрытое меню «Для разработчиков»: в разделе «О телефоне» необходимо несколько раз нажать на пункт «Номер сборки». Точный путь и название пункта могут отличаться у разных производителей, поэтому при необходимости сверьтесь с инструкцией конкретной модели.
Затем в появившемся меню разработчика активируется переключатель «Отладка по USB». После подключения кабелем к компьютеру выполняется проверка:
adb devicesПри первом подключении на экране устройства появится запрос на разрешение отладки с данного компьютера — его нужно подтвердить, при желании отметив «Всегда разрешать». Если в списке устройство отображается со статусом unauthorized, значит, запрос на смартфоне не был подтверждён. Если список пуст — проверьте кабель (некоторые кабели передают только питание), порт USB и установку драйверов на Windows.
Основные команды ADB и Fastboot
Большинство повседневных задач решается небольшим набором команд. Ниже — те, что используются чаще всего, с пояснением результата.
| Команда | Назначение | Режим работы |
|---|---|---|
adb devices | Список подключённых устройств и их статус | Устройство включено |
adb install app.apk | Установка APK-файла на устройство | Устройство включено |
adb push file /sdcard/ | Копирование файла с ПК на устройство | Устройство включено |
adb reboot bootloader | Перезагрузка в режим fastboot | Устройство включено |
fastboot devices | Проверка связи в режиме загрузчика | Режим fastboot |
Обратите внимание: adb работает, когда устройство загружено в систему, а fastboot — только когда оно находится в режиме загрузчика. Это две разные среды, и команды одной не выполняются в другой. Если fastboot devices не видит устройство, убедитесь, что оно действительно перезагружено в режим загрузчика, а не просто выключено.
⚠️ Внимание: командыfastboot flashing unlockиfastboot oem unlock, используемые для разблокировки загрузчика, стирают все данные с устройства и могут повлиять на гарантию. Поддержка разблокировки и сама процедура зависят от производителя — перед выполнением изучите официальную документацию вашей модели и сделайте резервную копию.
Почему adb «не видит» устройство — частые причины
Наиболее вероятные причины: неподтверждённый запрос на отладку на экране смартфона, кабель без линий данных, отсутствующий USB-драйвер на Windows, конфликт с уже запущенным adb-сервером другой версии (лечится командой adb kill-server с последующим adb start-server), а также режим подключения USB, ограниченный только зарядкой.
Обновление и удаление Platform Tools
Пакет не имеет собственного установщика и механизма автообновления, поэтому обновление выполняется вручную: скачивается свежий архив с официальной страницы, и его содержимое заменяет файлы в существующей папке. Путь в PATH при этом менять не нужно — он остаётся прежним.
Удаление столь же простое: папка platform-tools стирается, а строка с её путём убирается из переменной PATH. Никаких следов в реестре или системных каталогах пакет не оставляет, что отличает его от полноценной установки Android Studio.
Часто задаваемые вопросы
Нужна ли Android Studio, если мне нужен только ADB?
Нет. Platform Tools — самостоятельный пакет, который работает без Android Studio и полного SDK. Именно его следует скачивать, если требуются только команды adb и fastboot.
Безопасно ли скачивать Platform Tools со сторонних сайтов?
Не рекомендуется. Сторонние «портативные сборки ADB» могут содержать устаревшие или изменённые файлы. Единственный надёжный источник — официальная страница на developer.android.com.
Почему команда adb не распознаётся в командной строке?
Наиболее вероятная причина — путь к папке platform-tools не добавлен в PATH либо терминал был открыт до изменения переменных среды. Закройте и заново откройте командную строку, затем проверьте командой adb version.
Чем adb отличается от fastboot?
ADB работает, когда устройство загружено в Android, и предназначен для установки приложений, передачи файлов и отладки. Fastboot работает в режиме загрузчика и используется для прошивки разделов и разблокировки bootloader.
Удалит ли разблокировка загрузчика мои данные?
Да, разблокировка загрузчика практически всегда сопровождается полным сбросом устройства. Перед выполнением сделайте резервную копию и уточните процедуру для вашей конкретной модели в документации производителя.