Ошибка SDK location not found при первом запуске Android Studio — один из самых частых поводов, по которому разработчики ищут помощь сразу после установки среды. Причина почти всегда одна: IDE не находит путь к Android SDK, потому что он не был указан при установке или был перемещён вручную. Лечится указанием пути в настройках File → Project Structure → SDK Location либо в файле local.properties проекта.
Android Studio — официальная среда разработки от Google для создания приложений под Android. Она построена на базе IntelliJ IDEA от JetBrains и включает редактор кода, визуальный конструктор интерфейсов, эмулятор устройств, профилировщик и систему сборки Gradle. Ниже — подробный разбор установки, настройки и типовых проблем.
Системные требования и подготовка
Перед установкой стоит убедиться, что компьютер соответствует минимальным требованиям. Android Studio — ресурсоёмкая среда: комфортная работа требует не менее 8 ГБ оперативной памяти, а для запуска эмулятора параллельно с IDE лучше иметь 16 ГБ. Также понадобится несколько гигабайт свободного места на диске — сама IDE, SDK, системные образы эмулятора и кэш Gradle суммарно занимают заметный объём, и со временем он только растёт.
Важный момент — аппаратная виртуализация. Без включённой виртуализации (Intel VT-x или AMD-V) в BIOS/UEFI эмулятор Android будет либо работать крайне медленно, либо не запустится вовсе. На Windows дополнительно используется компонент Android Emulator hypervisor driver или Hyper-V — в зависимости от конфигурации системы.
- 💻 ОЗУ: минимум 8 ГБ, рекомендуется 16 ГБ для работы с эмулятором.
- 💾 Диск: желательно SSD — сборка проектов на HDD заметно медленнее.
- ⚙️ Виртуализация: включите VT-x/AMD-V в BIOS перед установкой эмулятора.
- 🖥️ ОС: поддерживаются актуальные версии Windows, macOS и Linux.
⚠️ Внимание: не устанавливайте Android Studio и SDK в пути, содержащие кириллицу или пробелы в именах папок (например, в
C:\Users\Иван\...). Это регулярно вызывает сбои сборки Gradle и ошибки NDK. Используйте путь только с латинскими символами.
Установка Android Studio и SDK
Загрузите установщик только с официального сайта разработчиков Android — сторонние источники могут содержать устаревшие или модифицированные сборки. Процесс установки стандартный: мастер предложит выбрать компоненты, среди которых сама IDE, Android SDK, Android Virtual Device и инструменты командной строки. Оставляйте все компоненты отмеченными, если устанавливаете среду впервые.
При первом запуске среда предложит импортировать настройки (для чистой установки выбирайте «Do not import settings») и запустит Setup Wizard. В нём выбирайте тип установки Standard — мастер автоматически скачает актуальную платформу SDK, build-tools и системный образ для эмулятора. Загрузка может занять продолжительное время в зависимости от скорости соединения.
☑️ Проверка после установки
Если мастер завершился, но что-то не докачалось, откройте Tools → SDK Manager и вручную установите недостающие пакеты: платформу нужного API-уровня, Android SDK Build-Tools, Platform-Tools (там находится adb) и Android Emulator.
Создание первого проекта и структура IDE
Новый проект создаётся через File → New → New Project. Мастер предложит шаблоны: Empty Activity, Bottom Navigation Activity и другие. Для знакомства со средой подойдёт Empty Views Activity — минимальный рабочий шаблон без лишнего кода. На следующем шаге укажите имя приложения, пакет (например, com.example.myapp), язык — Kotlin является рекомендуемым Google языком для Android — и минимальную версию SDK.
Выбор minSdkVersion определяет, на каких устройствах приложение сможет работать. Чем ниже минимальная версия, тем шире охват устройств, но тем больше ограничений при использовании современных API. Мастер показывает примерный процент поддерживаемых устройств прямо в окне выбора.
После создания проекта запустится первая синхронизация Gradle — среда скачает зависимости и настроит сборку. Это может занять несколько минут. Не прерывайте процесс: повторная синхронизация после сбоя иногда приводит к повреждению кэша, который придётся чистить вручную.
Настройка эмулятора (AVD)
Эмулятор создаётся через Tools → Device Manager → кнопка создания виртуального устройства. Выберите модель (например, Pixel среднего класса), затем системный образ. Образы с пометкой Google Play включают магазин приложений, образы Google APIs — только сервисы Google без Play Market. Если Play Market не нужен, второй вариант обычно работает легче.
Для слабых машин есть разумные уступки: уменьшите выделяемый объём RAM виртуального устройства, выберите образ с более старой версией Android и разрешением экрана попроще. Альтернатива эмулятору — подключение реального смартфона по USB с включённой отладкой по USB в настройках разработчика телефона. На реальном устройстве приложение работает быстрее и честнее показывает производительность.
Типичные ошибки и их решение
Большинство проблем у новичков связано не с кодом, а с окружением: Gradle, SDK, эмулятором. Ниже — самые частые сценарии и проверенные способы их устранения.
| Ошибка / симптом | Вероятная причина | Что делать |
|---|---|---|
| SDK location not found | Не указан путь к SDK | Прописать путь в local.properties или настройках проекта |
| Gradle sync failed | Нет сети, битый кэш, несовместимость версий | Проверить интернет, File → Invalidate Caches, синхронизировать заново |
| Эмулятор не запускается | Отключена виртуализация, конфликт гипервизоров | Включить VT-x/AMD-V в BIOS, проверить компоненты Windows |
| Медленная сборка | Мало RAM, HDD вместо SSD, антивирус сканирует папки проекта | Добавить папки проекта в исключения антивируса, перенести проект на SSD |
| adb не видит устройство | Не включена отладка по USB, нет драйвера | Включить отладку, установить USB-драйвер производителя (Windows) |
⚠️ Внимание: команда
gradlew cleanи очистка кэша черезFile → Invalidate Caches / Restartбезопасны, но не удаляйте вручную папки.gradleиbuild, пока IDE запущена и идёт синхронизация — это может привести к повреждению проекта.
Как ускорить Gradle-сборку
Откройте файл gradle.properties в корне проекта и увеличьте выделяемую память для демона Gradle (параметр org.gradle.jvmargs), а также убедитесь, что включён org.gradle.parallel и кэширование сборки. Точные значения подбирайте под объём RAM вашей машины — слишком большие значения не ускорят, а замедлят работу.
Если Gradle сообщает о несовместимости версий, проверьте соответствие трёх компонентов: версии Android Gradle Plugin (в файле build.gradle уровня проекта), версии Gradle (в gradle-wrapper.properties) и версии самой Android Studio. Google публикует таблицу совместимости этих компонентов в официальной документации — сверяйтесь с ней при обновлениях.
Обновление среды и SDK
Android Studio сама предлагает обновления через встроенный механизм — уведомление появляется в правом нижнем углу. Обновляться стоит через стабильный канал (Stable), если вы не готовы мириться с багами бета-версий. Перед мажорным обновлением имеет смысл дождаться завершения текущих задач: новые версии IDE иногда требуют обновления Gradle-плагина в проектах.
Компоненты SDK обновляются отдельно — через Tools → SDK Manager. Здесь же удаляются ненужные платформы и старые системные образы, которые со временем съедают десятки гигабайт. Периодическая чистка SDK Manager от неиспользуемых образов — самый простой способ вернуть место на диске без переустановки среды.
FAQ: частые вопросы
Можно ли пользоваться Android Studio бесплатно?
Да, Android Studio полностью бесплатна, включая эмулятор и все инструменты SDK. Это официальная среда разработки от Google, распространяемая без лицензионных платежей.
Почему эмулятор работает очень медленно?
Наиболее вероятные причины: отключена аппаратная виртуализация в BIOS/UEFI, недостаточно оперативной памяти или выбран слишком тяжёлый системный образ. Проверьте включение VT-x/AMD-V, уменьшите RAM виртуального устройства или используйте реальный смартфон с отладкой по USB.
Нужно ли отдельно устанавливать Java (JDK)?
Нет, современные версии Android Studio поставляются со встроенным JDK, который используется по умолчанию. Отдельная установка Java требуется только в особых сценариях — например, для работы с legacy-проектами.
Чем Android Studio отличается от IntelliJ IDEA?
Android Studio построена на платформе IntelliJ IDEA, но специализирована исключительно на Android: включает SDK Manager, эмулятор, профилировщик Android и конструктор макетов. Для Android-разработки отдельная IntelliJ IDEA не нужна.
Где находится папка SDK по умолчанию?
Расположение зависит от операционной системы и настроек при установке. Точный текущий путь всегда можно посмотреть в самой среде: File → Settings → раздел Android SDK, поле Android SDK Location.