Ошибка SDK location not found при первом запуске проекта — самый частый признак того, что Android SDK либо не установлен, либо среда разработки не знает, где он находится. Проверьте файл local.properties в корне проекта: в нём должен быть прописан путь вида sdk.dir=C:\\Users\\Имя\\AppData\\Local\\Android\\Sdk. Если строки нет или путь указывает на несуществующую папку — проблема именно в конфигурации SDK, а не в самом проекте.
SDK для Android Studio — это набор инструментов, без которых среда разработки не сможет собирать, запускать и отлаживать приложения. В комплект входят платформы для конкретных версий Android, инструменты сборки, эмулятор и системные образы. Разберём, из чего состоит SDK, как его установить, обновить и исправить типичные ошибки.
Что входит в состав Android SDK
Android SDK — это не один файл, а набор компонентов, каждый из которых решает свою задачу. Понимание структуры помогает не качать лишнее и быстро находить причину сбоев.
- 🧩 SDK Platforms — платформы для конкретных уровней API (версий Android), необходимые для компиляции проекта под выбранную версию.
- 🔧 SDK Build-Tools — инструменты сборки, которые использует Gradle при компиляции приложения.
- 📱 Android Emulator — эмулятор для запуска приложений без физического устройства.
- 💻 SDK Platform-Tools — утилиты командной строки, включая ADB и fastboot для взаимодействия с устройствами.
- 🖼️ System Images — образы системы для виртуальных устройств эмулятора.
Отдельно стоит упомянуть NDK — набор для разработки на C/C++. Он нужен не всем: обычному приложению на Kotlin или Java достаточно стандартного SDK.
Установка SDK через SDK Manager
Основной инструмент управления компонентами — SDK Manager, встроенный в Android Studio. Открыть его можно через меню File → Settings → Appearance & Behavior → System Settings → Android SDK либо по иконке на панели инструментов. В свежих версиях студии путь в настройках может незначительно отличаться — ищите раздел с названием Android SDK.
Во вкладке SDK Platforms отметьте нужные версии Android. Достаточно установить платформу, соответствующую compileSdk вашего проекта, — она указана в файле build.gradle модуля приложения. Во вкладке SDK Tools выбираются инструменты сборки, эмулятор и platform-tools.
☑️ Проверка установки Android SDK
После выбора компонентов нажмите Apply и дождитесь загрузки. Объём скачиваемых данных может быть значительным, особенно вместе с системными образами для эмулятора, поэтому заранее убедитесь в стабильности соединения и наличии свободного места на диске.
Настройка пути к SDK
Среда разработки определяет расположение SDK двумя способами: глобально — через настройки IDE, и на уровне проекта — через файл local.properties. При переносе проекта на другой компьютер или переустановке системы именно несовпадение путей вызывает ошибку SDK location not found.
Чтобы исправить путь вручную, откройте local.properties в корне проекта и укажите актуальное расположение. В Windows путь обычно выглядит так:
sdk.dir=C:\\Users\\ИмяПользователя\\AppData\\Local\\Android\\SdkОбратите внимание: обратные слэши в пути удваиваются. Альтернативный вариант — задать переменную окружения ANDROID_HOME, указывающую на папку SDK. Это удобно, если вы работаете с инструментами командной строки вне студии.
⚠️ Внимание: файлlocal.propertiesне должен попадать в систему контроля версий — пути к SDK индивидуальны для каждой машины. Убедитесь, что он добавлен в.gitignore, иначе коллеги получат конфликт путей при клонировании репозитория.
Выбор версий: какие компоненты ставить
Частый вопрос новичков — сколько платформ устанавливать. Ответ зависит от настроек проекта. В build.gradle задаются три ключевых параметра: compileSdk (версия, под которую собирается приложение), minSdk (минимальная поддерживаемая версия) и targetSdk (целевая версия).
| Компонент | Назначение | Когда обязателен |
|---|---|---|
| SDK Platform | Платформа для компиляции | Всегда — под версию compileSdk |
| Build-Tools | Инструменты сборки Gradle | Всегда |
| Platform-Tools | ADB и fastboot | Всегда |
| Emulator + System Image | Виртуальные устройства | Если нет физического устройства |
| NDK | Нативный код C/C++ | Только для проектов с нативными модулями |
Устанавливать платформы для всех версий подряд не нужно. Для сборки достаточно одной — той, что указана в compileSdk. Запуск на устройствах со старыми версиями Android обеспечивается параметром minSdk и библиотеками совместимости, а не наличием старых платформ на компьютере.
Типичные ошибки и их решение
Помимо уже упомянутой SDK location not found, разработчики регулярно встречают несколько характерных сбоев. Разберём наиболее распространённые.
Failed to find Platform SDK with path: platforms;android-XX — означает, что не установлена платформа для версии, указанной в compileSdk. Решение: открыть SDK Manager и доустановить нужную платформу либо изменить значение compileSdk на уже установленную версию.
License for package not accepted — возникает при сборке вне студии, например в CI-системах, когда не приняты лицензионные соглашения. Лицензии принимаются через утилиту sdkmanager из командной строки:
sdkmanager --licensesУтилита находится в подпапке cmdline-tools внутри каталога SDK. После запуска потребуется подтвердить каждое соглашение клавишей y.
⚠️ Внимание: если SDK Manager не загружает компоненты и выдаёт сетевые ошибки, проверьте настройки прокси в File → Settings → Appearance & Behavior → System Settings → HTTP Proxy. В корпоративных сетях без указания прокси загрузка часто невозможна.
Куда SDK Manager сохраняет компоненты
Все загруженные пакеты складываются в корневую папку SDK: платформы — в подкаталог platforms, инструменты сборки — в build-tools, утилиты ADB — в platform-tools, образы эмулятора — в system-images. Зная эту структуру, можно вручную проверить, что именно установлено, и удалить ненужное для экономии места.
Обновление и очистка SDK
Со временем папка SDK разрастается: накапливаются старые платформы, неиспользуемые образы эмуляторов и устаревшие версии Build-Tools. Периодическая чистка освобождает заметный объём диска.
Удаление выполняется через тот же SDK Manager: снимите галочки с ненужных компонентов и нажмите Apply. Перед удалением убедитесь, что компонент не используется ни одним из ваших проектов — проверьте значения compileSdk и версии Build-Tools в файлах build.gradle.
Обновления, наоборот, стоит устанавливать регулярно: свежие версии Platform-Tools и Build-Tools содержат исправления ошибок и поддержку новых устройств. Android Studio сама уведомляет о доступных обновлениях компонентов.
SDK без Android Studio: командная строка
Для серверов сборки и автоматизации полная IDE не обязательна. Google предоставляет отдельный пакет command line tools, который позволяет управлять SDK без графического интерфейса. После распаковки доступны утилиты sdkmanager для установки пакетов и avdmanager для создания виртуальных устройств.
Пример установки платформы и инструментов сборки из терминала:
sdkmanager "platforms;android-34" "build-tools;34.0.0"Точные идентификаторы доступных пакетов выводятся командой sdkmanager --list. Версии в примере приведены для иллюстрации — перед установкой проверьте актуальный список.
Часто задаваемые вопросы
Куда по умолчанию устанавливается Android SDK в Windows?
Стандартный путь — C:\Users\ИмяПользователя\AppData\Local\Android\Sdk. Папка AppData скрыта, поэтому включите отображение скрытых файлов в проводнике или введите путь напрямую в адресной строке. Текущее расположение всегда можно посмотреть в окне SDK Manager в поле Android SDK Location.
Можно ли перенести папку SDK на другой диск?
Да. Скопируйте папку целиком в новое место, затем укажите новый путь в SDK Manager и обновите sdk.dir в файле local.properties каждого проекта либо переменную окружения ANDROID_HOME. После переноса рекомендуется перезапустить студию и выполнить синхронизацию проекта с Gradle.
Чем SDK отличается от JDK?
JDK (Java Development Kit) — инструментарий для языка Java, а Android SDK — набор платформ, библиотек и утилит именно для Android-разработки. Android Studio поставляется со встроенной JDK, поэтому отдельно её устанавливать обычно не требуется, а вот SDK без студии работать не будет.
Почему Gradle требует версию платформы, которой нет в SDK Manager?
Возможная причина — в проекте указана слишком новая или, наоборот, устаревшая версия compileSdk, недоступная в вашей версии SDK Manager. Обновите Android Studio и сам SDK Manager: старые версии среды могут не отображать свежие платформы. Либо измените compileSdk на версию, доступную для установки.
Нужно ли устанавливать NDK для обычного приложения на Kotlin?
Нет. NDK требуется только для проектов с модулями на C/C++ или при использовании библиотек, содержащих нативный код, который нужно собирать из исходников. Для типичного приложения на Kotlin или Java достаточно стандартного набора: платформа, Build-Tools и Platform-Tools.