Ошибка Please select Android SDK в Android Studio появляется при открытии проекта, когда среда не может найти установленный комплект разработчика — чаще всего из-за неверного пути в файле local.properties или сброшенной настройки SDK Location после обновления IDE. Проект при этом не собирается, Gradle-синхронизация завершается сбоем, а редактор не распознаёт классы Android SDK.
Проблема почти всегда решается без переустановки среды: достаточно указать корректный путь к SDK или восстановить конфигурационный файл. Ниже разберём, почему возникает эта ошибка, как проверить установку SDK и что делать в разных сценариях — от свежей установки Android Studio до импорта чужого проекта.
Почему Android Studio не видит SDK
Среда хранит путь к SDK в двух местах: в глобальных настройках IDE и в файле local.properties внутри каждого проекта. Если эти данные противоречат друг другу или указывают на несуществующую папку, сборка останавливается с сообщением Please select Android SDK.
Типичные причины сбоя:
- 📁 Папка SDK была перемещена или переименована после установки студии.
- 🔄 Обновление Android Studio сбросило настройки, и IDE «забыла» расположение SDK.
- 📦 Проект импортирован с другого компьютера, где SDK лежал по другому пути.
- 🧩 SDK установлен не полностью — отсутствуют Platform или Build-Tools.
- 🚫 Путь содержит кириллицу или пробелы, что иногда вызывает проблемы у Gradle.
Проверка пути к SDK в настройках IDE
Сначала убедитесь, что сама среда знает, где лежит SDK. Откройте File → Settings (на macOS — Android Studio → Preferences), перейдите в раздел Languages & Frameworks → Android SDK и посмотрите поле Android SDK Location в верхней части окна.
Если поле пустое или путь подсвечен как недействительный, нажмите Edit и укажите реальную папку. По умолчанию на Windows это обычно C:\Users\Имя\AppData\Local\Android\Sdk, на macOS — ~/Library/Android/sdk, на Linux — ~/Android/Sdk. Точное расположение на вашей машине может отличаться — проверьте, что папка существует и содержит подкаталоги platforms и build-tools.
☑️ Проверка установки SDK
⚠️ Внимание: не указывайте в качестве SDK Location папку
platform-toolsилиbuild-toolsвнутри SDK — среде нужен корневой каталог, тот, что содержит эти подпапки. Неверный уровень вложенности — частая причина повторного появления ошибки.
Исправление файла local.properties
Файл local.properties лежит в корне проекта и содержит строку вида sdk.dir=.... Именно его читает Gradle при сборке. Если проект скопирован с другой машины, путь там чужой — и сборка падает, даже когда настройки IDE корректны.
Откройте файл в любом текстовом редакторе и приведите путь к актуальному виду. Пример для Windows:
sdk.dir=C:\\Users\\User\\AppData\\Local\\Android\\SdkОбратите внимание: в Windows-путях обратные слеши удваиваются, либо используются прямые слеши. На macOS и Linux путь записывается обычным образом, например sdk.dir=/Users/user/Library/Android/sdk.
Альтернативный вариант — просто удалить файл local.properties и выполнить синхронизацию проекта: Android Studio пересоздаст его автоматически с путём из текущих настроек IDE. Это безопасно, так как файл не входит в систему контроля версий и генерируется локально.
Настройка через SDK Manager
Если путь корректен, но ошибка остаётся, возможно, сам SDK установлен не полностью. Откройте Tools → SDK Manager и проверьте вкладку SDK Platforms: должна быть установлена хотя бы одна версия платформы, соответствующая compileSdk вашего проекта.
На вкладке SDK Tools убедитесь в наличии Android SDK Build-Tools, Android SDK Platform-Tools и Android SDK Command-line Tools. Отметьте недостающие компоненты и нажмите Apply — менеджер загрузит их автоматически.
После установки компонентов выполните File → Sync Project with Gradle Files. Если синхронизация снова завершается ошибкой, попробуйте File → Invalidate Caches / Restart — повреждённый кэш индексов иногда мешает среде корректно определить SDK.
Сравнение способов решения
Разные причины ошибки требуют разных действий. Таблица поможет быстро выбрать подходящий сценарий.
| Ситуация | Действие | Сложность |
|---|---|---|
| Ошибка во всех проектах | Проверить SDK Location в настройках IDE | Низкая |
| Ошибка в одном импортированном проекте | Исправить или удалить local.properties | Низкая |
| SDK не найден после обновления IDE | Заново указать путь, синхронизировать Gradle | Средняя |
| Отсутствуют платформы или инструменты | Доустановить компоненты через SDK Manager | Средняя |
| Ничего не помогает | Invalidate Caches, переустановка SDK | Высокая |
Особые случаи: переменные окружения и кириллица
Иногда Gradle берёт путь не из файла проекта, а из системной переменной окружения ANDROID_HOME (или устаревшей ANDROID_SDK_ROOT). Если переменная указывает на старое расположение SDK, сборка будет падать даже при правильных настройках IDE. Проверьте переменные окружения в свойствах системы и при необходимости обновите значение.
Отдельная история — кириллица в пути. Если имя пользователя Windows русское, путь вида C:\Users\Иван\... может вызывать сбои у отдельных инструментов сборки. Рабочее решение — установить SDK в нейтральную папку, например C:\Android\Sdk, и указать её в настройках IDE и local.properties.
⚠️ Внимание: при перемещении SDK в новую папку не забудьте обновить путь во всех трёх местах — настройки IDE, файл
local.propertiesкаждого проекта и переменная окруженияANDROID_HOME. Рассинхронизация хотя бы одного из них вернёт ошибку.
Как проверить значение ANDROID_HOME в командной строке
В Windows откройте командную строку и выполните команду echo %ANDROID_HOME%. В macOS или Linux в терминале выполните echo $ANDROID_HOME. Если вывод пустой — переменная не задана, и Gradle использует local.properties. Если путь указан и устарел — обновите переменную в системных настройках окружения.
Если ничего не помогло
Когда все пути корректны, а ошибка сохраняется, остаются более радикальные меры. Начните с File → Invalidate Caches / Restart с отмеченной опцией очистки кэшей — это устраняет повреждённые индексы.
Следующий шаг — удалить папку .idea и файлы *.iml в корне проекта, затем заново открыть проект через File → Open. Среда пересоздаст конфигурацию проекта с нуля. И только если и это не сработало, имеет смысл переустановить SDK через SDK Manager или саму Android Studio — с сохранением настроек, чтобы не потерять остальную конфигурацию.
Частые вопросы
Где Android Studio хранит SDK по умолчанию?
На Windows это обычно C:\Users\Имя\AppData\Local\Android\Sdk, на macOS — ~/Library/Android/sdk, на Linux — ~/Android/Sdk. Точный путь виден в настройках File → Settings → Android SDK в поле Android SDK Location.
Можно ли удалить local.properties?
Да, это безопасно. Файл генерируется локально и не хранится в репозитории. После удаления выполните синхронизацию Gradle — Android Studio создаст файл заново с актуальным путём к SDK.
Ошибка появляется только в одном проекте. Что делать?
Скорее всего, в этом проекте устаревший local.properties с чужим путём. Исправьте строку sdk.dir или удалите файл и синхронизируйте проект заново.
Мешает ли кириллица в пути к SDK?
Может мешать отдельным инструментам сборки. Если имя пользователя системы содержит русские буквы, надёжнее установить SDK в папку без кириллицы и пробелов, например C:\Android\Sdk, и указать её во всех настройках.
Нужна ли переустановка Android Studio при этой ошибке?
Как правило, нет. Ошибка почти всегда связана с конфигурацией путей, а не с повреждением самой среды. Переустановка — крайняя мера после проверки SDK Location, local.properties, переменных окружения и очистки кэшей.