Что такое Min SDK?

Что такое Min SDK в Android?

Min SDK (Minimum SDK Version) — это минимальная версия Android API, с которой совместимо ваше приложение. Этот параметр указывается в файле build.gradle (module-level) и определяет самую старую версию Android, на которой может работать ваше приложение.

Техническое определение

Min SDK — это числовое значение (например, 21, 24, 28), соответствующее уровню API (API Level). Каждой версии Android присвоен уникальный API Level:

• Android 5.0 (Lollipop) → API 21
• Android 7.0 (Nougat) → API 24
• Android 9.0 (Pie) → API 28
• Android 13 (Tiramisu) → API 33

В build.gradle это выглядит так:

android {
    defaultConfig {
        minSdk = 24 // Приложение будет работать на Android 7.0 и выше
        targetSdk = 34
        compileSdk = 34
    }
}

Зачем нужен Min SDK?

1. Определение аудитории приложения

Чем ниже Min SDK, тем больше устройств сможет установить ваше приложение. Однако слишком низкое значение может ограничить использование современных API.

2. Контроль совместимости

Android Studio и система сборки используют Min SDK для:

• Предупреждений о вызове API, недоступных на указанной минимальной версии
• Автоматического скрытия новых функций в манифесте для старых устройств
• Правильной компиляции ресурсов и библиотек

3. Управление функциями приложения

Разработчики должны явно проверять доступность API на устройствах с разными версиями:

// Пример: использование BiometricPrompt, доступного с API 28
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
    // Используем современный BiometricPrompt
    val biometricPrompt = BiometricPrompt.Builder(context)
        .setTitle("Вход по отпечатку")
        .build()
} else {
    // Fallback для старых версий
    // Используем FingerprintManager или другой метод
}

Как выбрать правильный Min SDK?

Факторы при выборе:

1. Статистика использования Android-версий

   • Анализ Google Play Console (раздел "Статистика по версиям Android")
   • Данные с открытых источников (например, Android Dashboard)

2. Требования к функциям приложения

   • Если нужен BiometricPrompt → Min SDK ≥ 28 (Android 9.0)
   • Для WorkManager с корутинами → Min SDK ≥ 23 (Android 6.0)
   • Для ViewBinding → Min SDK ≥ 7 (но обычно выше)

3. Библиотеки и зависимости

   • Современные библиотеки (Jetpack Compose, Room с новыми функциями) могут требовать более высокий Min SDK
   • Библиотеки поддержки (Support Libraries) постепенно упраздняются в пользу AndroidX

4. Рекомендации Google

   • Google рекомендует поддерживать версии, которые используют не менее 5% пользователей
   • Актуальные приложения обычно имеют Min SDK ≥ 21 (охватывает ~95% устройств)

Практические аспекты работы с Min SDK

Проблемы и решения:

// ПРОБЛЕМА: Использование нового API на старых устройствах
fun playHapticFeedback(view: View) {
    // performHapticFeedback с новыми константами доступен с API 28
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
        view.performHapticFeedback(HapticFeedbackConstants.CONFIRM)
    } else {
        view.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY)
    }
}

// ПРОБЛЕМА: Разные манифесты для разных версий
// Решение: использование условий в манифесте или проверок в коде

Лучшие практики:

• Регулярно пересматривайте Min SDK (раз в 6-12 месяцев)
• Используйте линтинг для обнаружения проблем совместимости
• Тестируйте на эмуляторах с минимальной поддерживаемой версией
• Предусматривайте graceful degradation — плавное снижение функциональности на старых устройствах

Min SDK vs Target SDK vs Compile SDK

Важно не путать эти понятия:

Заключение

Правильный выбор Min SDK — это баланс между охватом аудитории и использованием современных технологий. Слишком низкое значение ограничивает возможности разработки, слишком высокое — сокращает потенциальную аудиторию. Современные приложения обычно поддерживают Android 5.0+ (API 21+) или Android 8.0+ (API 26+), что обеспечивает баланс между совместимостью и доступом к ключевым современным API. Регулярный анализ статистики и требований проекта поможет принимать взвешенные решения о выборе минимальной поддерживаемой версии.