Ошибка «Your Android SDK is missing, out of date or corrupted» появляется при запуске Android Studio или при открытии проекта, когда среда разработки не может найти или корректно прочитать установленный набор инструментов Android SDK. Чаще всего сбой возникает после обновления Android Studio, переноса проекта на другой диск, ручного удаления папки SDK или прерванной загрузки компонентов через SDK Manager.
Хорошая новость: сама ошибка не означает, что проект испорчен. Проблема почти всегда локализуется в связке «среда разработки — папка SDK», и устраняется она без переустановки Windows и без потери исходного кода. Ниже разберём, как проверить путь к SDK, что обновить и какие действия выполнять только в крайнем случае.
Что означает эта ошибка и почему она возникает
Android SDK — это набор инструментов: platform-tools (adb, fastboot), build-tools, платформы конкретных версий Android, эмулятор и системные образы. Android Studio при запуске проверяет папку SDK, указанную в настройках, и если каталог отсутствует, перемещён или содержит неполные файлы, выводится сообщение о том, что SDK «missing, out of date or corrupted».
Типичные сценарии появления сбоя:
- 🔄 обновление Android Studio до новой версии, которая ожидает другую структуру папки SDK;
- 📁 ручной перенос папки
Android/Sdkна другой диск без изменения пути в настройках; - ⛔ прерванная загрузка компонентов через SDK Manager — часть файлов осталась в недокачанном состоянии;
- 🛡️ антивирус поместил в карантин исполняемые файлы из
platform-tools; - 👤 недостаток прав доступа к каталогу SDK, если он установлен в системную папку.
⚠️ Внимание: не удаляйте папку SDK целиком до того, как убедитесь, что проблема не в настройках пути. В большинстве ситуаций достаточно указать правильный каталог или докачать отдельные компоненты, а полная переустановка — это последний вариант.
Шаг 1. Проверьте путь к Android SDK
Первое действие — убедиться, что Android Studio смотрит в правильную папку. Откройте File → Settings → Appearance & Behavior → System Settings → Android SDK (в новых версиях путь также виден на экране приветствия через More Actions → SDK Manager). В верхней части окна указано поле Android SDK Location.
Проверьте, что указанный каталог реально существует на диске и содержит подпапки platforms, platform-tools и build-tools. Если папка была перемещена, нажмите Edit и укажите новое расположение. После этого среда предложит докачать недостающие компоненты — соглашайтесь.
Обратите внимание на права доступа: если SDK лежит в Program Files, запуск Android Studio от имени обычного пользователя может блокировать запись обновлений. Практичнее держать SDK в пользовательской папке или в корне диска.
Шаг 2. Обновите компоненты через SDK Manager
Если путь указан верно, но ошибка остаётся, вероятная причина — устаревшие или повреждённые отдельные пакеты. Откройте вкладку SDK Platforms и убедитесь, что установлена хотя бы одна платформа (например, та версия Android, под которую собирается проект). Затем перейдите на вкладку SDK Tools.
На вкладке инструментов включите флажок Show Package Details и проверьте состояние ключевых компонентов:
- 🧰 Android SDK Build-Tools — нужны для компиляции проекта;
- ⚙️ Android SDK Command-line Tools — требуются современным версиям Gradle;
- 📱 Android SDK Platform-Tools — adb и fastboot для работы с устройством;
- 🖥️ Android Emulator — если запускаете приложение на виртуальном устройстве.
Нажмите Apply и дождитесь полного завершения загрузки. Прерывание процесса — одна из главных причин состояния «corrupted», поэтому не закрывайте окно до появления подтверждения установки.
☑️ Базовая проверка SDK
Шаг 3. Исправьте конфигурацию проекта
Иногда SDK в порядке, но проект ссылается на несуществующую версию платформы или build-tools. Откройте файл build.gradle модуля приложения и посмотрите значения compileSdk и targetSdk. Если указанная версия платформы не установлена в SDK Manager, либо установите её, либо временно укажите версию из числа имеющихся.
Также проверьте файл local.properties в корне проекта — в нём может быть прописан устаревший путь:
sdk.dir=C:\\Users\\Имя\\AppData\\Local\\Android\\SdkЕсли проект был скопирован с другого компьютера, строка sdk.dir будет указывать на чужой путь. Удалите эту строку или исправьте путь на актуальный, после чего выполните File → Sync Project with Gradle Files.
Шаг 4. Переустановка SDK как крайняя мера
Если ни проверка пути, ни обновление компонентов не помогли, остаётся чистая переустановка. Порядок безопасный: сначала закройте Android Studio, затем переименуйте папку SDK (например, в Sdk_old) — это сохранит возможность отката. После запуска среда предложит мастер установки и скачает свежий набор компонентов.
Что стоит учесть перед переустановкой:
| Действие | Зачем | Риск |
|---|---|---|
| Переименовать старую папку SDK | Сохранить резервную копию | Минимальный |
| Удалить папку SDK сразу | Быстрее, но откат невозможен | Потеря скачанных образов эмулятора |
| Переустановить Android Studio | Помогает при повреждении самой IDE | Нужно заново настраивать среду |
| Очистить кэш Gradle | Устраняет конфликты сборки | Первая сборка станет дольше |
⚠️ Внимание: полная переустановка может занять заметное время из-за объёма загружаемых компонентов. Убедитесь в стабильном интернет-соединении — обрыв загрузки снова приведёт к состоянию «corrupted».
Когда проблема не в SDK
В редких случаях сообщение вызывают внешние факторы. Антивирус или контролируемый доступ к папкам в Windows могут блокировать запись в каталог SDK — проверьте журнал защитника и добавьте папку SDK в исключения. Также сбой возможен при повреждении кэша самой IDE: помогает File → Invalidate Caches / Restart.
Как проверить SDK без Android Studio
Откройте командную строку и выполните команду adb version из папки platform-tools. Если утилита запускается и показывает версию — базовые инструменты SDK целы, и проблема, скорее всего, в настройках IDE или проекта.
Если ничего не помогает, опишите ситуацию с указанием версии Android Studio, версии Gradle и полного текста ошибки — так диагностика в профильных сообществах разработчиков пойдёт значительно быстрее.
Частые вопросы
Можно ли указать путь к SDK вручную, если мастер установки не запускается?
Да. Откройте File → Settings → Android SDK и нажмите Edit рядом с полем Android SDK Location. Укажите существующую папку — среда проверит её содержимое и предложит докачать недостающие компоненты.
Нужно ли переустанавливать Android Studio целиком?
Обычно нет. Ошибка относится к SDK, а не к самой IDE. Переустановка студии оправдана только если повреждены её собственные файлы, что встречается заметно реже.
Проект требует старую версию платформы — где её взять?
В SDK Manager на вкладке SDK Platforms включите Show Package Details — там доступны предыдущие версии Android. Установите ту, которая указана в compileSdk вашего проекта.
Ошибка появляется только при сборке, а не при запуске IDE. Это то же самое?
Не совсем. Если студия запускается нормально, а сбой возникает при сборке, проверяйте версии compileSdk, build-tools и Gradle в файлах проекта — чаще всего проект ссылается на неустановленный компонент.
Влияет ли кириллица в пути к SDK на эту ошибку?
Может влиять. Пути с русскими буквами и пробелами периодически вызывают сбои сборки и доступа к инструментам. Надёжнее размещать SDK в каталоге с латинскими символами, например C:\Android\Sdk.