Кнопка SDK Manager в Android Studio неактивна, а пункт меню не открывает окно менеджера пакетов — чаще всего причина в том, что путь к Android SDK не задан в настройках среды либо сам SDK установлен не полностью. Проверить это можно за минуту: откройте настройки проекта и посмотрите, указан ли каталог SDK в разделе Languages & Frameworks → Android SDK.
SDK Manager — это штатный инструмент Android Studio для загрузки и обновления компонентов Android SDK: платформ, инструментов сборки, эмуляторов и системных образов. Без него невозможно собрать и протестировать приложение, поэтому умение запускать менеджер и управлять пакетами — базовый навык разработчика. Ниже разберём все способы запуска, типичные ошибки и их решения.
Что такое SDK Manager и зачем он нужен
SDK Manager входит в состав Android Studio и отвечает за управление компонентами SDK. Через него устанавливаются версии платформы Android (API levels), SDK Build-Tools, Platform-Tools (включая adb и fastboot), драйверы USB и образы системы для эмулятора.
Без установленных пакетов среда разработки не сможет скомпилировать проект под нужную версию Android. Поэтому первым делом после установки Android Studio обычно открывают именно SDK Manager и проверяют наличие необходимых компонентов.
- 📦 SDK Platforms — пакеты платформ для конкретных версий Android.
- 🔧 SDK Tools — инструменты сборки, эмулятор, Platform-Tools.
- 🖼️ System Images — образы системы для виртуальных устройств.
- 🔄 Обновления — менеджер показывает доступные новые версии пакетов.
Запуск SDK Manager из Android Studio
Самый простой способ — открыть менеджер через интерфейс среды. На стартовом экране Android Studio (когда ни один проект не открыт) нажмите More Actions → SDK Manager. Если проект уже открыт, путь будет другим: File → Settings (в macOS — Android Studio → Preferences), затем перейдите в Appearance & Behavior → System Settings → Android SDK.
Есть и более быстрый вариант — кнопка с иконкой SDK Manager на панели инструментов в правой верхней части окна. Один клик открывает то же окно управления пакетами.
☑️ Запуск SDK Manager через Android Studio
После нажатия Apply появится окно подтверждения со списком изменений и лицензионным соглашением. Примите условия — начнётся загрузка выбранных компонентов. Ход установки отображается в нижней части окна.
Запуск из командной строки
Для автоматизации и работы на серверах без графического интерфейса существует консольная утилита sdkmanager. Она находится в каталоге SDK, в подпапке cmdline-tools/latest/bin (в старых версиях SDK — в tools/bin). Точное расположение зависит от того, куда установлен SDK на вашем компьютере.
Чтобы вывести список установленных и доступных пакетов, выполните в терминале:
sdkmanager --list
Установка конкретного пакета выполняется командой с именем в кавычках, например:
sdkmanager "platform-tools" "platforms;android-34"
⚠️ Внимание: для работы утилитыsdkmanagerтребуется установленная Java (JDK). Если при запуске появляется ошибка проJAVA_HOME, проверьте, что переменная окружения указывает на каталог с JDK, а сама Java установлена в системе.
Где находится каталог Android SDK
Расположение SDK зависит от операционной системы и от того, меняли ли вы путь при установке. Узнать актуальный путь можно прямо в Android Studio: он указан в поле Android SDK Location в окне SDK Manager. Это самый надёжный способ — не гадать по стандартным путям, а посмотреть реальное значение в настройках.
| ОС | Типичный путь к SDK | Как проверить |
|---|---|---|
| Windows | C:\Users\Имя\AppData\Local\Android\Sdk | Поле SDK Location в настройках |
| macOS | ~/Library/Android/sdk | Поле SDK Location в Preferences |
| Linux | ~/Android/Sdk | Поле SDK Location в настройках |
| Любая ОС | Пользовательский путь | Задаётся при установке или в настройках |
Папка AppData в Windows скрыта по умолчанию. Чтобы попасть в неё через проводник, включите отображение скрытых элементов или вставьте путь напрямую в адресную строку.
SDK Manager не запускается: типичные причины
Если окно менеджера не открывается или сразу закрывается, причин обычно несколько. Начните с простых проверок, прежде чем переустанавливать что-либо.
- 🚫 Не задан путь к SDK — поле Android SDK Location пустое или указывает на несуществующий каталог.
- ☕ Проблемы с Java — отсутствует JDK или неверно настроена переменная
JAVA_HOME(актуально для консольного варианта). - 🔒 Недостаточно прав — SDK установлен в системный каталог, и менеджер не может записывать файлы.
- 🌐 Блокировка сети — прокси или файрвол мешает загрузке списка пакетов.
- 🗂️ Кириллица или пробелы в пути — в некоторых конфигурациях это вызывает сбои.
Если путь к SDK указан, но менеджер всё равно не работает, попробуйте запустить Android Studio от имени администратора. В случае консольной утилиты внимательно прочитайте текст ошибки в терминале — он обычно прямо указывает на проблему.
⚠️ Внимание: не перемещайте и не переименовывайте папку SDK вручную, пока Android Studio на неё ссылается. Сначала измените путь в настройках среды, иначе среда потеряет все компоненты, и проекты перестанут собираться.
Что делать, если пакеты не загружаются
Проверьте интернет-соединение и настройки прокси в разделе Appearance & Behavior → System Settings → HTTP Proxy. Если используется корпоративный прокси, укажите его параметры там. Также попробуйте очистить кэш через File → Invalidate Caches и перезапустить среду.
Установка и обновление компонентов
Работа с менеджером построена одинаково: отметьте галочками нужные пакеты на вкладке SDK Platforms или SDK Tools и нажмите Apply. Чтобы увидеть отдельные версии инструментов, включите флажок Show Package Details в правом нижнем углу окна.
Для удаления ненужных компонентов снимите галочку и снова нажмите Apply — менеджер деинсталлирует пакет. Устаревшие версии платформ можно смело удалять, если вы не поддерживаете старые проекты.
Автоматизация через командную строку
Консольный sdkmanager незаменим при настройке CI/CD и удалённых машин. Принять все лицензии разом можно командой:
sdkmanager --licenses
Обновление всех установленных пакетов выполняется так:
sdkmanager --update
Эти команды удобно включать в скрипты первичной настройки рабочего окружения. Учтите, что на машине без графического интерфейса это единственный способ управлять SDK.
⚠️ Внимание: при первом запуске консольного менеджера на новой машине сначала примите лицензии — без этого сборка проектов через Gradle может завершаться ошибкой лицензионного соглашения.
Часто задаваемые вопросы
Где кнопка SDK Manager в Android Studio?
На стартовом экране — в меню More Actions. В открытом проекте — на панели инструментов справа вверху или через File → Settings → Android SDK.
Можно ли пользоваться SDK Manager без Android Studio?
Да, через консольную утилиту sdkmanager из пакета command line tools. Она скачивается отдельно с официального сайта для разработчиков Android и работает без графической среды.
Почему SDK Manager показывает ошибку при загрузке пакетов?
Возможные причины: нестабильное соединение, блокировка прокси или файрволом, недостаток прав на запись в каталог SDK. Проверьте настройки прокси в Android Studio и права доступа к папке SDK.
Что делать, если sdkmanager не находит Java?
Установите JDK и убедитесь, что переменная окружения JAVA_HOME указывает на каталог установки Java. После изменения переменных перезапустите терминал.
Можно ли изменить папку установки SDK?
Да. Укажите новый путь в поле Android SDK Location в окне SDK Manager и дождитесь, пока среда загрузит компоненты в новое расположение. Переносить файлы вручную не требуется.