Ошибка «adb не является внутренней или внешней командой» при попытке запустить adb devices — типичный признак того, что Android SDK либо не установлен, либо путь к нему не прописан в системных переменных. Именно с этой проблемой чаще всего сталкиваются пользователи, которые впервые устанавливают Android SDK — официальный набор инструментов разработчика от Google.
Android SDK (Software Development Kit) — это не одна программа, а комплект компонентов: инструменты командной строки, платформенные библиотеки, эмулятор, утилита ADB и менеджер пакетов. Набор нужен не только разработчикам приложений: он требуется для прошивки устройств, снятия логов, разблокировки загрузчика и тестирования программ на виртуальных смартфонах. Разберёмся, из чего состоит SDK, как его установить и настроить на Windows, macOS и Linux.
Что входит в состав Android SDK
Комплект распространяется модульно: базовый установщик занимает немного, а нужные пакеты докачиваются через SDK Manager. Это позволяет держать на диске только те компоненты, которые реально используются.
- 🛠️ SDK Platform-Tools — утилиты ADB и Fastboot для связи компьютера с устройством;
- 📦 SDK Platforms — системные образы и библиотеки конкретных версий Android;
- 📱 Android Emulator — эмулятор для запуска виртуальных устройств;
- ⚙️ SDK Build-Tools — компиляторы и упаковщики для сборки APK;
- 🖥️ Command-line Tools — консольный менеджер пакетов для серверов и автоматизации.
Если цель — только подключить телефон к ПК через ADB, достаточно пакета Platform-Tools, который Google распространяет отдельным архивом. Полный SDK имеет смысл ставить тем, кто пишет приложения или работает с эмулятором.
Где скачать Android SDK
Скачивать SDK следует только с официального сайта для разработчиков developer.android.com. Сторонние сборники и «репаки» нередко содержат устаревшие версии утилит, а иногда и вредоносный код — особенно это критично для инструментов, которые получают прямой доступ к устройству.
Доступны два варианта установки. Первый — полноценная среда Android Studio, в состав которой SDK входит по умолчанию. Второй — отдельные Command line tools для тех, кто работает без графической IDE. Оба варианта бесплатны.
⚠️ Внимание: не скачивайте ADB и Fastboot с файлообменников и сомнительных порталов. Поддельная утилита с правами отладки способна выполнять команды на подключённом смартфоне, включая удаление данных.
Установка через Android Studio
Самый простой путь для новичка — поставить Android Studio: мастер установки сам загрузит актуальные компоненты SDK и разложит их по нужным каталогам. Процесс занимает время из-за объёма загружаемых пакетов, поэтому желательно стабильное интернет-соединение.
Порядок действий выглядит так:
- ⬇️ Скачайте установщик Android Studio с официального сайта и запустите его;
- 📂 На этапе выбора компонентов оставьте отметки
Android SDKиAndroid Virtual Device; - 📁 Укажите папку установки SDK — лучше без кириллицы и пробелов в пути;
- ✅ После первого запуска дождитесь окончания загрузки компонентов в мастере настройки.
☑️ Проверка после установки Android Studio
По умолчанию SDK размещается в профиле пользователя, например в Windows это обычно каталог %LOCALAPPDATA%\Android\Sdk. Точный путь всегда можно посмотреть в настройках среды через File → Settings → Languages & Frameworks → Android SDK.
Установка без Android Studio: Command line tools
Когда IDE не нужна — например, на сервере сборки или слабом ПК — используют консольный вариант. Архив Command line tools распаковывается вручную, после чего пакеты ставятся утилитой sdkmanager.
Пример установки базовых компонентов из терминала:
sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"При первом запуске менеджер попросит принять лицензионные соглашения — это делается командой sdkmanager --licenses с подтверждением каждого пункта. Список всех доступных пакетов выводится через sdkmanager --list.
Настройка переменных среды
Чтобы команды adb и fastboot работали из любой папки терминала, путь к Platform-Tools добавляют в системную переменную PATH. Без этого шага и возникает упомянутая в начале статьи ошибка «не является внутренней или внешней командой».
В Windows настройка выполняется через Панель управления → Система → Дополнительные параметры системы → Переменные среды. В список Path добавляется полный путь к каталогу platform-tools внутри SDK. После сохранения терминал нужно закрыть и открыть заново — старые окна не подхватывают изменения.
На macOS и Linux путь прописывается в конфигурации командной оболочки, например в файле ~/.zshrc или ~/.bashrc:
export PATH="$PATH:$HOME/Android/Sdk/platform-tools"Проверка результата простая: команда adb version должна вывести номер версии утилиты, а не ошибку. Если версия отображается — настройка завершена.
Типичные ошибки и их решения
Чаще всего проблемы возникают не с самим SDK, а с окружением: драйверами, правами доступа и устаревшими пакетами. Разберём частые сценарии.
| Проблема | Вероятная причина | Что проверить |
|---|---|---|
| adb не видит устройство | Отключена отладка по USB | Включить отладку в настройках разработчика телефона |
| unauthorized в списке devices | Не подтверждён RSA-ключ | Разрешить отладку в диалоге на экране смартфона |
| SDK Manager не грузит пакеты | Блокировка сети или прокси | Проверить соединение и настройки прокси в менеджере |
| Эмулятор не запускается | Отключена виртуализация | Включить VT-x / AMD-V в BIOS/UEFI |
| Ошибка лицензий при сборке | Не приняты соглашения | Выполнить sdkmanager --licenses |
⚠️ Внимание: драйверы USB для отладки зависят от производителя смартфона. Для Windows драйвер конкретной модели скачивается с сайта вендора; универсальный Google USB Driver подходит не всем устройствам. На macOS и Linux отдельные драйверы обычно не требуются.
Если устройство определяется как offline, помогает перезапуск сервера отладки командами adb kill-server и adb start-server, а также замена USB-кабеля — часть кабелей поддерживает только зарядку без передачи данных.
Обновление и удаление компонентов
SDK обновляется через тот же SDK Manager: во вкладке с платформами и инструментами отмечаются пакеты с доступными обновлениями. Регулярное обновление Platform-Tools важно, потому что свежие версии Android могут некорректно работать со старым ADB.
Удалять компоненты тоже удобно через менеджер — снимается отметка с пакета, и он стирается с диска. Вручную удалять папки внутри каталога SDK не стоит: менеджер хранит собственный реестр установленного, и рассинхронизация приводит к ошибкам.
⚠️ Внимание: перед удалением старых платформ убедитесь, что ни один из ваших проектов не собирается под них. Иначе сборка прервётся с ошибкой отсутствующей платформы, и пакет придётся качать заново.
Сколько места занимает Android SDK
Минимальный набор с одной платформой и Platform-Tools занимает несколько гигабайт. Полный комплект с эмулятором, системными образами и NDK может превышать десятки гигабайт. Лишние образы эмулятора и неиспользуемые платформы — первые кандидаты на удаление при нехватке места.
Часто задаваемые вопросы
Чем Android SDK отличается от Android Studio?
Android Studio — это среда разработки (редактор кода, отладчик, дизайнер интерфейсов), а Android SDK — набор инструментов и библиотек, которым она пользуется. SDK можно установить и отдельно, без студии.
Можно ли пользоваться ADB без установки всего SDK?
Да. Пакет Platform-Tools распространяется отдельным архивом и содержит ADB с Fastboot. Для подключения телефона и выполнения базовых команд этого достаточно.
Почему команда adb работает в одном терминале, но не работает в другом?
Окно терминала, открытое до изменения переменной PATH, не видит новых настроек. Закройте все окна терминала и откройте заново. Если не помогло — проверьте, что путь добавлен именно в переменную Path и не содержит опечаток.
Нужна ли отдельная установка SDK для эмулятора?
Эмулятор и системные образы устанавливаются через SDK Manager как обычные пакеты. Для запуска виртуального устройства также должна быть включена аппаратная виртуализация в BIOS/UEFI компьютера.
Безопасно ли включать отладку по USB на личном смартфоне?
При подключении к собственному компьютеру риск минимален — каждое новое подключение требует подтверждения на экране телефона. Не подтверждайте отладку на чужих ПК и публичных зарядных станциях, а после завершения работы отладку можно отключить.