Быстрая установка Android SDK Tools на Windows без Android Studio

Кратко: скачайте Command Line Tools, установите JDK 17/21, распакуйте в C:\Android\cmdline-tools\latest, задайте ANDROID_HOME и PATH, затем выполните sdkmanager для platform-tools, platforms;android-35 и build-tools.

Что скачать

  • Command Line Tools (файл вида commandlinetools-win-*.zip) — это минимальный набор утилит (sdkmanager, avdmanager и т.п.).
  • JDK 17 или 21 (OpenJDK) — требование для современных сборок и sdkmanager.
  • Опционально: эмулятор и HAXM/Hypervisor для запуска виртуальных устройств.

Распакуйте ZIP в папку без пробелов, например C:\Android\cmdline-tools\latest — это важно, иначе sdkmanager не найдёт инструменты.

Пошаговая установка

  1. Создайте структуру папок:

    • C:\Android\cmdline-tools\latest\ (внутри — содержимое распакованного архива cmdline-tools) Примечание: внутри папки cmdline-tools должна быть папка latest с bin и другими файлами — если архив даёт папку с именем версии, переименуйте её в latest.

  2. Установите JDK (17 или 21) и проверьте:

    • В командной строке: java -version
    • Убедитесь, что версия JDK отображается и равна 17+.

  3. Настройте системные переменные (Панель управления → Система → Дополнительные параметры → Переменные среды):

    • Новая переменная: ANDROID_HOME = C:\Android
    • Добавьте в PATH (системный PATH):
      • %ANDROID_HOME%\cmdline-tools\latest\bin
      • %ANDROID_HOME%\platform-tools
      • %ANDROID_HOME%\emulator

    Перезапустите терминал после изменений.

  4. Установите базовые пакеты через sdkmanager: Откройте командную строку и выполните:

   sdkmanager "platform-tools" "platforms;android-35" "build-tools;35.0.0"

При первом запуске примите лицензии:

   sdkmanager --licenses

Проверка:

   sdkmanager --list
   adb version
  1. Эмулятор (опционально):
   sdkmanager "emulator" "system-images;android-35;google_apis;x86_64"

Для аппаратного ускорения на Intel установите HAXM (если требуется) или используйте встроенный гипервизор Windows. Без аппаратного ускорения эмулятор будет медленным.

Эмулятор требует поддержки виртуализации (Intel HAXM или Hyper-V/Windows Hypervisor). Если виртуализация выключена в BIOS/UEFI, эмулятор не запустится.

Настройка для сборки и интеграции

  • Если сборка требует другого sdk_root, можно передать путь явно:
  sdkmanager --sdk_root=C:\Android "platforms;android-35"
  • Для Gradle/React Native в файле локальных настроек укажите ANDROID_SDK_ROOT или ANDROID_HOME, чтобы инструменты сборки находили SDK. В VS Code используйте расширения, которые читают эти переменные окружения.
  • Добавьте platform-tools в PATH — это даст доступ к adb из любого терминала.

Частые ошибки

  • sdkmanager не найден: проверьте, что %ANDROID_HOME%\cmdline-tools\latest\bin добавлен в PATH и терминал перезапущен.
  • Лицензии не приняты: выполните sdkmanager --licenses и подтвердите y.
  • Неподходящая Java-версия: используйте JDK 17+; старые Java 8 могут вызвать ошибки.
  • Проблемы с прокси: используйте флаги --proxy, --proxy_host и --proxy_port или настройте системные переменные HTTP_PROXY/HTTPS_PROXY.
  • Неправильная структура папок: sdkmanager ожидает структуру ...\cmdline-tools\latest\bin\

FAQ

  • Как обновлять SDK?
    Выполните sdkmanager --update или укажите конкретные пакеты sdkmanager "platform-tools" "build-tools;35.0.0".

  • Можно ли использовать несколько версий платформ?
    Да — просто установите нужные platforms;android-XX через sdkmanager.

  • Нужен ли Android Studio позже?
    Нет, для сборки и CI достаточно Command Line Tools. Android Studio удобна для визуальной отладки и AVD Manager, но не обязательна.

  • Что если хочу GUI для AVD без Studio?
    Можно установить только компоненты эмулятора и использовать avdmanager для создания виртуального устройства, но визуальные инструменты управления AVD в Android Studio удобнее.

Эти шаги дают минимальную, надёжную установку Android SDK Tools на Windows без Android Studio — достаточно для сборки, отладки через adb и интеграции с CI/CD.