Ошибка «SDK location not found» при сборке проекта в Android Studio почти всегда означает одно: среда разработки не может определить, где находится Android SDK, и путь нужно указать вручную. По умолчанию в Windows комплект разработчика устанавливается в папку C:\Users\Имя_пользователя\AppData\Local\Android\Sdk, но при нестандартной установке каталог может оказаться в другом месте.
В этой статье разберём стандартные пути установки Android SDK для всех популярных операционных систем, способы быстро найти папку через Android Studio, настройку переменной окружения ANDROID_HOME и решение типичных ошибок, связанных с расположением SDK.
Стандартные пути установки Android SDK
Местоположение SDK зависит от операционной системы и от того, меняли ли вы путь при установке Android Studio. Ниже приведены каталоги, которые установщик предлагает по умолчанию.
| Операционная система | Путь по умолчанию |
|---|---|
| Windows 10/11 | C:\Users\Имя\AppData\Local\Android\Sdk |
| macOS | /Users/Имя/Library/Android/sdk |
| Linux | /home/Имя/Android/Sdk |
| Windows (установка для всех пользователей) | путь выбирается вручную при установке |
Обратите внимание: папка AppData в Windows является скрытой. Чтобы увидеть её в Проводнике, включите отображение скрытых элементов на вкладке Вид или вставьте путь напрямую в адресную строку. В macOS каталог Library тоже скрыт — открыть его можно через меню Переход → Переход к папке в Finder.
⚠️ Внимание: не перемещайте и не переименовывайте папку SDK вручную после установки. Android Studio хранит абсолютный путь в конфигурации, и после переноса каталога среда перестанет находить инструменты сборки, эмуляторы и платформы.
Как узнать путь к SDK через Android Studio
Самый надёжный способ выяснить, где находится Android SDK именно на вашем компьютере, — посмотреть в настройках самой среды разработки. Этот метод не зависит от операционной системы и работает даже при нестандартной установке.
- 📂 Откройте
File → Settings(в macOS —Android Studio → Preferences). - 🧭 Перейдите в раздел
Appearance & Behavior → System Settings → Android SDK. - 📍 В верхней части окна найдите поле
Android SDK Location— там указан полный путь. - ✏️ При необходимости нажмите
Edit, чтобы изменить расположение.
Ещё один способ — открыть файл local.properties в корне любого Android-проекта. Строка вида sdk.dir=C:\\Users\\Имя\\AppData\\Local\\Android\\Sdk показывает, откуда проект берёт SDK. Этот файл создаётся автоматически и не должен попадать в систему контроля версий, так как путь индивидуален для каждой машины.
Поиск SDK через переменную окружения ANDROID_HOME
Многие инструменты командной строки — Gradle, Flutter, React Native CLI — определяют расположение SDK по переменной окружения ANDROID_HOME. Если она задана, проверить путь можно одной командой.
В Windows откройте командную строку или PowerShell и выполните:
echo %ANDROID_HOME%В macOS и Linux команда выглядит так:
echo $ANDROID_HOMEЕсли команда выводит пустую строку, переменная не настроена. В этом случае инструменты вроде Flutter могут выдавать ошибку Unable to locate Android SDK даже при корректно установленном SDK — система просто не знает, где его искать.
Настройка ANDROID_HOME вручную
Чтобы инструменты командной строки всегда находили SDK, задайте переменную окружения и добавьте нужные подкаталоги в PATH. В Windows это делается через Система → Дополнительные параметры системы → Переменные среды: создайте переменную ANDROID_HOME со значением пути к SDK, а в Path добавьте записи для platform-tools и cmdline-tools.
В macOS и Linux переменные обычно прописывают в файле ~/.bashrc, ~/.zshrc или ~/.profile. Пример для macOS:
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools
☑️ Проверка корректной настройки SDK
⚠️ Внимание: указывайте в
ANDROID_HOMEкорневую папку SDK, а не подкаталоги вродеplatform-tools. Неверный уровень вложенности — частая причина того, что adb и другие утилиты не находятся системой.
Что находится внутри папки SDK
Понимание структуры каталога помогает убедиться, что вы нашли именно SDK, а не похожую папку. Внутри корневого каталога располагаются подпапки с отдельными компонентами.
- 🛠️
platform-tools— утилиты adb и fastboot для работы с устройствами. - 📦
platforms— пакеты платформ Android для разных версий API. - 🧰
build-tools— инструменты компиляции и сборки APK/AAB. - 📱
emulatorиsystem-images— эмулятор и образы систем для него. - ⚙️
cmdline-tools— менеджер пакетов sdkmanager для установки компонентов из терминала.
Если каких-то подпапок нет, это не обязательно проблема: компоненты устанавливаются по мере необходимости через SDK Manager в Android Studio. Отсутствует, например, system-images, если вы ни разу не создавали эмулятор.
Как установить недостающие компоненты
Откройте в Android Studio раздел Tools → SDK Manager. На вкладке SDK Platforms выберите нужные версии Android, на вкладке SDK Tools — инструменты вроде Build-Tools и Command-line Tools, затем нажмите Apply и дождитесь загрузки.
Типичные проблемы с расположением SDK и их решение
Ошибка «SDK location not found. Define location with sdk.dir in the local.properties file or with an ANDROID_HOME environment variable» возникает, когда Gradle не находит ни файл local.properties, ни переменную окружения. Решение — создать local.properties в корне проекта с корректным sdk.dir либо настроить ANDROID_HOME, как описано выше.
Другая ситуация — после переустановки Windows или переноса системы на другой диск SDK оказался в нестандартном месте. Вам нужно просто указать новый путь в настройках Android Studio через Android SDK Location → Edit; заново скачивать весь комплект не обязательно, если папка сохранилась.
Если в пути к SDK есть кириллические символы или пробелы в имени пользователя Windows, часть старых инструментов сборки может работать некорректно — в таком случае надёжнее установить SDK в каталог с латинским именем, например C:\Android\Sdk, и обновить путь в настройках.
FAQ: частые вопросы о расположении Android SDK
Можно ли установить Android SDK без Android Studio?
Да. Google распространяет Command Line Tools отдельным архивом: после распаковки через утилиту sdkmanager можно установить платформы и build-tools. Папку размещения вы выбираете сами, а затем прописываете её в ANDROID_HOME.
Почему папка AppData не видна в Проводнике Windows?
Каталог AppData скрыт по умолчанию. Включите показ скрытых элементов: в Проводнике откройте вкладку Вид и отметьте пункт Скрытые элементы. Либо вставьте полный путь в адресную строку — переход сработает и без изменения настроек отображения.
Чем отличаются ANDROID_HOME и ANDROID_SDK_ROOT?
Обе переменные указывают на папку SDK. ANDROID_SDK_ROOT считается более актуальным вариантом, но ANDROID_HOME по-прежнему широко поддерживается инструментами. При конфликте значений поведение зависит от конкретной утилиты, поэтому безопаснее задавать обе переменные с одинаковым путём.
Можно ли хранить SDK на внешнем диске?
Технически да — укажите путь к диску при установке или в настройках Android Studio. Учтите, что сборка проектов и запуск эмулятора будут заметно медленнее, чем с SSD, а при отключении диска среда потеряет доступ к инструментам.
Flutter не видит SDK, хотя Android Studio работает. Что делать?
Flutter ищет SDK по переменной окружения, а не по настройкам Android Studio. Проверьте вывод команды flutter doctor: если SDK не найден, задайте ANDROID_HOME и перезапустите терминал. Также можно явно указать путь командой flutter config --android-sdk путь_к_sdk.