Когда при сборке проекта Android Studio выдаёт ошибку «SDK location not found» или «Failed to find Platform SDK», причина почти всегда кроется в некорректной установке или настройке SDK Tools — набора инструментов, без которых среда разработки не может компилировать и запускать приложения. Проверить состояние пакета можно прямо из IDE: откройте File → Settings → Appearance & Behavior → System Settings → Android SDK и посмотрите, какие компоненты отмечены галочками.
SDK Tools — это не один файл, а целый набор утилит: от эмулятора до инструментов командной строки. Разберёмся, что входит в пакет, как правильно его установить и обновить, а также как исправить самые распространённые ошибки, с которыми сталкиваются разработчики.
Что входит в состав SDK Tools
Пакет инструментов Android SDK состоит из нескольких логических групп, каждая из которых отвечает за свою задачу. Понимание структуры помогает не качать лишнее и быстро находить нужный компонент.
- 🛠️ Android SDK Build-Tools — компиляторы и утилиты сборки (d8, aapt2), превращающие исходный код в APK или AAB.
- 📱 Android SDK Platform-Tools — инструменты взаимодействия с устройством: adb, fastboot, systrace.
- 🖥️ Android Emulator — эмулятор для запуска приложений без физического устройства.
- 📦 SDK Platforms — системные образы и API для каждой версии Android, под которую ведётся разработка.
- ⌨️ Command-line Tools — утилиты
sdkmanagerиavdmanagerдля управления SDK без графического интерфейса.
Отдельно стоит упомянуть NDK (Native Development Kit) — он нужен только для проектов с нативным кодом на C или C++. Обычному разработчику на Kotlin или Java этот компонент не требуется, а его установка занимает заметный объём на диске.
Установка SDK Tools через SDK Manager
Основной способ управления пакетами — встроенный SDK Manager. При первом запуске Android Studio мастер настройки предложит скачать базовый набор компонентов, но в дальнейшем придётся управлять ими вручную.
Чтобы открыть SDK Manager, перейдите в Tools → SDK Manager или нажмите соответствующую иконку на панели инструментов. Окно разделено на три вкладки: SDK Platforms (версии Android), SDK Tools (инструменты) и SDK Update Sites (источники обновлений).
☑️ Первичная настройка SDK
Отметьте нужные компоненты галочками и нажмите Apply — менеджер покажет объём загрузки и запросит подтверждение лицензионных соглашений. Загрузка может занять продолжительное время в зависимости от скорости соединения.
⚠️ Внимание: путь установки SDK по умолчанию может содержать имя пользователя системы. Если имя пользователя Windows написано кириллицей, часть инструментов сборки может работать некорректно. Лучше заранее указать простой путь вроде
C:\Android\Sdkбез пробелов и русских букв.
Настройка переменных окружения
Для работы adb и других утилит из командной строки необходимо прописать переменные окружения. Без этого система не найдёт исполняемые файлы, а команда adb devices вернёт ошибку «не является внутренней или внешней командой».
В Windows откройте свойства системы, перейдите в Дополнительные параметры системы → Переменные среды и создайте переменную ANDROID_HOME со значением пути к SDK. Затем добавьте в переменную Path пути к каталогам platform-tools и cmdline-tools.
ANDROID_HOME = C:\Android\Sdk
Path += C:\Android\Sdk\platform-tools
Path += C:\Android\Sdk\cmdline-tools\latest\bin
После сохранения изменений перезапустите командную строку и проверьте результат командой adb version. Если выводится номер версии — настройка выполнена корректно.
Обновление и управление версиями
SDK Manager уведомляет о доступных обновлениях значком на соответствующих компонентах. Обновлять Build-Tools и Platform-Tools стоит регулярно — старые версии могут быть несовместимы с новыми плагинами Gradle.
При этом спешить с удалением предыдущих версий SDK Platforms не нужно: если в проекте указан compileSdk определённой версии, а соответствующая платформа удалена, сборка завершится ошибкой. Проверить требуемую версию можно в файле build.gradle модуля приложения.
| Компонент | Назначение | Обновлять |
|---|---|---|
| SDK Platform | API конкретной версии Android | По требованиям проекта |
| Build-Tools | Сборка APK/AAB | Регулярно |
| Platform-Tools | adb, fastboot | Регулярно |
| Emulator | Виртуальные устройства | При появлении обновлений |
| NDK | Нативный код C/C++ | Только при необходимости |
Работа с SDK из командной строки
Если графический интерфейс недоступен — например, на сервере непрерывной интеграции — используется утилита sdkmanager из пакета Command-line Tools. Она позволяет просматривать, устанавливать и удалять пакеты.
sdkmanager --list
sdkmanager "platform-tools" "platforms;android-34"
sdkmanager --licenses
Команда sdkmanager --licenses особенно важна в CI/CD-окружениях: без принятия лицензий сборка на чистой машине остановится с ошибкой. Точный список доступных пакетов и их идентификаторы имеет смысл уточнять в выводе sdkmanager --list на вашей системе, так как состав меняется от версии к версии.
Где SDK Manager хранит загруженные компоненты
Все пакеты располагаются в каталоге, указанном в поле Android SDK Location в верхней части окна SDK Manager. Внутри находятся подкаталоги platforms, build-tools, platform-tools, emulator и другие. Переносить или копировать SDK можно целиком, но после переноса путь нужно обновить в настройках IDE и в переменной ANDROID_HOME.
Типичные ошибки и их решение
Чаще всего проблемы возникают не из-за самих инструментов, а из-за конфигурации окружения или конфликтов версий. Рассмотрим частые сценарии.
- ❌ SDK location not found — проверьте файл
local.propertiesв корне проекта: строкаsdk.dirдолжна указывать на реальный каталог SDK. - ❌ License for package not accepted — выполните
sdkmanager --licensesи подтвердите все соглашения. - ❌ adb не видит устройство — убедитесь, что на смартфоне включена отладка по USB, а в Windows установлены драйверы устройства; состав драйверов зависит от производителя.
- ❌ Эмулятор не запускается — проверьте, включена ли виртуализация в BIOS/UEFI и установлен ли компонент Android Emulator hypervisor driver (для Windows).
⚠️ Внимание: не редактируйте и не удаляйте вручную содержимое каталогов
build-toolsиplatforms, пока идёт сборка проекта. Это может повредить установку, и компонент придётся переустанавливать через SDK Manager.
Если ошибка сохраняется после проверки путей и лицензий, попробуйте File → Invalidate Caches / Restart — повреждённый кэш IDE нередко маскируется под проблемы с SDK.
FAQ: частые вопросы
Чем SDK Tools отличается от SDK Platform?
SDK Platform — это ресурсы и API конкретной версии Android, под которую компилируется приложение. SDK Tools — сами инструменты (компиляторы, adb, эмулятор), которые работают независимо от версии платформы.
Можно ли установить SDK Tools без Android Studio?
Да. Google распространяет Command-line Tools отдельным архивом: его достаточно распаковать и через sdkmanager загрузить нужные пакеты. Это стандартный подход для серверов сборки.
Почему SDK Manager не показывает нужную версию компонента?
Включите флажок «Show Package Details» внизу окна. Также проверьте вкладку SDK Update Sites — возможно, источник обновлений отключён или недоступен.
Нужно ли удалять старые версии Build-Tools?
Не обязательно. Несколько версий могут сосуществовать, а некоторые проекты жёстко привязаны к конкретной. Удаляйте старые версии только если уверены, что ни один из ваших проектов их не использует.
Куда пропадает место на диске после установки SDK?
Основной объём занимают системные образы эмулятора и несколько установленных платформ. Проверить, что именно занимает место, можно, открыв каталог SDK и просмотрев размеры подкаталогов system-images, platforms и emulator.