Установка и расположение Android SDK — краткая инструкция

Android SDK обычно устанавливается вместе с Android Studio; по умолчанию папка лежит: Windows — C:\Users<user>\AppData\Local\Android\Sdk, macOS — ~/Library/Android/sdk, Linux — ~/Android/Sdk. Установить SDK можно через мастер Android Studio или вручную командными инструментами (sdkmanager); далее достаточно прописать путь в Android Studio и в переменных среды (ANDROID_SDK_ROOT/ANDROID_HOME).

Что такое Android SDK и зачем он нужен

Android SDK — это набор инструментов (platform-tools, build-tools, platforms и др.), необходимых для сборки, отладки и запуска Android‑приложений. Без корректного SDK:

  • Gradle не соберёт проект;
  • инструменты Flutter/React Native/Unity не найдут Android-платформу;
  • adb/fastboot будут недоступны в командной строке.

Как установить SDK (быстро и надёжно)

  1. Через Android Studio (рекомендуется):

    • Установите Android Studio стандартным мастером установки.
    • При первом запуске в Setup Wizard включите Android SDK и выберите нужные платформы.
    • Android Studio загрузит SDK и автоматически укажет путь в настройках.
  2. Вручную (серверы, CI, минимальная установка):

    • Скачайте пакет командных инструментов (Command line tools) и распакуйте в удобное место.
    • В терминале выполните:
sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"
  • После этого появятся папки platform-tools, platforms и build-tools — корень этого каталога и есть SDK.

Не скачивайте SDK/IDE с сомнительных зеркал. Используйте официальные сборки и проверяйте подписи при необходимости.

Где физически находится папка SDK и как её найти

Типичные пути:

  • Windows: C:\Users<пользователь>\AppData\Local\Android\Sdk
  • macOS: /Users/<пользователь>/Library/Android/sdk (иногда ~/Android/Sdk)
  • Linux: ~/Android/Sdk или ~/Android/sdk

Как быстро узнать точный путь:

  • Откройте Android Studio → File → Settings (или Android Studio → Preferences на macOS) → Appearance & Behavior → System Settings → Android SDK. Вверху поля будет Android SDK Location — скопируйте путь.

Если не уверены, используйте поиск по файловой системе на наличие папок platform-tools, platforms и build-tools — это однозначно SDK.

Как перенести SDK и изменить SDK Location

  1. Закройте Android Studio.
  2. Скопируйте всю директорию SDK целиком в новое место (например, D:\Android\Sdk).
  3. Откройте Android Studio и в настройках Android SDK укажите новый путь.
  4. При необходимости IDE докачает недостающие компоненты.

Не переносите отдельные подпапки вручную — копируйте всю директорию целиком, иначе возможны ошибки сборки.

Настройка переменных среды и проверка

Windows:

  • Создайте переменную ANDROID_SDK_ROOT (и по совместимости ANDROID_HOME) со значением пути к корню SDK.
  • Добавьте в PATH: %ANDROID_SDK_ROOT%\platform-tools

macOS / Linux (пример для bash/zsh):

export ANDROID_SDK_ROOT="$HOME/Android/Sdk"
export ANDROID_HOME="$ANDROID_SDK_ROOT"
export PATH="$PATH:$ANDROID_SDK_ROOT/platform-tools"

Примените изменения (source ~/.bashrc или перезапуск терминала) и проверьте:

  • adb --version
  • flutter doctor (если используете Flutter)

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

  • "SDK location not found" — путь в настройках IDE или переменных среды указывает на несуществующую папку. Решение: указать правильный путь или переустановить SDK.
  • "Could not find adb" — platform-tools не в PATH; добавьте platform-tools в PATH и перезапустите терминал.
  • Неполный перенос SDK — скопированы не все подпапки; скопируйте директорию целиком.

FAQ

  • Как быстро открыть папку SDK в проводнике?
    Windows: введите %LOCALAPPDATA%\Android\Sdk в адресной строке Проводника.
    macOS: Finder → Перейти → Перейти к папке… → ~/Library/Android/sdk.
    Linux: cd ~/Android/Sdk

  • Нужно ли задавать ANDROID_HOME и ANDROID_SDK_ROOT одновременно?
    Рекомендуется выставить ANDROID_SDK_ROOT; ANDROID_HOME можно задать для совместимости со старыми инструментами.

  • Что делать, если проект требует другую версию build-tools?
    Установите нужную версию через sdkmanager или SDK Manager в Android Studio (SDK Tools → Show Package Details).

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