Ошибка 'adb' is not recognized as an internal or external command после установки Android SDK почти всегда означает одно: путь к инструментам платформы не прописан в переменной среды Path. Это самый частый сбой при настройке Android SDK на Windows 10, и он полностью решается правильной последовательностью установки, описанной ниже.
Android SDK (Software Development Kit) — это набор инструментов, без которых невозможна разработка приложений, отладка устройств через ADB и работа эмуляторов. Установить его можно двумя способами: вместе с Android Studio или отдельно через Command Line Tools. Второй вариант подходит тем, кому нужна только командная строка — например, для прошивки, снятия логов или тестирования.
Что входит в Android SDK и что вам понадобится
Прежде чем начать, полезно понимать структуру комплекта. SDK Platform-Tools содержат утилиты adb и fastboot, SDK Build-Tools нужны для сборки приложений, а SDK Platforms — это системные образы конкретных версий Android. Для базовых задач вроде подключения телефона к ПК достаточно Platform-Tools.
Для установки потребуется:
- 💻 Компьютер с Windows 10 (64-бит) и правами администратора;
- ☕ Установленный JDK (Java Development Kit) — без него sdkmanager не запустится;
- 🌐 Стабильное интернет-соединение для загрузки компонентов;
- 📁 Свободное место на диске — объём зависит от числа выбранных платформ и эмуляторов.
⚠️ Внимание: не распаковывайте SDK в папки с кириллицей или пробелами в пути, например в C:\Users\Иван\Мои документы. Ряд инструментов и скриптов сборки некорректно обрабатывает такие пути, что приводит к труднодиагностируемым ошибкам.
Способ 1: установка через Android Studio
Самый простой путь для новичков — скачать Android Studio с официального сайта разработчиков Google. Во время первичной настройки мастер автоматически загрузит SDK, Platform-Tools и эмулятор. По умолчанию SDK размещается в каталоге C:\Users\Имя\AppData\Local\Android\Sdk.
После установки откройте File → Settings → Appearance & Behavior → System Settings → Android SDK (в новых версиях путь может незначительно отличаться) и отметьте нужные компоненты на вкладках SDK Platforms и SDK Tools. Менеджер сам скачает и распакует выбранное.
Способ 2: установка Command Line Tools без Android Studio
Если среда разработки не нужна, скачайте архив Command line tools only с официальной страницы загрузки Android Studio — он находится внизу страницы. Распакуйте его так, чтобы структура выглядела как C:\Android\Sdk\cmdline-tools\latest\bin: вложенная папка latest обязательна, иначе sdkmanager выдаст ошибку о неверном расположении.
Далее откройте командную строку от имени администратора и выполните установку базовых компонентов:
cd C:\Android\Sdk\cmdline-tools\latest\bin
sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"
При первом запуске sdkmanager предложит принять лицензионные соглашения — нажимайте y на каждый запрос. После завершения в каталоге SDK появятся папки platform-tools, platforms и build-tools.
☑️ Чек-лист установки Android SDK
Настройка переменных среды
Чтобы команды adb и fastboot работали из любой папки, необходимо прописать пути в системных переменных. Откройте Панель управления → Система → Дополнительные параметры системы → Переменные среды или просто введите «переменные среды» в поиске Windows.
Создайте новую системную переменную ANDROID_HOME со значением пути к SDK, например C:\Android\Sdk. Затем отредактируйте переменную Path и добавьте в неё две записи: %ANDROID_HOME%\platform-tools и %ANDROID_HOME%\cmdline-tools\latest\bin.
⚠️ Внимание: после изменения переменных среды уже открытые окна командной строки не увидят новые пути. Закройте и заново откройте терминал либо перезагрузите компьютер, прежде чем проверять работу ADB.
Проверка установки и подключение устройства
Откройте новое окно командной строки и выполните по очереди две команды:
adb version
adb devices
Первая должна вывести версию Android Debug Bridge, вторая — список подключённых устройств. Если телефон подключен по USB и на нём включена отладка по USB в меню разработчика, в списке появится его серийный номер со статусом device. При первом подключении на экране смартфона появится запрос на разрешение отладки — подтвердите его.
Если устройство отображается как unauthorized, отзовите разрешения в настройках разработчика на телефоне и подключите заново. Пустой список чаще всего означает отсутствие USB-драйвера производителя либо неисправный кабель — проверьте подключение другим кабелем, поддерживающим передачу данных.
Где включить отладку по USB на телефоне
Откройте «Настройки» → «О телефоне» и семь раз нажмите на «Номер сборки», чтобы активировать режим разработчика. Затем перейдите в «Система» → «Для разработчиков» и включите переключатель «Отладка по USB». Точные названия пунктов зависят от оболочки производителя.
Сравнение способов установки
Выбор метода зависит от ваших задач. Таблица ниже поможет определиться:
| Критерий | Android Studio | Command Line Tools |
|---|---|---|
| Сложность установки | Минимальная, графический мастер | Требует работы с консолью |
| Занимаемое место | Больше — IDE, эмулятор, SDK | Меньше — только нужные пакеты |
| Для разработки приложений | Да, полный комплект | Нужна отдельная IDE |
| Для ADB/Fastboot и прошивки | Избыточно | Оптимальный вариант |
| Обновление компонентов | Через SDK Manager в IDE | Через sdkmanager в консоли |
Для одноразовых задач вроде снятия логов или разблокировки загрузчика отдельный вариант с Command Line Tools предпочтительнее: вы не перегружаете систему лишними службами и процессами IDE.
Типичные ошибки и их решение
Разберём сбои, с которыми чаще всего сталкиваются при установке. Ошибка JAVA_HOME is not set указывает, что sdkmanager не находит Java — установите JDK и создайте переменную JAVA_HOME с путём к его каталогу. Сбой Could not determine SDK root появляется, если архив распакован без папки latest — проверьте структуру каталогов.
Ещё одна распространённая ситуация: sdkmanager зависает или не может скачать пакеты. Возможная причина — блокировка соединения антивирусом, брандмауэром или корпоративным прокси. Временно проверьте загрузку с другой сети и убедитесь, что командная строка запущена с правами администратора.
⚠️ Внимание: скачивайте SDK и Command Line Tools только с официального сайта developer.android.com. Сторонние «сборки ADB» с файлообменников нередко содержат устаревшие версии или вредоносные вложения.
Часто задаваемые вопросы
Можно ли установить Android SDK без прав администратора?
Распаковать SDK в пользовательскую папку и запускать инструменты можно, но добавление системных переменных среды и установка некоторых драйверов потребуют прав администратора. Альтернатива — прописать пути в пользовательских (не системных) переменных.
Сколько места занимает Android SDK?
Точный объём зависит от выбранных компонентов: минимальный набор с Platform-Tools занимает немного, а полный комплект с несколькими платформами, эмуляторами и системными образами — значительно больше. Заранее оставьте запас свободного места на диске.
Нужна ли Java для работы ADB?
Для самих утилит adb и fastboot Java не требуется. Она необходима только для sdkmanager и инструментов сборки. Если вы пользуетесь готовым пакетом Platform-Tools, JDK можно не устанавливать.
Как обновить Android SDK до новой версии?
В Android Studio откройте SDK Manager и обновите компоненты на вкладке SDK Tools. При консольной установке выполните sdkmanager --update, а затем при необходимости установите свежие платформы командой sdkmanager "platforms;android-XX".
ADB видит устройство как offline — что делать?
Обновите Platform-Tools до актуальной версии, отзовите авторизации отладки на телефоне и подключите устройство заново, подтвердив запрос на экране. Также проверьте кабель и USB-порт — нестабильное соединение даёт похожий симптом.