Как быстро убрать ошибку "Android SDK not found" в Android Studio и Gradle

Ошибка "Android SDK not found" означает, что Android Studio или Gradle не видят установленный SDK; исправить можно через SDK Manager, корректную настройку переменных окружения (ANDROID_HOME/Path) и пересборку/очистку Gradle — ниже пошагово.

Быстрая проверка в Android Studio

1. Откройте Settings / Preferences → Appearance & Behavior → System Settings → Android SDK.
2. Во вкладке SDK Platforms отметьте требуемые API (для новых проектов минимум API 34).
3. Во вкладке SDK Tools обновите: Android SDK Build-Tools, Platform-Tools, SDK Command-line Tools. Примените изменения и нажмите File → Sync Project with Gradle Files.
4. Если SDK пустой или недоступен — скачайте через SDK Manager (в IDE) и перезапустите Studio.

Если проблема решена в IDE, повторно соберите проект (Build → Rebuild Project) и проверьте запуск эмулятора.

Настройка переменных окружения (Windows / macOS / Linux)

Gradle и внешние скрипты часто ищут SDK по системным переменным. Проверьте их так:

• Windows:

  • Откройте Параметры системы → Переменные среды.
  • Добавьте/проверьте системную переменную ANDROID_HOME = C:\Users\<ВашеИмя>\AppData\Local\Android\Sdk
  • В Path добавьте: %ANDROID_HOME%\platform-tools, %ANDROID_HOME%\emulator, %ANDROID_HOME%\tools\bin
  • Закройте и откройте терминал/IDE.

• macOS / Linux (пример для zsh/bash): Добавьте в ~/.zshrc или ~/.bash_profile:

  export ANDROID_HOME=$HOME/Library/Android/sdk
  export PATH=$PATH:$ANDROID_HOME/emulator
  export PATH=$PATH:$ANDROID_HOME/platform-tools
  export PATH=$PATH:$ANDROID_HOME/tools/bin

Затем выполните source ~/.zshrc и проверьте echo $ANDROID_HOME.

Проверьте доступность инструментов: sdkmanager --list и adb --version. Если команды работают, Gradle должен находить SDK.

Проблемы с Gradle, cache и файлы проекта

Если IDE видит SDK, а сборка через терминал/CI всё равно падает:

1. Проверьте gradle.properties (проектный или ~/.gradle/):
   • Убедитесь, что нет переопределяющих свойств, указывающих неправильный путь.
2. В build.gradle (модуль app) явно укажите версии:

   android {
     compileSdk 34
     defaultConfig {
       targetSdk 34
     }
   }

3. Очистите и пересоберите:
   • В терминале проекта: ./gradlew clean assembleDebug (или ./gradlew build)
   • В Android Studio: File → Invalidate Caches / Restart, затем Sync Project with Gradle Files.
4. Удалите при необходимости папки .gradle/ и build/ в корне проекта и в модулях, затем пересоберите.

Если ошибка в CI — убедитесь, что в окружении CI задан ANDROID_HOME или используется SDK Manager в pipeline для установки SDK.

Сравнение подходов (кратко)

Сравнение способов решения

Частые ошибки

• Указан путь к tools вместо корня SDK.
• Добавлен путь в Path без перезапуска терминала/IDE.
• Конфликт версий: плагин Gradle требует другой compileSdk.
• На M1/M2 Mac — запуск эмулятора без Rosetta (при использовании x86 образов).
• CI запускается в контейнере без SDK — нужно установить его в pipeline.

FAQ

• Что делать, если sdkmanager не найден?
  Проверьте PATH на наличие $ANDROID_HOME/tools/bin и перезапустите терминал; при необходимости установите Command-line Tools через SDK Manager.

• Нужно ли ставить ANDROID_HOME и ANDROID_SDK_ROOT одновременно?
  Достаточно одного корректного пути (ANDROID_SDK_ROOT — современная переменная), но многие инструменты всё ещё читают ANDROID_HOME. Рекомендуется задать обе на одну папку SDK.

• После обновления Studio сборка внезапно перестала работать — почему?
  Часто плагин Gradle требует более высокого compileSdk или обновления Build Tools. Проверьте требования плагина и обновите SDK/Build Tools, либо зафиксируйте совместимые версии в build.gradle.

Если после всех шагов ошибка сохраняется — опишите точный текст ошибки и окружение (OS, версия Studio, способ сборки: IDE/CLI/CI), это позволит дать точечное решение.