Установка и расположение 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 (быстро и надёжно)
-
Через Android Studio (рекомендуется):
- Установите Android Studio стандартным мастером установки.
- При первом запуске в Setup Wizard включите Android SDK и выберите нужные платформы.
- Android Studio загрузит SDK и автоматически укажет путь в настройках.
-
Вручную (серверы, 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
- Закройте Android Studio.
- Скопируйте всю директорию SDK целиком в новое место (например, D:\Android\Sdk).
- Откройте Android Studio и в настройках Android SDK укажите новый путь.
- При необходимости 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.