Ошибка «SDK location not found» при первом запуске Android Studio или сборке проекта в Gradle почти всегда означает одно: среда разработки не может найти папку, куда был установлен Android SDK. Путь к этому каталогу прописывается в файле local.properties проекта и в переменной окружения ANDROID_HOME, и если он указан неверно, сборка останавливается ещё до компиляции кода.
В этой статье разберём, куда устанавливается SDK по умолчанию на разных операционных системах, как быстро определить фактический путь через настройки Android Studio, как изменить расположение папки и что делать, если SDK не находится по стандартному адресу. Отдельно рассмотрим структуру каталога SDK, чтобы вы понимали, какие компоненты где лежат.
Пути установки Android SDK по умолчанию
Место установки зависит от операционной системы и от того, как именно ставился SDK — вместе с Android Studio или отдельно. Стандартные пути выглядят так:
- 🪟 Windows:
C:\Users\ИмяПользователя\AppData\Local\Android\Sdk - 🍎 macOS:
/Users/ИмяПользователя/Library/Android/sdk - 🐧 Linux:
/home/ИмяПользователя/Android/Sdk - 📦 При выборочной установке путь может быть любым — он задаётся в мастере установки Android Studio на шаге выбора компонентов.
Обратите внимание: на Windows папка AppData скрытая. Чтобы увидеть её в Проводнике, включите отображение скрытых элементов на вкладке «Вид» или вставьте путь напрямую в адресную строку. На macOS каталог Library тоже скрыт — открыть его можно через меню «Переход» в Finder с зажатой клавишей Option.
Как узнать, куда установлен SDK, через Android Studio
Самый надёжный способ — посмотреть путь в настройках самой среды разработки. Android Studio всегда показывает актуальное расположение SDK, которое она использует.
- Откройте Android Studio и перейдите в
File → Settings(на macOS —Android Studio → Preferences). - В дереве слева выберите
Languages & Frameworks → Android SDK. - В верхней части окна найдите поле Android SDK Location — это и есть текущий путь.
☑️ Проверка расположения SDK
Если поле пустое или путь подсвечен красным — SDK либо не установлен, либо был перемещён или удалён. В этом случае нажмите Edit рядом с полем и укажите существующую папку, либо запустите мастер загрузки SDK заново.
⚠️ Внимание: путь к SDK не должен содержать кириллицу и пробелы — это частая причина сбоев у пользователей Windows, чьё имя учётной записи написано русскими буквами. Если имя пользователя кириллическое, перенесите SDK, например, в C:\Android\Sdk.
Структура папки SDK: что где лежит
Понимание структуры каталога помогает быстро проверить, установлены ли нужные компоненты. Внутри папки SDK находятся следующие ключевые подкаталоги:
| Подкаталог | Назначение |
|---|---|
platforms | Платформы Android для каждого уровня API |
build-tools | Инструменты сборки (компиляторы ресурсов, dex и др.) |
platform-tools | Утилиты adb и fastboot |
emulator | Эмулятор Android-устройств |
cmdline-tools | Менеджер пакетов sdkmanager для командной строки |
Если папки platform-tools нет, команда adb работать не будет — её нужно доустановить через SDK Manager на вкладке SDK Tools. Аналогично, без каталога platforms с нужным уровнем API проект не соберётся.
Как изменить папку установки SDK
Иногда SDK нужно перенести: на другой диск из-за нехватки места, в папку без кириллицы в пути или в общий каталог для нескольких инструментов. Сделать это можно двумя способами.
Первый способ — через настройки: откройте Settings → Android SDK, нажмите Edit возле поля Android SDK Location и укажите новый путь. Мастер предложит загрузить компоненты в новое расположение.
Второй способ — перенести существующую папку вручную и затем прописать новый путь в тех же настройках. После переноса обязательно обновите переменную окружения ANDROID_HOME и добавьте в PATH путь к platform-tools, если используете adb из командной строки.
setx ANDROID_HOME "C:\Android\Sdk"SDK не найден: типичные сценарии и решения
Если по стандартному пути папки нет, возможны несколько ситуаций. При установке Android Studio мог быть снят флажок загрузки SDK — тогда компоненты просто не скачивались, и их нужно установить через SDK Manager. Другой вариант: SDK ставился отдельным инструментом, например вместе с Flutter или через командную строку, и лежит в нестандартном месте.
⚠️ Внимание: не перемещайте папку SDK во время работы Android Studio или запущенной сборки — часть файлов может оказаться заблокированной, и каталог скопируется не полностью. Сначала закройте IDE и эмуляторы.
Для поиска SDK на диске можно воспользоваться поиском по имени характерного файла, например adb.exe (Windows) или adb (macOS/Linux) — он всегда находится в platform-tools внутри каталога SDK. Найдя файл, поднимитесь на уровень выше — это и будет корень SDK.
Где искать SDK у Flutter и других инструментов
Flutter хранит путь к SDK в своей конфигурации — проверить его можно командой flutter doctor -v, которая покажет строку Android SDK at .... React Native и другие фреймворки обычно берут путь из переменной ANDROID_HOME.
Переменные окружения: ANDROID_HOME и PATH
Многие инструменты — Gradle, Flutter, React Native CLI — определяют расположение SDK не через настройки IDE, а через системные переменные. Проверьте, что переменная ANDROID_HOME указывает на корень папки SDK, а в PATH добавлены каталоги platform-tools и cmdline-tools.
На Windows переменные задаются через Система → Дополнительные параметры системы → Переменные среды. На macOS и Linux — в файлах ~/.bashrc, ~/.zshrc или ~/.profile:
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools
После изменения переменных перезапустите терминал и IDE — запущенные процессы не подхватывают новые значения автоматически. Проверить результат можно командами adb --version и echo $ANDROID_HOME.
FAQ: частые вопросы о расположении SDK
Можно ли установить SDK без Android Studio?
Да. Для этого используются command line tools — отдельный пакет с утилитой sdkmanager, который позволяет загружать платформы и build-tools без полной IDE. Путь установки в этом случае вы выбираете сами.
Почему в папке AppData нет каталога Android?
Возможные причины: SDK устанавливался в другую папку, при установке Android Studio загрузка SDK была пропущена, либо вы смотрите в профиле другого пользователя. Определить реальный путь проще всего через настройки Android Studio.
Можно ли хранить SDK на внешнем диске?
Технически да, но при отключении диска сборка и эмулятор перестанут работать. Кроме того, скорость чтения с медленного USB-накопителя может заметно увеличить время сборки. Надёжнее держать SDK на внутреннем SSD.
Сколько места занимает Android SDK?
Объём зависит от количества установленных платформ, образов эмулятора и версий build-tools и может достигать десятков гигабайт. Ненужные компоненты можно удалить через SDK Manager, сняв соответствующие флажки.
Что делать, если Gradle не видит SDK после переноса папки?
Проверьте файл local.properties в корне проекта — в нём должен быть актуальный путь в параметре sdk.dir. Также убедитесь, что обновлена переменная ANDROID_HOME, а затем выполните синхронизацию проекта в Android Studio.