Ошибка «target folder is neither empty nor does it point to an existing SDK installation»: причины и решение

Ошибка target folder is neither empty nor does it point to an existing SDK installation появляется в мастере настройки Android Studio или при запуске SDK Manager, когда указанная папка для Android SDK содержит посторонние файлы, но при этом не распознаётся как корректная установка SDK. Мастер отказывается продолжать установку, потому что не может ни использовать каталог как пустой, ни принять его за существующий SDK.

Проблема возникает при первой установке среды, после переноса SDK на другой диск, при смене пути в настройках или после неудачной попытки распаковать компоненты вручную. Ниже разберём, почему появляется это сообщение и как устранить его без полной переустановки системы и потери проектов.

Что означает это сообщение

Установщик Android SDK допускает только два состояния целевой папки: либо она полностью пуста (тогда туда будет выполнена чистая установка), либо в ней уже лежит корректный SDK с характерной структурой каталогов — platforms, build-tools, platform-tools и другими служебными директориями. Любое промежуточное состояние вызывает отказ.

Типичный сценарий: пользователь указывает папку, куда ранее что-то скачивал, или каталог, в котором остались «обрывки» прерванной установки. Мастер видит файлы, но не находит признаков SDK — и блокирует продолжение. Это защитное поведение: оно не даёт затереть чужие данные и не даёт принять повреждённую установку за рабочую.

Основные причины ошибки

Прежде чем что-то удалять, стоит понять, какой именно сценарий реализовался. Возможных причин несколько, и действия для каждой отличаются:

  • 📁 В указанной папке лежат посторонние файлы — архивы, документы, остатки других программ.
  • 💾 Установка SDK была прервана (закрыли мастер, отключилось питание, оборвалась сеть), и в каталоге остались недокачанные компоненты.
  • 🔀 Путь указывает на папку, куда SDK был скопирован вручную без сохранения полной структуры каталогов.
  • 🔐 У Android Studio нет прав на чтение или запись в выбранную директорию — например, она находится в системном защищённом разделе.
  • 🌐 Путь содержит кириллицу, пробелы или спецсимволы, что на некоторых конфигурациях мешает корректному определению установки.

Отдельный случай — перенос SDK с другого компьютера простым копированием. Если при копировании были пропущены скрытые файлы или часть подкаталогов, структура перестаёт соответствовать ожиданиям мастера, и папка перестаёт распознаваться как SDK.

Быстрая диагностика папки

Откройте каталог, который вы указали в мастере установки, и оцените его содержимое. Корректная установка Android SDK обычно содержит несколько характерных подпапок. Их наличие или отсутствие подскажет дальнейшие действия.

Что в папкеДиагнозДействие
Папка полностью пустаОшибки быть не должноПроверить, тот ли путь указан в мастере
Есть platforms, build-tools, platform-toolsПохоже на рабочий SDKПроверить права доступа и путь
Только temp, .temp или недокачанные архивыПрерванная установкаОчистить папку и установить заново
Посторонние файлы, нет структуры SDKНеподходящий каталогУказать другую, пустую папку

Если в каталоге видны только временные файлы установщика (например, частично скачанные пакеты), это почти наверняка след прерванной установки. Такой каталог проще очистить, чем пытаться «достроить».

📊 В какой ситуации вы столкнулись с этой ошибкой?
Первая установка Android Studio
Перенос SDK на другой диск
После прерванной установки
При смене пути в настройках

Способ 1: очистить папку и установить SDK заново

Самый надёжный вариант, если в папке нет ничего ценного, — начать установку с чистого листа. Убедитесь, что в каталоге не хранятся нужные файлы, затем удалите всё его содержимое и повторите запуск мастера настройки Android Studio.

Вам нужно действовать аккуратно: удаляйте содержимое только той папки, которую сами выделили под SDK. Если каталог использовался другими программами, лучше не очищать его, а создать новую пустую папку, например C:\Android\Sdk, и указать её в мастере.

☑️ Подготовка папки под Android SDK

Выполнено: 0 / 5
⚠️ Внимание: не прерывайте загрузку компонентов SDK после начала установки. Именно прерванная на середине закачка чаще всего создаёт «полупустую» папку, которая затем вызывает эту же ошибку при повторном запуске.

Способ 2: указать путь к существующему SDK

Если Android SDK уже установлен на компьютере — например, остался от предыдущей копии Android Studio или был перенесён с другого диска, — нужно не создавать новую папку, а корректно указать существующую. В мастере настройки выберите вариант ручного указания пути и задайте корневой каталог SDK, а не одну из его подпапок.

