Что такое Android SDK и как с ним работать

Android SDK — это набор инструментов (компиляторы, эмуляторы, ADB, build-tools и платформы) для создания, тестирования и сборки Android‑приложений. Установите SDK через Android Studio или отдельно командными утилитами, добавьте platform‑tools в PATH и обновляйте через SDK Manager или sdkmanager — это обеспечит совпадение версий API и отсутствие ошибок сборки.

Компоненты и зачем они нужны

  • Android Studio — рекомендуемая IDE с графическим редактором, шаблонами и встроенным SDK Manager.
  • Platform‑tools — ADB и Fastboot для отладки и управления устройствами.
  • Build‑tools — Gradle, AAPT и другие утилиты для сборки APK/AAB.
  • SDK Platforms — пакеты API (например, android-35) с фреймворком для каждой версии. Эти компоненты позволяют компилировать Kotlin/Java в байт-код ART/Dalvik, тестировать на эмуляторе и подписывать релизы.

Быстрая установка (рекомендованный путь)

  1. Скачайте и установите Android Studio (инсталлятор включает SDK).
  2. В ходе установки выберите профиль Standard (скачаются Platform‑tools, Emulator, Build‑tools).
  3. При первом запуске откройте Tools → SDK Manager и отметьте нужные SDK Platforms и SDK Tools.
  4. Укажите путь SDK (по умолчанию: ~/Android/Sdk на macOS/Linux, C:\Users<User>\AppData\Local\Android\Sdk на Windows).
  5. Примите лицензии и дождитесь загрузки.

Если не хотите устанавливать Studio, можно использовать только command line tools и sdkmanager (см. следующий раздел).

Установка и обновление через командную строку

  • Скачать только инструменты командной строки (command‑line tools), разархивировать и использовать sdkmanager.
  • Установить базовый набор: sdkmanager "platform-tools" "platforms;android-35" "build-tools;35.0.0"
  • Принять лицензии: sdkmanager --licenses
  • Обновить всё сразу: sdkmanager --update
  • Обновить конкретные пакеты: sdkmanager "platforms;android-35" "build-tools;35.0.0"

После установки проверьте adb: adb version

Настройка переменных окружения

Windows (PowerShell): $env:ANDROID_HOME = "C:\Users\Your\AppData\Local\Android\Sdk" setx PATH "%PATH%;%ANDROID_HOME%\platform-tools"

macOS/Linux (bash/zsh): export ANDROID_HOME="$HOME/Android/Sdk" export PATH="$PATH:$ANDROID_HOME/platform-tools"

Перезапустите терминал и проверьте adb version.

Практические советы и совместимость

  • Поддерживайте Java 17+ для современных сборок.
  • Для новых приложений целитесь на текущий API (например, api 35) — Play Store требует актуальные уровни API для релизов.
  • После обновления инструментов выполните: ./gradlew clean && ./gradlew assembleDebug, чтобы избежать проблем кеша.
  • Эмуляторы и образы систем занимают много места — удаляйте ненужные платформы через SDK Manager.

Не смешивайте версии build-tools и плагина Gradle: устаревшие инструменты часто вызывают ошибки сборки. Всегда обновляйте зависимости вместе с SDK.

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

  • ADB not found — platform-tools не в PATH или терминал не перезапущен.
  • Licenses not accepted — выполните sdkmanager --licenses и примите.
  • Build failed (minSdk/targetSdk mismatch) — проверьте значения minSdkVersion и targetSdkVersion в build.gradle и установите соответствующие платформы.
  • Медленная загрузка — используйте зеркала или менеджер SDK в Android Studio → Settings → Appearance & Behavior → System Settings → Android SDK → SDK Update Sites.

FAQ

  • Нужна ли Android Studio для разработки? Нет, можно работать через editor + command line tools, но Studio упрощает настройку и отладку.
  • Как освободить место? Удалите старые SDK Platforms и ненужные system images через SDK Manager.
  • Как заставить Gradle использовать новую платформу? Обновите compileSdkVersion/targetSdkVersion в build.gradle и установите соответствующую платформу через SDK Manager.