Если при запуске сборки проекта или подключении устройства по ADB система сообщает, что команда не найдена, почти наверняка Android SDK либо не установлен, либо путь к нему не прописан в переменных среды Windows. Это самая частая причина, с которой сталкиваются разработчики после первой установки инструментария.
Android SDK (Software Development Kit) — это набор инструментов от Google для разработки, тестирования и отладки приложений под Android. В комплект входят SDK Platform-Tools (включая adb и fastboot), эмуляторы, системные образы и библиотеки платформы. В этой статье разберём, как установить SDK на Windows, настроить окружение и устранить типичные проблемы.
Что входит в состав Android SDK
Прежде чем скачивать что-либо, полезно понимать структуру комплекта. SDK — это не один файл, а набор модулей, которые можно ставить и обновлять по отдельности через SDK Manager.
- 🧰 SDK Platform-Tools — утилиты командной строки: adb, fastboot, необходимые для связи ПК с устройством;
- 📱 SDK Platforms — пакеты для конкретных версий Android API, под которые компилируется приложение;
- 🖥️ Android Emulator и системные образы — для запуска виртуальных устройств без физического смартфона;
- 🔧 SDK Build-Tools — компиляторы и утилиты сборки проекта.
Отдельно существуют Command Line Tools — минимальный вариант SDK без графической среды разработки. Он подходит для серверов сборки или тех, кто работает в другой IDE, но требует ручной настройки.
Способы установки Android SDK на Windows
Самый простой путь — установить Android Studio, официальную среду разработки от Google. Вместе с IDE автоматически загружается SDK, эмулятор и Platform-Tools, а мастер настройки предлагает выбрать нужные компоненты при первом запуске. Для большинства пользователей этого достаточно.
Альтернатива — автономная установка Command Line Tools с официального сайта разработчиков Android. Архив распаковывается вручную, после чего пакеты ставятся через утилиту sdkmanager. Этот вариант легче по объёму, но требует аккуратности со структурой папок.
⚠️ Внимание: скачивайте SDK только с официального сайта Android Developers. Сторонние сборники инструментов могут содержать устаревшие или модифицированные компоненты, что ведёт к ошибкам совместимости и рискам безопасности.
Пошаговая установка через Android Studio
Процесс установки через Android Studio занимает заметное время из-за объёма загружаемых компонентов, поэтому заранее убедитесь в стабильном интернет-соединении и наличии свободного места на диске — пакеты SDK вместе с системными образами могут занимать десятки гигабайт.
☑️ Установка Android SDK через Android Studio
После завершения установки откройте File → Settings → Appearance & Behavior → System Settings → Android SDK (в актуальных версиях путь может незначительно отличаться). Здесь виден каталог Android SDK Location и список установленных пакетов — отсюда же можно доустановить нужные версии платформ.
Настройка переменных среды и проверка ADB
Чтобы команды adb и fastboot работали из любого окна командной строки, нужно добавить путь к Platform-Tools в системную переменную Path. Обычно инструменты находятся в подпапке platform-tools внутри каталога SDK, который по умолчанию располагается в профиле пользователя, например %LOCALAPPDATA%\Android\Sdk.
Порядок действий: откройте «Система → О системе → Дополнительные параметры системы → Переменные среды», в разделе системных или пользовательских переменных найдите Path и добавьте полный путь к папке platform-tools. Дополнительно можно создать переменную ANDROID_HOME с путём к корню SDK — её используют некоторые инструменты сборки.
Проверка выполняется одной командой в новом окне терминала:
adb versionЕсли выводится номер версии — настройка завершена. Если система отвечает, что команда не распознана, перепроверьте путь и перезапустите терминал: переменные среды не подхватываются в уже открытых окнах.
⚠️ Внимание: редактируя переменные среды, не удаляйте существующие значения
Path— добавляйте новый путь отдельной строкой. Случайное удаление системных путей может нарушить работу других программ.
Сравнение вариантов установки
Выбор способа зависит от задач. Ниже — сравнение основных подходов без привязки к конкретным номерам версий, так как состав компонентов со временем меняется.
| Способ | Что входит | Кому подходит |
|---|---|---|
| Android Studio (полная) | IDE, SDK, эмулятор, Platform-Tools | Разработчикам приложений |
| Command Line Tools | sdkmanager, базовые утилиты | Сборка на серверах, работа в другой IDE |
| Только Platform-Tools | adb, fastboot | Прошивка и отладка устройств без разработки |
| SDK через Visual Studio | SDK для Xamarin/.NET MAUI | Кроссплатформенная разработка на C# |
Обратите внимание: если вам нужен только ADB для перепрошивки или диагностики смартфона, ставить полную Android Studio не обязательно — достаточно отдельного архива Platform-Tools, который Google распространяет самостоятельно.
Где искать SDK после установки
По умолчанию Android Studio размещает SDK в профиле пользователя Windows: C:\Users\Имя\AppData\Local\Android\Sdk. Папка AppData скрытая — включите отображение скрытых элементов в проводнике или вставьте путь в адресную строку напрямую. Точный путь всегда можно посмотреть в настройках Android Studio в разделе Android SDK.
Типичные ошибки и их решение
Даже при корректной установке пользователи сталкиваются с рядом повторяющихся проблем. Разберём самые распространённые.
- ❌ «adb не является внутренней или внешней командой» — путь к platform-tools не добавлен в Path либо терминал не перезапущен после изменения переменных;
- 🔌 Устройство не определяется в adb devices — проверьте, включена ли отладка по USB в настройках разработчика на смартфоне и установлен ли драйвер устройства в Windows;
- 🐢 Эмулятор работает медленно или не запускается — возможная причина в отключённой виртуализации в BIOS/UEFI или конфликте с Hyper-V; поведение зависит от конфигурации ПК;
- 📦 SDK Manager не загружает пакеты — проверьте интернет-соединение, настройки прокси и права на запись в каталог SDK.
Если устройство видно в системе, но adb devices выдаёт статус unauthorized, разблокируйте смартфон и подтвердите запрос на разрешение отладки на его экране. Если статус offline, помогает перезапуск сервера командой adb kill-server с последующим adb start-server.
Обновление и обслуживание SDK
SDK требует периодического обновления: новые версии платформ Android появляются регулярно, а старые пакеты со временем перестают поддерживаться инструментами сборки. В Android Studio обновления выполняются через тот же SDK Manager — на вкладках SDK Platforms и SDK Tools отмечаются нужные компоненты.
Не обязательно держать установленными все версии платформ. Для актуальной разработки обычно достаточно последних стабильных уровней API, а устаревшие системные образы эмулятора можно удалить, освободив заметный объём диска. Перед удалением убедитесь, что ваши проекты не ссылаются на удаляемую версию в конфигурации сборки.
Часто задаваемые вопросы
Можно ли установить Android SDK без Android Studio?
Да. Google распространяет отдельные Command Line Tools и архив Platform-Tools. Этого достаточно для работы с adb, fastboot и сборки проектов через командную строку, однако настройка потребует ручной работы с переменными среды и sdkmanager.
Сколько места занимает Android SDK на диске?
Точный объём зависит от выбранных компонентов: минимальный набор занимает относительно немного, но полная установка с несколькими платформами и системными образами эмулятора может достигать десятков гигабайт. Рекомендуется заранее зарезервировать достаточно свободного места.
Почему эмулятор Android не запускается на Windows?
Возможные причины: отключённая виртуализация в BIOS/UEFI, конфликт с Hyper-V или другими гипервизорами, недостаток оперативной памяти. Проверьте, включена ли виртуализация в настройках прошивки вашего ПК, и сверьтесь с документацией к эмулятору для вашей конфигурации.
Как узнать, где установлен Android SDK?
Откройте Android Studio и перейдите в настройки Android SDK — путь указан в поле Android SDK Location. По умолчанию это скрытая папка в профиле пользователя: %LOCALAPPDATA%\Android\Sdk.
Нужен ли SDK, если мне нужен только ADB?
Нет, полный SDK не обязателен. Для работы с adb и fastboot достаточно отдельного пакета Platform-Tools, который распаковывается в любую папку и добавляется в Path вручную.