Когда Android Studio при запуске проекта выдаёт ошибку SDK location not found или не видит подключённое устройство, причина почти всегда одна — Android SDK либо не установлен, либо IDE не знает, где он находится. Проверить это можно за минуту: откройте File → Settings → Appearance & Behavior → System Settings → Android SDK и посмотрите, указан ли путь в поле Android SDK Location и стоит ли галочка напротив нужной версии платформы.
В этой инструкции разберём, как установить SDK с нуля через встроенный менеджер, какие компоненты действительно нужны для разработки, как прописать переменные окружения и что делать, если SDK Manager не видит установленные пакеты. Материал актуален для Windows, macOS и Linux — различия в путях оговорены отдельно.
Что такое Android SDK и зачем он нужен
Android SDK (Software Development Kit) — это набор инструментов, без которых Android Studio не сможет собрать и запустить ни одно приложение. В комплект входят компиляторы, библиотеки платформы, эмулятор, отладчик ADB и образы системы. Сама IDE — это лишь оболочка, а вся «кухня» сборки происходит именно средствами SDK.
Важно понимать, что SDK — не монолит, а набор отдельных пакетов, которые можно ставить и удалять независимо. Это удобно: не нужно скачивать всё подряд, достаточно выбрать компоненты под свою задачу. Однако из-за этой модульности у новичков часто возникает путаница — проект требует конкретную версию платформы, а она не установлена.
- 📦 SDK Platform — библиотеки конкретной версии Android, под которую собирается приложение
- 🛠️ SDK Build-Tools — утилиты компиляции и упаковки APK/AAB
- 📱 Android Emulator — эмулятор для запуска приложений без физического устройства
- 🔧 SDK Platform-Tools — ADB, fastboot и другие инструменты взаимодействия с устройствами
- 🖼️ System Images — образы ОС для эмулятора
Проверка: установлен ли SDK уже сейчас
Прежде чем что-то ставить, убедитесь, что SDK действительно отсутствует. При стандартной установке Android Studio предлагает скачать SDK автоматически на этапе первого запуска — мастер Setup Wizard сам выбирает путь и загружает базовые компоненты. Если вы прошли этот этап, SDK уже на диске.
Откройте настройки: File → Settings (на macOS — Android Studio → Preferences), затем перейдите в Languages & Frameworks → Android SDK. Если в поле Android SDK Location указан путь, а во вкладке SDK Platforms отмечена хотя бы одна версия — SDK установлен. Пустое поле или надпись об отсутствии SDK означают, что требуется установка.
Установка SDK через SDK Manager
Основной и рекомендуемый способ — встроенный SDK Manager. Запустить его можно двумя путями: из окна приветствия через More Actions → SDK Manager или из открытого проекта через File → Settings → Android SDK. Интерфейс одинаковый, разница лишь в точке входа.
Во вкладке SDK Platforms отметьте версию Android, под которую планируете разработку. Как правило, достаточно последней стабильной версии — обратная совместимость обеспечивается параметром minSdk в проекте. Затем перейдите во вкладку SDK Tools и убедитесь, что отмечены Android SDK Build-Tools, Android SDK Platform-Tools и Android Emulator. Нажмите Apply и подтвердите загрузку — менеджер скачает и распакует пакеты автоматически.
☑️ Чек-лист установки Android SDK
Обратите внимание на путь установки. По умолчанию SDK размещается в профиле пользователя: C:\Users\Имя\AppData\Local\Android\Sdk на Windows, ~/Library/Android/sdk на macOS и ~/Android/Sdk на Linux. Если имя пользователя содержит кириллицу или пробелы, отдельные инструменты сборки могут работать некорректно — в этом случае лучше указать короткий путь вроде C:\Android\Sdk при установке или позже перенести SDK и обновить путь в настройках.
⚠️ Внимание: загрузка компонентов SDK может занять несколько гигабайт. Не прерывайте процесс закрытием окна — прерванная загрузка оставляет повреждённые пакеты, которые SDK Manager иногда не может переустановить без ручной очистки папки.
Настройка переменных окружения
Для работы внутри Android Studio переменные окружения не обязательны — IDE хранит путь к SDK в собственных настройках. Но если вы планируете запускать ADB из командной строки или использовать сторонние инструменты (например, Flutter или React Native), без переменной ANDROID_HOME не обойтись.
На Windows откройте Параметры → Система → О системе → Дополнительные параметры системы → Переменные среды. Создайте пользовательскую переменную ANDROID_HOME со значением — полным путём к папке SDK. Затем отредактируйте переменную Path, добавив туда путь к platform-tools внутри SDK. После этого перезапустите терминал и проверьте результат командой:
adb --versionЕсли команда выводит версию Android Debug Bridge, настройка выполнена верно. Ошибка «не является внутренней или внешней командой» означает, что путь в Path указан неверно или терминал не был перезапущен. На macOS и Linux переменные прописываются в файле ~/.bashrc или ~/.zshrc строкой export ANDROID_HOME=~/Library/Android/sdk с аналогичным добавлением platform-tools в PATH.
Установка SDK без Android Studio (командная строка)
Для серверов сборки и минимальных конфигураций существует отдельный пакет Command Line Tools, который распространяется на официальном сайте Android Developers независимо от IDE. После распаковки архива управление пакетами выполняется утилитой sdkmanager.
Типовая последовательность выглядит так: сначала принимаются лицензии, затем ставятся нужные пакеты:
sdkmanager --licenses
sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"
Точные идентификаторы пакетов можно посмотреть командой sdkmanager --list. Номера версий платформ и build-tools меняются с выходом новых релизов, поэтому сверяйтесь со списком, который выводит сама утилита, а не копируйте версии из старых руководств.
Куда распаковывать Command Line Tools
Структура папок имеет значение: sdkmanager ожидает, что он лежит по пути SDK/cmdline-tools/latest/bin/. Если распаковать архив в корень SDK без этой вложенности, утилита выдаст предупреждение или ошибку при обновлении самой себя. Создайте внутри папки SDK каталог cmdline-tools, в нём — каталог latest, и уже туда поместите содержимое архива.
Типичные ошибки и их решение
Даже при корректной установке пользователи сталкиваются с рядом повторяющихся проблем. Ниже — самые частые сценарии и способы их диагностики. Начинайте проверку с самого простого пункта и двигайтесь дальше, только если предыдущий не помог.
| Ошибка | Вероятная причина | Что проверить |
|---|---|---|
| SDK location not found | Не указан путь к SDK | Задать путь в Settings → Android SDK |
| Failed to find Platform SDK | Не установлена нужная версия платформы | Отметить версию во вкладке SDK Platforms |
| License for package not accepted | Не приняты лицензии | Выполнить sdkmanager --licenses |
| adb не распознаётся в терминале | Нет platform-tools в PATH | Проверить переменные окружения |
| Эмулятор не запускается | Не установлен Emulator или нет образа системы | Вкладка SDK Tools и Device Manager |
⚠️ Внимание: ошибка видаFailed to install the following Android SDK packagesпри загрузке часто связана не с SDK, а с антивирусом или корпоративным прокси, блокирующим скачивание. Временно отключите проверку или настройте прокси вFile → Settings → Appearance & Behavior → System Settings → HTTP Proxy.
Если SDK Manager показывает пакет как установленный, но сборка его не находит, возможна рассинхронизация кэша. Помогает перезапуск IDE, а в запущенных случаях — File → Invalidate Caches / Restart. Крайняя мера — удалить проблемный пакет через SDK Manager (снять галочку, Apply) и поставить заново.
Обновление и управление компонентами
SDK требует периодического обслуживания. Во вкладке SDK Tools есть флажок Show Package Details — включите его, чтобы видеть конкретные версии пакетов и доступные обновления. Устаревшие компоненты помечаются статусом Update Available, обновляются они тем же нажатием Apply.
Не удаляйте старые версии платформ, если поддерживаете проекты, собранные под них: поле compileSdk в build.gradle жёстко привязано к конкретной версии, и её отсутствие остановит сборку. Обратная ситуация тоже типична — после обновления проекта до новой платформы старые пакеты можно безопасно снять, освободив место на диске.
Часто задаваемые вопросы
Можно ли установить Android SDK отдельно от Android Studio?
Да. Для этого существуют Command Line Tools — отдельный архив с сайта Android Developers. Управление пакетами выполняется утилитой sdkmanager из командной строки. Такой вариант подходит для сборочных серверов и пользователей других IDE.
Сколько места занимает Android SDK?
Точный объём зависит от выбранных компонентов. Минимальный набор (одна платформа, build-tools, platform-tools) занимает заметно меньше, чем полный комплект с эмулятором и несколькими образами системы. Перед установкой убедитесь, что на диске есть запас свободного места с учётом будущих обновлений.
Android Studio не видит SDK, хотя он установлен. Что делать?
Откройте File → Settings → Android SDK и вручную укажите путь к папке SDK в поле Android SDK Location. Если путь указан верно, но проблема остаётся, проверьте, не содержит ли он кириллицы, и выполните File → Invalidate Caches / Restart.
Нужно ли принимать лицензии SDK и как это сделать?
Да, без принятия лицензий сборка проекта может завершаться ошибкой. В Android Studio лицензии принимаются автоматически при установке пакетов через SDK Manager. При работе через командную строку используйте команду sdkmanager --licenses и подтвердите каждое соглашение клавишей y.
Какую версию Android выбрать в SDK Platforms?
Ориентируйтесь на значение compileSdk в файле build.gradle вашего проекта — платформа должна ему соответствовать. Для новых проектов разумно ставить последнюю стабильную версию: поддержка старых устройств задаётся параметром minSdk и не требует установки старых платформ.