Ошибка «SDK components not installed» или зависание мастера настройки на этапе Setup Wizard — самый частый симптом, когда Android Studio не устанавливает SDK при первом запуске. Обычно установщик сообщает, что не может загрузить компоненты, либо процесс доходит до конца, но папка Android/Sdk остаётся пустой или неполной.
Причины почти всегда сводятся к нескольким группам: проблемы с сетью, нехватка прав на запись в каталог установки, конфликт антивируса, повреждённый кэш загрузок или неверно указанный путь к SDK. Ниже разберём каждую из них и дадим безопасный порядок диагностики — от простых проверок к более глубоким.
Как проявляется проблема
До начала исправлений полезно понять, на каком именно этапе ломается установка. От этого зависит, куда смотреть в первую очередь.
- 🔄 Зависание Setup Wizard на шаге загрузки компонентов без сообщения об ошибке.
- ⛔ Сообщение вида
SDK components were not installedилиFailed to installв конце мастера. - 📉 Ошибки сети:
Connection reset,Read timed out, сбои при обращении кdl.google.com. - 📁 После «успешной» установки в SDK Manager список платформ пуст, а папка SDK весит подозрительно мало.
- 🔒 Ошибки доступа к файлам при распаковке компонентов.
Если мастер просто «висит», не закрывайте его сразу: загрузка крупных пакетов на медленном соединении может занимать заметное время. Но если прогресс не меняется в течение длительного периода, это уже признак сбоя.
Проверка сети и доступа к серверам Google
Первое, что стоит проверить, — доступность серверов загрузки. SDK Manager скачивает компоненты с доменов Google, и если сеть блокирует эти адреса, установка не завершится ни при каких настройках самой IDE.
Откройте в браузере страницу репозитория, например https://dl.google.com/android/repository/repository2-1.xml. Если страница не открывается или загружается с ошибкой, проблема в сети: проверьте VPN, корпоративный прокси, фильтрацию провайдера или настройки файрвола. Иногда помогает простая смена DNS на публичный или переключение на другую сеть (например, раздача с телефона).
Когда выход в интернет осуществляется через прокси, его нужно явно указать в среде разработки. Откройте File → Settings → Appearance & Behavior → System Settings → HTTP Proxy и введите параметры прокси, после чего нажмите проверку соединения. Без корректных настроек прокси загрузка компонентов будет обрываться.
Права доступа и расположение папки SDK
Вторая типичная причина — установщик не может записать файлы в выбранный каталог. Это случается, если папка SDK находится в защищённой директории (например, внутри Program Files на Windows) или путь содержит пробелы, кириллицу и спецсимволы.
Рекомендуемый подход — разместить SDK в простом пути вроде C:\Android\Sdk или в домашней папке пользователя. Убедитесь, что у вашей учётной записи есть полные права на запись в этот каталог: откройте свойства папки и проверьте вкладку безопасности. Запуск Android Studio от имени администратора — временная мера для диагностики, но не лучшее постоянное решение.
⚠️ Внимание: не указывайте в качестве пути SDK папки, синхронизируемые облачными сервисами (OneDrive, Dropbox и подобными). Фоновая синхронизация может блокировать файлы в момент распаковки и приводить к повреждению компонентов.
Изменить расположение можно в File → Settings → Languages & Frameworks → Android SDK, в поле Android SDK Location. После смены пути повторите установку недостающих пакетов через SDK Manager.
Очистка кэша и повторная установка компонентов
Если загрузка прерывалась, в каталоге SDK могут остаться недокачанные временные файлы, которые мешают повторной установке. В таком случае помогает ручная чистка.
☑️ Порядок повторной установки SDK
Для установки вам понадобятся как минимум: Android SDK Platform нужной версии, Android SDK Build-Tools, Android SDK Platform-Tools и Android SDK Command-line Tools. Отмечайте их по одному-два за раз — так проще выявить пакет, на котором происходит сбой.
Альтернативный вариант — установка через командную строку с помощью утилиты sdkmanager, которая входит в состав командных инструментов. Она часто выдаёт более информативные сообщения об ошибках, чем графический интерфейс.
sdkmanager --list
sdkmanager "platform-tools" "platforms;android-34"
Точные идентификаторы пакетов и поддерживаемые версии периодически меняются, поэтому актуальный список смотрите через команду --list на вашей машине.
Где искать логи установки
Журналы работы IDE и установщика хранятся в служебной папке конфигурации Android Studio внутри профиля пользователя (каталоги вида .config/Google или Google в AppData — зависит от ОС и версии). В логах ищите строки со словами error, exception, failed рядом с названиями пакетов — они укажут конкретную причину сбоя.
Влияние антивируса и защитных средств
Антивирусные продукты нередко блокируют распаковку архивов SDK или изолируют исполняемые файлы вроде adb.exe и sdkmanager.bat. Внешне это выглядит как «установка прошла, но ничего не работает».
Для диагностики временно приостановите защиту и повторите установку одного небольшого пакета. Если проблема исчезла, добавьте папку SDK и каталог Android Studio в исключения антивируса, после чего включите защиту обратно. Полностью отключать антивирус на постоянной основе не нужно — достаточно корректных исключений.
⚠️ Внимание: скачивайте Android Studio и инструменты командной строки только с официального сайта разработчика. Сторонние «сборки» установщика могут содержать повреждённые или изменённые компоненты, и тогда никакие настройки сети не помогут.
Сравнение типичных причин и способов проверки
| Причина | Типичный признак | Как проверить | Решение |
|---|---|---|---|
| Блокировка сети | Тайм-ауты, обрывы загрузки | Открыть dl.google.com в браузере | Настроить прокси, сменить сеть или DNS |
| Нет прав на запись | Ошибки доступа к файлам | Создать файл в папке SDK вручную | Сменить путь, выдать права |
| Повреждённый кэш | Повторная установка сразу падает | Проверить папку temp в SDK | Очистить временные файлы, повторить |
| Антивирус | Файлы исчезают после установки | Проверить журнал карантина | Добавить исключения |
| Нехватка места | Сбой на этапе распаковки | Проверить свободное место на диске | Освободить место с запасом |
Если SDK установлен, но проект его не видит
Отдельная ситуация: компоненты на диске есть, а IDE при открытии проекта пишет, что SDK не найден. Здесь дело обычно в конфигурации, а не в установке.
Проверьте путь в File → Project Structure → SDK Location — он должен указывать на реальный каталог SDK. Также загляните в файл local.properties в корне проекта: строка вида sdk.dir=... должна содержать корректный путь. Если проект переносился с другого компьютера, этот файл почти наверняка содержит чужой путь — исправьте его или удалите, чтобы среда сгенерировала новый.
После правок выполните File → Sync Project with Gradle Files, чтобы среда заново подхватила конфигурацию.
Частые вопросы
Можно ли установить SDK без Android Studio?
Да. Существуют отдельные Command-line Tools, которые позволяют скачать и настроить SDK через утилиту sdkmanager без установки полной среды разработки. Это удобно для серверов сборки и минимальных конфигураций.
Сколько места нужно для SDK?
Точный объём зависит от набора компонентов: платформы, образов эмуляторов и инструментов. Закладывайте запас в несколько гигабайт свободного места, особенно если планируете использовать эмулятор с системными образами.
Почему SDK Manager показывает пустой список пакетов?
Чаще всего это следствие проблем с сетью или прокси: менеджер не смог загрузить индекс репозитория. Проверьте настройки HTTP Proxy и доступность серверов Google, затем обновите список. Реже причина в повреждённых файлах кэша репозитория.
Нужно ли переустанавливать Android Studio целиком?
Обычно нет. Проблемы с SDK решаются отдельно от самой IDE: сменой пути, очисткой временных файлов и повторной установкой пакетов. Полная переустановка оправдана только если повреждены файлы самой среды.
Ошибка появляется только на одном конкретном пакете. Что делать?
Попробуйте установить этот пакет через sdkmanager в командной строке — там виден текст ошибки. Если пакет не критичен для работы, его можно пропустить и вернуться к нему позже, установив остальные компоненты.