Как запустить SDK Manager: полное руководство

Кнопка 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

Выполнено: 0 / 5

После нажатия Apply появится окно подтверждения со списком изменений и лицензионным соглашением. Примите условия — начнётся загрузка выбранных компонентов. Ход установки отображается в нижней части окна.

📊 Как вы обычно запускаете SDK Manager?
Через меню File → Settings
Через кнопку на панели инструментов
Со стартового экрана Android Studio
Из командной строки

Запуск из командной строки

Для автоматизации и работы на серверах без графического интерфейса существует консольная утилита 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Как проверить
WindowsC:\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 и дождитесь, пока среда загрузит компоненты в новое расположение. Переносить файлы вручную не требуется.