Частая ошибка — указать в качестве пути вложенный каталог вроде platforms или build-tools. Мастер ожидает именно корень SDK: ту папку, внутри которой эти подкаталоги лежат. Проверить себя просто: откройте выбранный путь в проводнике — если внутри видны platform-tools и platforms, путь указан правильно.

Если Android Studio уже установлена, а ошибка возникает при открытии проекта, путь к SDK можно поменять в настройках среды. Обычно это делается через раздел настроек, посвящённый SDK и инструментам сборки; точное расположение пункта зависит от версии среды, поэтому при затруднениях сверьтесь с официальной документацией Android Studio для вашей версии.

Способ 3: проверить права доступа и переменные среды

Иногда папка идеально корректна, но мастер всё равно отказывается её принимать. Возможная причина — недостаток прав: каталог находится в защищённой зоне (например, внутри Program Files), и процесс установки не может прочитать или изменить его содержимое. Решение — разместить SDK в пользовательской директории, куда у системы есть полный доступ без повышения привилегий.

Также проверьте переменные окружения. Если в системе задана переменная ANDROID_HOME или ANDROID_SDK_ROOT, указывающая на старый или несуществующий путь, инструменты могут конфликтовать с настройками мастера. Проверить значение в Windows можно командой в терминале:

echo %ANDROID_HOME%

echo %ANDROID_SDK_ROOT%

Если переменная указывает на удалённый или переехавший каталог, обновите её в системных настройках либо удалите, чтобы среда использовала путь из собственной конфигурации. После изменения переменных окружения перезапустите Android Studio, чтобы изменения подхватились.

Где обычно лежит SDK по умолчанию

В Windows стандартный путь обычно выглядит как C:\Users\ИмяПользователя\AppData\Local\Android\Sdk. В macOS и Linux используются свои каталоги внутри домашней папки пользователя. Если вы ставили SDK с настройками по умолчанию, начните поиск именно с этих расположений.

⚠️ Внимание: изменяя переменные среды, не удаляйте другие системные переменные и не редактируйте Path без необходимости. Ошибочная правка окружения может нарушить работу других инструментов разработки.

Что делать, если ничего не помогло

Когда папка пуста, права в порядке, а ошибка сохраняется, остаются менее очевидные сценарии. Проверьте, не блокирует ли каталог антивирус или контролируемый доступ к папкам в Windows — такие функции иногда молча запрещают запись в «защищённые» директории. Временно добавьте папку SDK в исключения защитника и повторите попытку.

Ещё один вариант — повреждённая конфигурация самой среды. В этом случае помогает сброс настроек мастера: закройте Android Studio, найдите конфигурационный каталог среды в профиле пользователя и переименуйте его, чтобы при следующем запуске настройка началась с нуля. Конкретное расположение конфигурации зависит от версии и ОС, поэтому сверяйтесь с документацией.

Крайняя мера — полное удаление Android Studio вместе с остатками SDK и чистая установка в новый каталог без кириллицы и пробелов в пути. Всегда выбирайте для SDK путь только из латинских букв, без пробелов и спецсимволов — это исключает целый класс проблем не только при установке, но и при последующей сборке проектов.

Частые вопросы

Можно ли указать папку, где уже есть файлы, если среди них есть SDK?

Да, если структура SDK в папке полная и корректная — с каталогами platforms, build-tools, platform-tools. Посторонние файлы рядом со структурой SDK обычно не мешают, но чистый каталог надёжнее. Если сомневаетесь в целостности SDK, проще установить его заново в новую папку.

Почему ошибка появилась после переноса SDK на другой диск?

Вероятная причина — при копировании была утеряна часть файлов или скрытые служебные данные, либо в мастере указан не корень SDK, а вложенная папка. Проверьте структуру каталога и убедитесь, что путь указывает именно на корневую папку SDK.

Мешает ли кириллица в пути к SDK?

На ряде конфигураций кириллические символы и пробелы в пути вызывают сбои при установке и сборке проектов. Рекомендуется размещать SDK по пути, состоящему только из латинских букв, цифр и подчёркиваний.

Нужно ли удалять старый SDK перед установкой нового?

Не обязательно. Можно установить новый SDK в отдельную пустую папку, а старый удалить после того, как убедитесь, что новая установка работает и проекты собираются. Так вы сохраните запасной вариант на случай проблем.

Ошибка возникает в sdkmanager из командной строки — решение то же?

Принцип тот же: инструмент проверяет целевой каталог на пустоту или наличие корректной установки. Убедитесь, что путь, переданный через параметр --sdk_root или переменные окружения, указывает на корень SDK и доступен для записи.