Кнопка Run в Android Studio неактивна, а в строке состояния висит сообщение SDK not found — так обычно выглядит ситуация, когда среда разработки установлена, а Android SDK либо отсутствует, либо не прописан в настройках. Причина почти всегда одна: IDE не знает, где находится набор инструментов, без которого невозможно собрать и запустить приложение.
Установка SDK — это не отдельная загрузка стороннего файла, а работа через встроенный SDK Manager, который сам скачивает нужные компоненты с серверов Google. Ниже разберём весь процесс: от первого запуска до проверки, что всё настроено корректно, а также типичные ошибки и способы их устранения.
Что такое Android SDK и зачем он нужен
Android SDK (Software Development Kit) — это комплект инструментов, без которого невозможна разработка под Android. В него входят платформенные библиотеки для каждой версии системы, эмулятор, инструменты сборки и утилиты командной строки вроде adb.
Сама Android Studio — это лишь оболочка, редактор кода и система сборки. Вся «магия» компиляции под конкретную версию Android происходит именно средствами SDK. Поэтому даже полностью рабочая IDE без установленного SDK превращается в бесполезный текстовый редактор.
Важно понимать структуру: SDK состоит из отдельных компонентов, и не все они обязательны. Минимальный рабочий набор — это одна платформа (например, Android 14) и SDK Build-Tools. Остальное можно докачать позже по мере необходимости.
Подготовка: что проверить перед установкой
Прежде чем открывать SDK Manager, убедитесь, что базовые условия выполнены. Это избавит от большинства ошибок на этапе загрузки.
- 💾 Свободное место на диске. Полный набор SDK с несколькими платформами и образами эмулятора может занимать десятки гигабайт. Заранее освободите место на системном диске или подготовьте отдельный раздел.
- 🌐 Стабильное интернет-соединение. Компоненты скачиваются с серверов Google, обрыв соединения приводит к повреждённым пакетам.
- ☕ JDK. Современные версии Android Studio поставляются со встроенной JetBrains Runtime, поэтому отдельная установка Java обычно не требуется.
- 🛡️ Антивирус и брандмауэр. Иногда они блокируют загрузку компонентов — при проблемах временно добавьте Android Studio в исключения.
⚠️ Внимание: путь к SDK не должен содержать кириллицу и пробелы. Папка видаC:\Users\Иван\AppData\...— частая причина странных ошибок сборки. Лучше использовать латинское имя пользователя или задать отдельный путь вродеC:\Android\Sdk.
Установка SDK при первом запуске Android Studio
Самый простой сценарий — установка во время первого запуска IDE. Мастер настройки (Setup Wizard) сам предложит скачать необходимые компоненты.
После запуска выберите тип установки: Standard или Custom. Стандартный вариант подходит большинству — мастер загрузит последнюю стабильную платформу, эмулятор и инструменты сборки с настройками по умолчанию. Вариант Custom позволяет выбрать папку установки SDK и отказаться от лишних компонентов, что полезно при ограниченном месте на диске.
Дождитесь окончания загрузки — она может занять заметное время в зависимости от скорости соединения. Прерывать процесс не стоит: недокачанные пакеты придётся удалять и ставить заново.
☑️ Установка SDK через мастер первого запуска
Установка и обновление компонентов через SDK Manager
Если Android Studio уже установлена, управление SDK выполняется через SDK Manager. Открыть его можно двумя способами: с welcome-экрана через More Actions → SDK Manager или из открытого проекта через меню File → Settings → Appearance & Behavior → System Settings → Android SDK (на macOS путь начинается с Android Studio → Preferences).
Окно SDK Manager содержит три вкладки, каждая отвечает за свою категорию компонентов:
- 📱 SDK Platforms — платформы для конкретных версий Android. Отметьте те версии, под которые планируете собирать приложения.
- 🛠️ SDK Tools — инструменты: Android SDK Build-Tools, Platform-Tools (включает adb), эмулятор, NDK для нативного кода.
- 🔄 SDK Update Sites — источники обновлений, менять их обычно не требуется.
Отметьте нужные пункты галочками и нажмите Apply, затем подтвердите загрузку кнопкой OK. Менеджер покажет список изменений и лицензионные соглашения — их нужно принять для каждого пакета.
Какие компоненты SDK ставить в первую очередь
Не обязательно скачивать всё подряд — это лишний трафик и место на диске. Для старта достаточно минимального набора, остальное добавляется по мере роста проекта.
| Компонент | Назначение | Обязательность |
|---|---|---|
| Android SDK Platform | Библиотеки конкретной версии Android | Обязательно (минимум одна) |
| Android SDK Build-Tools | Инструменты компиляции проекта | Обязательно |
| Android SDK Platform-Tools | Утилиты adb и fastboot | Обязательно |
| Android Emulator | Запуск виртуальных устройств | Нужен, если нет реального устройства |
| NDK (Side by side) | Сборка нативного C/C++ кода | Только для проектов с нативным кодом |
Какую платформу выбрать? Ориентируйтесь на параметр compileSdk в файле build.gradle вашего проекта — IDE сама подскажет, какой версии не хватает, и предложит установить её одним кликом по ссылке в сообщении об ошибке.
⚠️ Внимание: не удаляйте Platform-Tools, если пользуетесь отладкой по USB — без adb Android Studio не увидит ни одно подключённое устройство, и отладка на реальном смартфоне станет невозможной.
Что делать, если проект требует старую версию SDK
Откройте SDK Manager, включите Show Package Details на вкладке SDK Platforms, разверните нужную версию Android и отметьте её. Если в build.gradle указан старый compileSdk, Gradle при синхронизации покажет ссылку Install missing platform — нажмите её, и нужная версия установится автоматически.
Настройка пути к SDK и переменных среды
Иногда SDK установлен, но среда его «не видит» — например, после переустановки системы или переноса папки. В этом случае путь задаётся вручную: откройте File → Settings → Android SDK и в поле Android SDK Location укажите актуальную папку.
Для работы утилит из командной строки (например, adb вне Android Studio) полезно настроить переменные окружения. В Windows это делается через Система → Дополнительные параметры системы → Переменные среды:
- ⚙️ Создайте переменную
ANDROID_HOMEсо значением — путём к папке SDK. - 📂 Добавьте в
Pathпути к подпапкамplatform-toolsиcmdline-tools.
После изменения переменных перезапустите терминал (а лучше — всю IDE), чтобы настройки подхватились. Проверить результат можно командой:
adb versionЕсли в ответ выводится версия утилиты — переменные настроены правильно. Если система пишет, что команда не найдена, перепроверьте пути и отсутствие опечаток.
Типичные ошибки и их решение
Даже при строгом следовании инструкции установка иногда идёт не по плану. Разберём самые частые проблемы.
Ошибка «SDK location not found». Возможная причина — IDE потеряла путь к SDK. Откройте настройки и укажите папку вручную. Также проверьте файл local.properties в корне проекта: строка sdk.dir должна указывать на реально существующую папку.
Загрузка компонентов зависает или обрывается. Проверьте соединение и настройки прокси: в SDK Manager есть вкладка с настройками HTTP Proxy. Если выход в интернет идёт через корпоративный прокси, его параметры нужно прописать там же. Иногда помогает очистка кэша через File → Invalidate Caches с последующим перезапуском.
Ошибка принятия лицензий при сборке. Возможное решение — запустить в терминале менеджер лицензий из состава SDK:
sdkmanager --licensesУтилита находится в папке cmdline-tools внутри SDK. Она последовательно покажет все соглашения — примите их клавишей y.
⚠️ Внимание: не перемещайте и не переименовывайте папку SDK, пока Android Studio запущена. Сначала закройте IDE, затем переносите файлы, и только после этого прописывайте новый путь в настройках — иначе возможны повреждения индексов и долгое восстановление проекта.
Проверка корректности установки
Финальный шаг — убедиться, что всё работает. Самый надёжный способ — создать новый проект через New Project → Empty Activity и дождаться успешной синхронизации Gradle. Ошибок быть не должно.
Дополнительно проверьте запуск на эмуляторе: откройте Device Manager, создайте виртуальное устройство и запустите проект. Если приложение собралось и открылось в эмуляторе — SDK установлен и настроен корректно.
При работе с реальным устройством включите на смартфоне отладку по USB в меню разработчика и подключите его кабелем — устройство должно появиться в списке доступных целей запуска. Если не появляется, проверьте драйверы (на Windows) и разрешение отладки на самом устройстве.
Часто задаваемые вопросы
Можно ли установить Android SDK без Android Studio?
Да, Google распространяет отдельный пакет Command Line Tools, который позволяет управлять SDK через утилиту sdkmanager в терминале. Этот вариант подходит для серверов сборки и CI-систем, но для обычной разработки удобнее полноценная IDE.
Сколько места занимает Android SDK?
Объём сильно зависит от набора компонентов. Минимальный набор с одной платформой занимает несколько гигабайт, а полный комплект с несколькими платформами, образами эмулятора и NDK может потребовать десятки гигабайт свободного места.
Нужно ли устанавливать SDK для каждой версии Android?
Нет. Достаточно платформы, указанной в compileSdk проекта. Приложение будет запускаться и на более старых устройствах — диапазон совместимости задаётся параметром minSdk, который не требует установки соответствующих платформ.
Что делать, если SDK Manager не открывается?
Попробуйте запустить Android Studio от имени администратора, проверьте, не блокирует ли антивирус исполняемые файлы IDE, и очистите кэш через File → Invalidate Caches. Если проблема сохраняется, возможная причина — повреждённая установка, и проще всего переустановить IDE.
Можно ли перенести SDK на другой диск?
Да. Закройте Android Studio, скопируйте папку SDK на новый диск, затем при следующем запуске укажите новый путь в настройках Android SDK Location и обновите переменную ANDROID_HOME, если она использовалась.