Ошибка «SDK location not found» при первом запуске проекта почти всегда означает одно: Android SDK либо не установлен, либо путь к нему не прописан в системе. Это самая частая проблема у начинающих разработчиков, и решается она корректной установкой комплекта с нуля.
В этой инструкции разберём, как установить Android SDK на Windows, macOS и Linux двумя способами — через Android Studio и через инструменты командной строки без среды разработки. Также покажем, как настроить переменные среды, чтобы команды adb и sdkmanager работали из любого терминала.
Что входит в Android SDK и что нужно подготовить
Android SDK (Software Development Kit) — это набор инструментов для разработки и отладки приложений под Android. В него входят SDK Platform Tools (в том числе adb и fastboot), платформы для конкретных версий Android, системные образы для эмулятора и инструменты сборки build-tools.
Перед установкой проверьте несколько вещей. Во-первых, понадобится установленный JDK — современные версии Android Studio уже содержат встроенную среду Java, поэтому отдельная установка обычно не требуется. Во-вторых, убедитесь, что на диске достаточно свободного места: полный комплект с несколькими платформами и образами эмулятора занимает заметный объём, поэтому держите запас в несколько гигабайт.
- 💾 Свободное место на диске с запасом под платформы и образы эмулятора
- 🌐 Стабильное интернет-соединение — компоненты скачиваются с серверов Google
- 👤 Права администратора для установки в системные каталоги (на Windows)
- 📁 Путь установки без кириллицы и пробелов — это снижает риск ошибок сборки
Способ 1: установка через Android Studio
Самый простой вариант — поставить Android Studio, официальную среду разработки от Google. SDK устанавливается вместе с ней автоматически. Скачайте установщик с официального сайта разработчиков Android и запустите его, следуя мастеру установки.
При первом запуске среда предложит тип настройки. Выберите Standard — в этом случае будут автоматически загружены актуальная платформа SDK, инструменты сборки и эмулятор. Вариант Custom позволяет вручную указать каталог установки SDK и отказаться от лишних компонентов, что полезно при ограниченном месте на диске.
После завершения установки откройте SDK Manager: в окне приветствия это пункт More Actions → SDK Manager, а в открытом проекте — меню Tools → SDK Manager. Здесь на вкладке SDK Platforms отмечаются нужные версии Android, а на вкладке SDK Tools — инструменты вроде Android SDK Build-Tools, NDK и Android Emulator.
☑️ Установка через Android Studio
Способ 2: установка через командную строку без Android Studio
Если среда разработки не нужна — например, SDK требуется для сборки на сервере или только ради adb — можно обойтись пакетом Command line tools. Он доступен на той же странице загрузки Android Studio, в разделе инструментов командной строки, отдельно для Windows, macOS и Linux.
Распакуйте архив в выбранный каталог. Важный нюанс: содержимое нужно разместить в структуре папок cmdline-tools/latest/ внутри каталога SDK, иначе sdkmanager может выдавать предупреждения о некорректном расположении. Итоговый путь к утилите будет выглядеть примерно как Sdk/cmdline-tools/latest/bin/sdkmanager.
Дальше компоненты ставятся командами. Сначала примите лицензии, затем установите базовые пакеты:
sdkmanager --licenses
sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"
Точные идентификаторы доступных пакетов смотрите командой sdkmanager --list. Номера версий платформ меняются с выходом новых релизов Android, поэтому сверяйтесь с актуальным списком, а не копируйте версии из старых инструкций.
Где взять только adb без полного SDK
Google распространяет отдельный архив SDK Platform Tools, который содержит adb и fastboot. Достаточно распаковать его в любую папку и добавить путь в переменную PATH — никакая установка не требуется. Этого хватает для прошивки, отладки и работы с устройством.
Настройка переменных среды
Чтобы команды SDK работали из любого терминала, нужно прописать системные переменные. На Windows откройте Параметры → Система → О системе → Дополнительные параметры системы → Переменные среды и создайте переменную ANDROID_HOME со значением — путём к каталогу SDK.
Затем в переменную Path добавьте пути к подкаталогам platform-tools и cmdline-tools\latest\bin. На macOS и Linux аналогичные строки добавляются в файл ~/.bashrc или ~/.zshrc:
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools
После правки конфигурационного файла выполните source ~/.zshrc или просто перезапустите терминал. Проверка результата простая: команда adb version должна вывести номер версии, а не ошибку «команда не найдена».
⚠️ Внимание: после изменения переменных среды на Windows перезапустите все открытые терминалы и IDE — уже запущенные программы не подхватывают новые значения автоматически.
Проверка установки и подключение устройства
Проверьте корректность установки пошагово. Сначала выполните sdkmanager --list_installed — команда покажет все установленные пакеты. Затем подключите Android-устройство по USB, предварительно включив на нём отладку по USB в разделе Настройки → Для разработчиков.
Команда adb devices должна показать подключённое устройство со статусом device. Если вместо этого статус unauthorized — на экране смартфона нужно подтвердить разрешение на отладку. Если список пуст, возможная причина — отсутствие USB-драйверов на Windows: они устанавливаются через SDK Manager, пакет Google USB Driver, либо с сайта производителя устройства.
| Компонент | Назначение | Как проверить |
|---|---|---|
| Platform Tools | adb, fastboot | adb version |
| SDK Platform | Платформа конкретной версии Android | sdkmanager --list_installed |
| Build-Tools | Инструменты сборки APK | Сборка проекта в Gradle |
| Emulator | Эмулятор Android | Запуск AVD из Device Manager |
| Google USB Driver | Драйвер устройства для Windows | adb devices показывает аппарат |
Для эмулятора создайте виртуальное устройство через Device Manager в Android Studio или командой avdmanager. Учтите, что эмулятор требует включённой виртуализации в BIOS/UEFI — без неё он либо не запустится, либо будет работать крайне медленно.
Типичные ошибки при установке и их решение
Одна из частых проблем — ошибка лицензий при сборке проекта: Failed to install the following Android SDK packages as some licences have not been accepted. Решается командой sdkmanager --licenses с подтверждением каждой лицензии клавишей y. После этого сборка обычно проходит без повторной настройки.
Если SDK Manager не видит установленные пакеты, проверьте путь к SDK в настройках: в Android Studio это File → Settings → Languages & Frameworks → Android SDK. Путь должен указывать именно на корневой каталог SDK, а не на вложенную папку platform-tools или platforms.
Медленная загрузка компонентов или обрывы соединения чаще связаны с сетью, а не с самим SDK. Попробуйте повторить установку позже или через другое подключение. Антивирус и файрвол также могут блокировать загрузку — временно добавьте установщик в исключения, если скачивание стабильно прерывается.
⚠️ Внимание: не переносите каталог SDK вручную после установки без смены путей в настройках IDE и переменных среды — это ломает ссылки на компоненты, и проекты перестанут собираться.
⚠️ Внимание: не скачивайте Android SDK со сторонних сайтов и «сборок». Официальный дистрибутив распространяется бесплатно через сайт разработчиков Android, а сторонние источники — риск получить устаревшую или модифицированную версию.
Часто задаваемые вопросы
Можно ли установить Android SDK без Android Studio?
Да. Для этого существуют Command line tools — с помощью утилиты sdkmanager устанавливаются платформы, build-tools и platform-tools. Для задач вроде adb достаточно отдельного архива SDK Platform Tools, который вообще не требует установки.
Сколько места занимает Android SDK?
Точный объём зависит от набора компонентов: минимальный комплект с одной платформой занимает заметно меньше, чем полный набор с несколькими версиями Android и образами эмулятора. Закладывайте запас в несколько гигабайт и при необходимости удаляйте неиспользуемые платформы через SDK Manager.
Что делать, если adb не видит устройство?
Проверьте, что на устройстве включена отладка по USB в разделе «Для разработчиков», попробуйте другой USB-кабель и порт. На Windows убедитесь, что установлен USB-драйвер устройства. Также помогает перезапуск сервера командой adb kill-server с последующим adb devices.
Нужно ли устанавливать JDK отдельно?
Как правило, нет — актуальные версии Android Studio поставляются со встроенной средой Java. Отдельный JDK может понадобиться только для специфических задач или при работе с командной строкой вне среды разработки.
Как обновить Android SDK до новой версии?
Откройте SDK Manager в Android Studio и установите новые платформы и инструменты на вкладках SDK Platforms и SDK Tools, либо выполните sdkmanager с указанием нужных пакетов. Старые версии можно оставить — они не мешают работе и нужны для поддержки проектов под прежние версии Android.