Android SDK Manager не запускается отдельным ярлыком в новых версиях Android Studio — вместо старого автономного окна доступен встроенный менеджер через меню Tools → SDK Manager или командная строка sdkmanager. Это первое, что нужно проверить, если привычная иконка SDK Manager пропала после обновления среды разработки.
Android SDK Manager — это инструмент управления компонентами Android SDK: платформами API, инструментами сборки, эмуляторными образами и драйверами. Без корректно установленных пакетов проект не соберётся, а эмулятор не запустится. Ниже разберём, как открыть менеджер, какие компоненты ставить в первую очередь и как устранять типичные ошибки загрузки.
Что такое Android SDK Manager и зачем он нужен
SDK Manager входит в состав Android Studio и отвечает за загрузку, обновление и удаление пакетов SDK. Каждый уровень API (например, Android 13 — API 33, Android 14 — API 34) требует отдельной платформы, а сборка проекта невозможна без Android SDK Build-Tools и Android SDK Platform-Tools, куда входят adb и fastboot.
Нужно понимать разницу: SDK Platform содержит библиотеки конкретной версии Android для компиляции, а SDK Tools — вспомогательные утилиты, независимые от версии платформы. Путаница между ними — частая причина ошибок сборки вида «failed to find target with hash string».
Как открыть SDK Manager в Android Studio
Существует несколько способов открыть менеджер. Самый простой — через главное меню: Tools → SDK Manager. Альтернатива — значок SDK Manager на панели инструментов (кубик со стрелкой вниз) либо пункт More Actions → SDK Manager на приветственном экране, если ни один проект не открыт.
В открывшемся окне две основные вкладки: SDK Platforms — список версий Android, и SDK Tools — инструменты разработчика. Чтобы увидеть точные версии пакетов, а не только их названия, включите флажок Show Package Details в правом нижнем углу окна.
- 📦 SDK Platforms — платформы для каждого уровня API, нужные для компиляции
- 🛠️ SDK Build-Tools — компиляторы и утилиты сборки конкретной версии
- 📱 SDK Platform-Tools —
adb,fastbootи другие утилиты взаимодействия с устройством - 🖥️ System Images — образы системы для эмулятора (x86_64 или ARM)
- 🔌 Google USB Driver — драйвер для отладки на физических устройствах под Windows
Какие компоненты устанавливать в первую очередь
Минимальный рабочий набор для сборки и запуска проекта: одна платформа SDK (та, что указана в compileSdk вашего проекта), последняя стабильная версия Build-Tools, Platform-Tools и, при необходимости, образ эмулятора. Версия compileSdk прописана в файле build.gradle модуля приложения — сверьтесь с ней перед установкой платформы.
Не обязательно ставить все доступные версии Android. Каждая платформа и системный образ занимают заметное место на диске: системные образы эмулятора особенно «тяжёлые». Разумнее устанавливать только те API-уровни, под которые реально собирается и тестируется проект.
☑️ Минимальный набор для старта
Управление SDK через командную строку
Для серверов сборки и работы без графического интерфейса используется консольная утилита sdkmanager, расположенная в каталоге SDK по пути cmdline-tools/latest/bin/. Просмотр установленных и доступных пакетов выполняется командой:
sdkmanager --listУстановка конкретного пакета выполняется по его идентификатору из списка, например:
sdkmanager "platforms;android-34" "build-tools;34.0.0"При первом запуске утилита потребует принять лицензионные соглашения — это делается командой sdkmanager --licenses с подтверждением каждого пункта клавишей y. Без принятия лицензий сборка в CI-средах обычно завершается ошибкой.
⚠️ Внимание: устаревшая утилитаandroidиз старых версий SDK Tools давно удалена из состава SDK. Инструкции, предлагающие запускатьandroid sdkилиandroid update sdk, относятся к устаревшим версиям и не сработают — используйтеsdkmanager.
Типичные ошибки SDK Manager и их решение
Одна из распространённых проблем — зависание или сбой загрузки пакетов с сетевыми ошибками. Возможные причины: блокировка соединения файрволом или антивирусом, работа через прокси, который не настроен в Android Studio, либо повреждённый временный кэш загрузки. Проверьте настройки прокси в File → Settings → Appearance & Behavior → System Settings → HTTP Proxy.
Ещё один частый симптом — Android Studio не видит установленный SDK. В этом случае откройте File → Project Structure → SDK Location и убедитесь, что путь указывает на реальный каталог SDK. Обратите внимание: в пути к SDK не должно быть кириллических символов и пробелов — это известный источник сбоев сборки на Windows.
| Ошибка | Вероятная причина | Решение |
|---|---|---|
| Failed to find Platform SDK | Не установлена платформа под compileSdk | Установить нужный API-уровень в SDK Platforms |
| License not accepted | Не приняты лицензии SDK | Выполнить sdkmanager --licenses |
| Пакеты не загружаются | Прокси, файрвол или повреждённый кэш | Проверить HTTP Proxy, переустановить пакет |
| SDK not found | Неверный путь к SDK или кириллица в пути | Указать корректный путь в Project Structure |
| Emulator не запускается | Нет системного образа или отключена виртуализация | Установить System Image, включить виртуализацию в BIOS/UEFI |
⚠️ Внимание: не удаляйте вручную папки внутри каталога SDK, пока Android Studio запущена. Удаление компонентов выполняйте через SDK Manager — снятием флажка с пакета и нажатием Apply.
Обновление и удаление компонентов
Обновления пакетов отображаются в SDK Manager пометкой о доступной новой версии либо со значком в колонке статуса. Установка обновления выполняется тем же флажком и кнопкой Apply. Для Platform-Tools и Build-Tools обновления выходят регулярно, и их стоит ставить — новые версии adb исправляют ошибки подключения к устройствам.
Для удаления ненужного компонента снимите его флажок и подтвердите действие. Учтите, что удаление платформы, на которую ссылается compileSdk открытого проекта, приведёт к ошибкам синхронизации Gradle — перед удалением проверьте, какие версии реально используются.
Где хранятся файлы SDK по умолчанию
На Windows — обычно в профиле пользователя: C:\Users\Имя\AppData\Local\Android\Sdk. На macOS — ~/Library/Android/sdk, на Linux — ~/Android/Sdk. Точный путь всегда виден в File → Project Structure → SDK Location.
Настройка SDK без Android Studio
Если нужна только командная строка (например, для CI/CD или работы с adb), можно установить command line tools отдельно, без полной Android Studio. Архив скачивается с официального сайта для разработчиков Android, распаковывается, после чего через sdkmanager ставятся нужные пакеты.
Важный нюанс: утилита ожидает определённую структуру каталогов — папка с инструментами должна находиться по пути cmdline-tools/latest/ внутри каталога SDK. При нарушении структуры sdkmanager выдаёт предупреждение о некорректном расположении. После установки полезно прописать путь к platform-tools в переменную окружения PATH, чтобы adb был доступен из любого каталога.
Часто задаваемые вопросы
Почему в Android Studio нет отдельного приложения SDK Manager?
Автономный SDK Manager был исключён из состава SDK — его функции перенесены в Android Studio (Tools → SDK Manager) и консольную утилиту sdkmanager. Это нормальное поведение актуальных версий, а не признак неполной установки.
Как узнать, какие пакеты SDK уже установлены?
Откройте SDK Manager и включите Show Package Details — установленные пакеты помечены флажками. Из командной строки список показывает команда sdkmanager --list_installed.
Можно ли перенести SDK на другой диск?
Да. Скопируйте каталог SDK в новое расположение и укажите новый путь в File → Project Structure → SDK Location. Убедитесь, что в новом пути нет кириллицы и пробелов, и обновите переменные окружения, если они использовались.
Что делать, если sdkmanager выдаёт ошибку про Java?
Утилите требуется совместимая версия JDK. Проще всего использовать JDK, встроенную в Android Studio, указав путь к ней в переменной JAVA_HOME. Точные требования к версии Java зависят от версии инструментов — сверяйтесь с официальной документацией.
Нужно ли устанавливать все версии Android в SDK Platforms?
Нет. Достаточно платформы под compileSdk вашего проекта и системных образов тех версий, на которых планируется тестирование. Лишние пакеты только занимают место на диске.