Что такое Android Platform и Platform Version и как проверить API level

Android Platform — это сама ОС Android (ядро, службы, драйверы и оболочка). Platform Version — конкретный релиз (например, Android 14), а API level — числовой идентификатор этого релиза (например, API 34). Уточнить их можно через Настройки, ADB, специальные приложения или в коде — ниже кратко и пошагово.

Коротко: термины и зачем это нужно

• Android Platform — экосистема ОС, включающая ядро Linux, системные сервисы и интерфейс.
• Platform Version — пользовательское имя релиза (Android 14, 15 и т.д.).
• API level — целочисленный номер, который используют разработчики для проверки доступных API и совместимости (Build.VERSION.SDK_INT = 34). Зачем это знать: совместимость приложений, требования Google Play, доступ к новым функциям и безопасность.

Как узнать версию и API level (пошагово)

1. Через настройки (самый простой способ)
   • Откройте Настройки → О телефоне (или Система → О телефоне).
   • Посмотрите «Версия Android» (Platform Version) — там будет строка вроде Android 14.
   • Часто рядом указывают «Уровень безопасности» и иногда «API level». Если нет — используйте один из способов ниже.

2. Через ADB (для разработчиков)

   • Включите "Отладку по USB" в Параметры разработчика (тапните 7 раз по Номер сборки, если режим не активирован).
   • Подключите к ПК и выполните: adb shell getprop ro.build.version.sdk
   • Вывод: целое число — это API level (например, 34).

3. Через приложение на устройстве

   • Установите любое приложение для информации об устройстве (например, CPU-Z или любое System Info).
   • В разделе System / OS увидите точную версию и API level.

4. В коде Android-приложения

   • Получить текущий API level:

     val api = android.os.Build.VERSION.SDK_INT
     ```
   - Проверка при использовании новых API:
     
```kotlin
     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
         // код для Android 14+
     }
     ```

### Быстрая таблица способов
<div class="table-container"><table style="border-collapse: collapse; width: 100%; margin: 16px 0;"><thead><tr><th style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; background: #f9fafb; font-weight: 600;">Способ</th><th style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; background: #f9fafb; font-weight: 600;">Что показывает</th><th style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; background: #f9fafb; font-weight: 600;">Нужны права</th></tr></thead><tbody><tr><td style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; vertical-align: top;">Настройки</td><td style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; vertical-align: top;">Версия Android, патч</td><td style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; vertical-align: top;">Нет</td></tr><tr><td style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; vertical-align: top;">ADB</td><td style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; vertical-align: top;">Только API level (точно)</td><td style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; vertical-align: top;">Отладка по USB</td></tr><tr><td style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; vertical-align: top;">Приложение</td><td style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; vertical-align: top;">Версия + API + кодовое имя</td><td style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; vertical-align: top;">Нет (установка)</td></tr><tr><td style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; vertical-align: top;">Код</td><td style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; vertical-align: top;">API в рантайме</td><td style="border: 1px solid #e5e7eb; padding: 8px; text-align: left; vertical-align: top;">Только при разработке</td></tr></tbody></table></div>


## Что важно разработчикам и пользователям
- Для публикации в Google Play указывайте minSdkVersion и targetSdkVersion. Рекомендуется держать target на актуальном API.
- Устаревшие API (ниже ~30) ограничивают доступ к новым функциям и ухудшают безопасность.
- API level растёт вместе с крупными релизами: Android 10 — API 29, Android 11 — 30, ..., Android 14 — 34, Android 15 — 35 (статус на 2026).
- Для поддержки функций (Scoped Storage, новые разрешения, AI-фичи) используйте условную проверку API перед вызовом новых API.

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

• Ожидание увидеть «API level» прямо в интерфейсе — не всегда показывается в стандартных настройках.
• Использование только Android версии (14, 15) без проверки API level в коде — некоторые API могут иметь разные уровни.
• Попытка тестировать новые API без включённой отладки или без корректного targetSdkVersion — ошибки на этапе сборки/рантайма.

FAQ

• Как быстро узнать, установлен ли у меня Android 14?
  • Откройте Настройки → О телефоне — там будет «Android 14». Через ADB команда вернёт 34.
• Можно ли изменить API level вручную?
  • Нет: API level определяется системой: только обновление ОС повышает его.
• Что важнее в манифесте — minSdkVersion или targetSdkVersion?
  • minSdkVersion определяет минимальную поддерживаемую ОС. targetSdkVersion показывает, под какие поведенческие изменения ОС оптимизировано приложение — держите его актуальным.

Эти шаги позволят быстро определить Platform Version и точный API level устройства и принять необходимые меры для совместимости приложений или обновления системы.