Android SDK Platforms: что это в Android Studio и какие версии устанавливать

Android SDK Platforms — это набор файлов (android.jar, системные файлы, документация), по которым компилируется приложение под конкретный API level. Установите последнюю стабильную платформу (для compileSdk/targetSdk) и 1–2 предыдущие версии; старые API ставьте только если проект этого требует.

Что такое Android SDK Platforms и где их найти

Android SDK Platform = комплект файлов для каждой версии Android (маркетинговое имя ↔ API level). Он нужен компилятору, эмуляторам и для тестов. В пакете обычно: android.jar, метаданные, опциональная документация.

Где управлять:

  • Android Studio → File → Settings → Appearance & Behavior → System Settings → Android SDK.
  • Вкладки: "SDK Platforms" — версии, "SDK Tools" — platform-tools, build-tools, NDK и т.п.

Установка платформы требуется, чтобы ваш проект собрался с указанным compileSdk/targetSdk; minSdk не требует локальной платформы.

API level — технический номер (33, 34). Версия Android (13, 14) — маркетинговое имя.

Какие версии ставить: правила и практические примеры

Основные правила:

  • compileSdk — ставьте максимально свежую стабильную версию (чтобы иметь доступ к новым API).
  • targetSdk — поднимайте до актуального при тестировании; Google требует актуальности для публикации.
  • minSdk — как можно ниже для бизнеса, но учитывайте поддержку в коде (backports, проверки).

Рекомендации для разных сценариев:

  • Новый проект: установите последнюю стабильную платформу + 1–2 предыдущие (например, API 34, 33, 31/32) и 1–2 эмулятора (последний + распространённый).
  • Существующий проект: откройте app/build.gradle и поставьте ту платформу, что указана в compileSdk. Если хотите поднять compile/target — тестируйте, потому что это может изменить поведение приложений.
  • Поддержка очень старых устройств: ставьте старые платформы только при реальной необходимости (корпоративный софт, терминалы, специфичные баги).

Если проект требует android-34 — просто установите SDK Platform API 34 через SDK Manager; не понижайте compileSdk, чтобы избегать установки новой платформы.

Как экономить место и управлять SDK

Практики экономии:

  • Удаляйте неиспользуемые платформы в SDK Manager (по compileSdk ваших проектов).
  • Держите 1–3 образа эмуляторов (последний + один стабильный + реальное устройство при наличии).
  • Перенесите SDK на диск с большим объёмом и укажите путь в настройках Android Studio; обновите ANDROID_SDK_ROOT при использовании CLI.
  • Используйте CI для тяжёлых сборок и тестов, держа локально минимальный набор.

Не устанавливайте Preview/Canary платформы в рабочем окружении, если только вы не тестируете новые API целенаправленно.

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

  • Снимать с себя ответственность: понижать compileSdk чтобы избежать установки новой платформы — приводит к уязвимостям и несовместимостям.
  • Устанавливать десятки эмуляторов «про запас» — расход диска и времени обновлений.
  • Пытаться запускать проект без установки требуемой платформы — ошибка сборки типа "Failed to find target with hash string 'android-XX'".

FAQ

  • Нужно ли ставить платформу для minSdk?
    Нет: minSdk описывает минимальную поддержку; для сборки важны compileSdk/targetSdk.

  • Что делать, если проект требует API, которого нет локально?
    Откройте SDK Manager → SDK Platforms → установите нужный API и перезапустите сборку.

  • Какой набор образов для эмуляторов выбрать?
    Достаточно 2–3: самый новый, наиболее распространённый по рынку и один для специфичных тестов (например, low‑end).

Короткий чек‑лист: для нового проекта — последняя платформа + 1–2 предыдущие; для старого — ставьте то, что указано в Gradle; экономьте место, управляя эмуляторами и переносом SDK на отдельный диск.