Ошибка «SDK location not found» при первом запуске Android Studio почти всегда означает одно: среда разработки установлена, а Android SDK — набор инструментов, без которого невозможно скомпилировать и запустить приложение — либо отсутствует, либо лежит по пути, который IDE не видит. Проверить это можно за минуту: откройте File → Settings → Appearance & Behavior → System Settings → Android SDK и посмотрите, указан ли путь в поле Android SDK Location и не пуст ли список платформ.
Если поле пустое или рядом с компонентами стоит статус «Not installed», дальше в статье — полный разбор: что входит в SDK, как установить нужные компоненты, как настроить переменные окружения и что делать с типичными ошибками вроде непринятых лицензий.
Что такое Android SDK и зачем он нужен Android Studio
Android SDK (Software Development Kit) — это комплект инструментов разработчика от Google: библиотеки платформы, компиляторы, эмуляторы и утилиты командной строки. Сама Android Studio — это лишь среда разработки (редактор кода, отладчик, дизайнер интерфейсов), которая обращается к SDK для сборки и запуска приложений.
Без SDK среда не сможет ни собрать проект в APK или AAB, ни запустить его на эмуляторе, ни подключиться к реальному устройству через ADB. При этом SDK не является монолитом: он состоит из отдельных пакетов, которые ставятся и обновляются независимо друг от друга через встроенный менеджер.
Важно понимать разницу между двумя понятиями: SDK Platform — это файлы конкретной версии Android (например, Android 14, API 34), а SDK Tools — вспомогательные инструменты, общие для всех версий. Для сборки проекта под конкретную версию системы нужна соответствующая платформа.
Состав Android SDK: основные компоненты
Знать состав SDK полезно хотя бы для того, чтобы не устанавливать лишнее — полный набор пакетов занимает десятки гигабайтов. Вот ключевые компоненты, которые отображаются в SDK Manager:
- 🧩 Android SDK Platform — платформа конкретной версии Android, обязательна для компиляции под неё;
- 🛠️ Android SDK Build-Tools — утилиты сборки (d8, AAPT2 и другие), версия указывается в
build.gradle; - 📱 Android Emulator — эмулятор для запуска виртуальных устройств;
- 💾 System Images — образы системы для эмулятора (x86_64 или ARM);
- 🔌 Android SDK Platform-Tools — ADB, fastboot и другие утилиты для работы с устройствами;
- 📦 NDK и CMake — нужны только для проектов с нативным кодом на C/C++.
Для обычного проекта на Kotlin или Java достаточно платформы нужной версии, Build-Tools, Platform-Tools и, если планируется тестирование без физического устройства, эмулятора с системным образом. NDK и документацию можно не ставить — они понадобятся лишь в специфических сценариях.
Установка Android SDK через SDK Manager
Стандартный путь — установка через SDK Manager, встроенный в Android Studio. Открыть его можно двумя способами: через меню Tools → SDK Manager или через значок менеджера на панели инструментов. На стартовом экране среды (без открытого проекта) путь такой: More Actions → SDK Manager.
В окне менеджера две основные вкладки. На вкладке SDK Platforms отметьте версии Android, под которые собираетесь разрабатывать — обычно это актуальная версия плюс одна-две предыдущие, если проект должен их поддерживать. На вкладке SDK Tools отметьте Android SDK Build-Tools, Android Emulator, Android SDK Platform-Tools. Нажмите Apply и дождитесь загрузки.
☑️ Проверка готовности SDK к работе
По умолчанию SDK ставится в профиль пользователя: на Windows это обычно C:\Users\Имя\AppData\Local\Android\Sdk, на macOS — ~/Library/Android/sdk, на Linux — ~/Android/Sdk. Изменить путь можно в том же окне, в поле Android SDK Location.
⚠️ Внимание: избегайте кириллицы и пробелов в пути к SDK. Если имя пользователя Windows написано русскими буквами, перенесите SDK в папку вроде C:\Android\Sdk — иначе возможны сбои сборки и проблемы с NDK.
Установка через командную строку
Для серверов сборки (CI) и автоматизации SDK ставят без графического интерфейса — через утилиту sdkmanager, входящую в пакет command-line tools. Их можно скачать отдельно со страницы загрузки Android Studio на официальном сайте разработчиков Android.
Пример установки базового набора компонентов:
sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"Перед первой сборкой необходимо принять лицензионные соглашения, иначе Gradle остановится с соответствующей ошибкой. Делается это командой:
sdkmanager --licensesНа каждый запрос нужно ответить y. Эта процедура — частая причина падения сборок на свеженастроенных машинах: SDK вроде бы установлен, но лицензии не приняты.
Настройка переменных окружения
Чтобы утилиты SDK — в первую очередь ADB — были доступны из любого терминала, а сторонние инструменты могли найти SDK автоматически, настраивают переменные окружения. Основная из них — ANDROID_HOME, указывающая на корневую папку SDK.
На Windows переменные задаются через Система → Дополнительные параметры системы → Переменные среды. Создайте переменную ANDROID_HOME со значением пути к SDK, а в Path добавьте подкаталоги platform-tools и, при необходимости, cmdline-tools. На macOS и Linux аналогичные строки добавляют в ~/.bashrc или ~/.zshrc:
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools
Проверить результат просто: откройте новый терминал и выполните adb version. Если выводится версия утилиты — настройка завершена. Если система отвечает «команда не найдена», перепроверьте пути и перезапустите терминал.
Типичные ошибки и их решение
Большинство проблем с SDK сводится к нескольким повторяющимся сценариям. Ниже — таблица с диагностикой.
| Ошибка / симптом | Вероятная причина | Что делать |
|---|---|---|
| SDK location not found | Не задан путь к SDK | Указать путь в настройках или в local.properties |
| Failed to install licenses | Лицензии не приняты | Выполнить sdkmanager --licenses |
| Эмулятор не запускается | Нет системного образа или виртуализация отключена | Установить System Image, включить виртуализацию в BIOS/UEFI |
| ADB не видит устройство | Не включена отладка по USB или нет драйвера | Включить отладку в настройках разработчика, проверить драйвер |
| Gradle требует другую версию Build-Tools | Несовпадение версий в проекте | Установить требуемую версию через SDK Manager |
Отдельно стоит упомянуть файл local.properties в корне проекта: именно в нём Gradle ищет строку sdk.dir=.... Этот файл не коммитят в систему контроля версий — путь у каждого разработчика свой. Если проект скачан из репозитория, Android Studio обычно создаёт файл автоматически при первом открытии.
⚠️ Внимание: если эмулятор на Windows вылетает сразу после старта, проверьте, включена ли аппаратная виртуализация (Intel VT-x или AMD-V) в BIOS/UEFI и не конфликтует ли Hyper-V с выбранным движком эмуляции. Конкретные пункты меню BIOS зависят от производителя материнской платы.
Как уменьшить объём SDK на диске
Удалите неиспользуемые платформы старых версий Android и неактуальные системные образы эмулятора — каждый образ занимает заметное место. Также можно очистить кэш загрузок SDK Manager и старые версии Build-Tools, оставив только те, что указаны в build.gradle ваших проектов.
Обновление SDK и обратная совместимость
Обновлять компоненты следует через тот же SDK Manager — он показывает доступные обновления рядом с установленными пакетами. Platform-Tools и эмулятор обновлять стоит регулярно: они обратно совместимы со старыми проектами.
С платформами и Build-Tools ситуация тоньше. Если проект собирается под конкретный compileSdk, установка новой платформы сама по себе ничего не сломает — но и не изменит поведение сборки, пока вы не обновите значения в build.gradle. Стабильную связку «версия Gradle плагина — версия Android Studio — версия Build-Tools» лучше менять осознанно, проверяя сборку после каждого шага.
Перед крупным обновлением среды имеет смысл зафиксировать текущее состояние: какие платформы установлены и какие версии инструментов используются в проектах. Это упростит откат, если что-то пойдёт не так.
⚠️ Внимание: не удаляйте платформу, пока хотя бы один активный проект собирается под неё. Gradle остановит сборку с ошибкой отсутствующей платформы, и придётся либо ставить её заново, либо менять compileSdk в проекте.
Часто задаваемые вопросы
Можно ли установить Android SDK без Android Studio?
Да. Google распространяет command-line tools отдельным архивом. После распаковки утилита sdkmanager позволяет установить платформы, Build-Tools и Platform-Tools без графической среды. Такой вариант типичен для серверов непрерывной интеграции.
Сколько места занимает Android SDK?
Точный объём зависит от набора компонентов. Минимальная конфигурация с одной платформой занимает несколько гигабайт; каждый системный образ эмулятора добавляет ещё заметный объём. Полная установка со множеством платформ и образов может занять десятки гигабайт, поэтому лишние пакеты лучше не ставить.
Где Android Studio хранит SDK по умолчанию?
На Windows — в папке пользователя: %LOCALAPPDATA%\Android\Sdk. На macOS — ~/Library/Android/sdk, на Linux — ~/Android/Sdk. Текущий путь всегда виден в настройках среды на странице Android SDK.
Нужно ли устанавливать NDK для обычного приложения?
Нет. NDK требуется только для проектов с кодом на C или C++ — например, игр на нативном движке или библиотек обработки медиа. Для приложений на Kotlin или Java достаточно стандартного набора SDK.
Что делать, если SDK Manager не скачивает пакеты?
Проверьте подключение к интернету и настройки прокси в File → Settings → Appearance & Behavior → System Settings → HTTP Proxy. Если используется корпоративная сеть, возможно, потребуется указать прокси-сервер. В отдельных регионах загрузка с серверов Google может быть ограничена — тогда помогает зеркало репозитория или VPN, выбор конкретного решения зависит от вашей сетевой среды.