Ошибка SDK path not set в Android Studio: как исправить

Что означает ошибка SDK path not set

Ошибка SDK path not set (или SDK location not found) возникает, когда Android Studio не может определить путь к установленному Android SDK. Полное сообщение может выглядеть так: "SDK location not found. Please set the Android SDK location in the project structure." Эта ошибка обычно появляется при первом запуске Android Studio, открытии проекта или при попытке сборки приложения. Без корректного пути к SDK вы не сможете компилировать, запускать или отлаживать Android-приложения.

Причины возникновения

Ошибка возникает по следующим причинам:

1. Android SDK не установлен — при чистой установке Android Studio может не установить SDK автоматически, особенно если был выбран пользовательский режим установки.
2. Путь к SDK не указан в настройках — после перемещения папки SDK или при использовании новой установки Android Studio не знает, где искать SDK.
3. Некорректная переменная среды ANDROID_HOME — если переменная ANDROID_HOME задана, но указывает на несуществующую или неправильную папку, Android Studio может попытаться использовать её и не найти SDK.
4. Повреждение папки SDK — если компоненты SDK были удалены вручную или установка прервалась, папка может быть неполной.
5. Проблемы с правами доступа — Android Studio не имеет прав на чтение папки SDK из-за настроек безопасности или антивируса.

Способ 1: Указание пути к SDK в настройках Android Studio

Это основной и самый простой способ решения.

1. Откройте настройки Android Studio.
   • На Windows/Linux: File → Settings.
   • На macOS: Android Studio → Preferences.
2. Перейдите к настройкам SDK.
   • В современных версиях: Appearance & Behavior → System Settings → Android SDK.
   • В старых версиях (до 2020.3): File → Project Structure → SDK Location.
3. Укажите путь к папке SDK.
   • В поле Android SDK location нажмите кнопку ... (обзор) и выберите папку, где установлен SDK.
   • Если SDK не установлен, нажмите кнопку Download или Install SDK и следуйте инструкциям мастера для загрузки.
4. Примените изменения.
   • Нажмите Apply и OK.
5. Перезапустите Android Studio.
   • Закройте и снова откройте программу, чтобы изменения вступили в силу.

💡 Совет: Стандартные пути установки SDK:

• Windows: C:\Users\<ваше_имя>\AppData\Local\Android\Sdk
• macOS: ~/Library/Android/sdk
• Linux: ~/Android/Sdk

Способ 2: Настройка переменной среды ANDROID_HOME

Если вы предпочитаете использовать переменные среды (например, для работы с Gradle из командной строки), настройте ANDROID_HOME.

Для Windows:

1. Определите путь к SDK (если не знаете, установите через Способ 1 или найдите папку Sdk).
2. Откройте Панель управления → Система → Дополнительные параметры системы → Переменные среды.
3. В разделе Системные переменные нажмите Создать:
   • Имя переменной: ANDROID_HOME
   • Значение переменной: полный путь к папке SDK (например, C:\Users\Иван\AppData\Local\Android\Sdk).
4. Найдите переменную Path в списке, отредактируйте её и добавьте две записи:

   %ANDROID_HOME%\tools
   %ANDROID_HOME%\platform-tools
   

5. Нажмите OK во всех окнах и перезапустите компьютер (или хотя бы Android Studio).

Для macOS/Linux:

1. Откройте терминал.
2. Определите путь к SDK. Если SDK установлен через Android Studio, он обычно находится в ~/Library/Android/sdk (macOS) или ~/Android/Sdk (Linux).
3. Отредактируйте файл конфигурации оболочки:
   • Для bash: nano ~/.bash_profile или vim ~/.bash_profile
   • Для zsh (по умолчанию в новых macOS): nano ~/.zshrc
4. Добавьте в конец файла строки (подставьте свой путь):

   export ANDROID_HOME=$HOME/Library/Android/sdk  # для macOS
   # или
   export ANDROID_HOME=$HOME/Android/Sdk         # для Linux
   export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools
   

5. Сохраните файл и выполните:

   source ~/.bash_profile   # или source ~/.zshrc
   

6. Перезапустите Android Studio.

⚠️ Важно: После настройки ANDROID_HOME убедитесь, что в настройках Android Studio (Способ 1) путь также указан правильно, иначе переменная среды может игнорироваться.

Способ 3: Переустановка Android SDK через SDK Manager

Если SDK повреждён или отсутствуют ключевые компоненты, переустановите его.

1. Откройте SDK Manager:
   • В Android Studio: Tools → SDK Manager.
2. Проверьте установленные компоненты:
   • На вкладке SDK Platforms убедитесь, что выбрана хотя бы одна версия Android (например, Android 14.0).
   • На вкладке SDK Tools проверьте, что установлены Android SDK Build-Tools, Platform-Tools, Android Emulator и другие необходимые инструменты.
3. Установите недостающие компоненты:
   • Отметьте галочками нужные компоненты и нажмите Apply → OK для загрузки и установки.
4. Если SDK сильно повреждён, удалите папку SDK вручную (предварительно закройте Android Studio) и повторите установку через SDK Manager. Будьте осторожны: это удалит все загруженные платформы и инструменты.
5. Укажите путь к SDK в настройках (Способ 1), если он не был определён автоматически.

Способ 4: Проверка прав доступа и антивируса

Иногда ошибка возникает из-за блокировки доступа к папке SDK.

1. Проверьте права доступа:
   • Windows: Щёлкните правой кнопкой по папке SDK → Свойства → вкладка Безопасность. Убедитесь, что ваш пользователь имеет права Полный доступ или как минимум Чтение и выполнение.
   • macOS/Linux: В терминале выполните ls -la /путь/к/sdk и проверьте, что у вашего пользователя есть права на чтение (r).
2. Временно отключите антивирус или брандмауэр:
   • Некоторые антивирусы (особенно в корпоративных средах) могут блокировать доступ к папкам разработки. Добавьте папку SDK в исключения антивируса.
3. Запустите Android Studio от имени администратора (только для Windows):
   • Щёлкните правой кнопкой по ярлыку Android Studio → Запуск от имени администратора. Если это решит проблему, настройте постоянные права на папку SDK.
4. Перезапустите Android Studio после изменений.

Профилактика

Чтобы избежать повторения ошибки SDK path not set, следуйте рекомендациям:

• Используйте стандартные пути при установке SDK. Не перемещайте папку Sdk после установки без обновления настроек Android Studio и переменных среды.
• Регулярно обновляйте SDK через SDK Manager, чтобы избежать повреждений и устаревания компонентов.
• Настройте переменную среды ANDROID_HOME сразу после установки SDK, особенно если вы работаете с командной строкой или CI/CD.
• Создайте резервную копию папки SDK перед крупными обновлениями или переустановкой ОС.
• Проверяйте права доступа к папке SDK при установке на общих или защищённых компьютерах.