Что изменится в поведении если поменять compileSdkVersion, а targetSdkVersion оставить прежним

Влияние изменения compileSdkVersion при сохранении targetSdkVersion

Изменение compileSdkVersion при неизменном targetSdkVersion — это распространённая практика в разработке под Android, которая оказывает точечное влияние на процесс сборки и поведение приложения. Важно понимать, что эти две настройки выполняют разные функции:

• compileSdkVersion определяет, с какой версией SDK компилятор будет проверять ваш код на синтаксическую корректность и предоставлять соответствующие API для компиляции. Это настройка времени сборки.
• targetSdkVersion сообщает системе Android, для какой версии API оптимизировано ваше приложение, и включает или выключает соответствующее поведение совместимости (обратную совместимость). Это настройка времени выполнения.

Что изменится при повышении compileSdkVersion?

1. Доступ к новым API и возможностям компиляции: Вы сможете использовать новые классы, методы и аннотации, добавленные в более свежую версию SDK, в своём исходном коде. Компилятор будет знать о них.

   // Если compileSdkVersion >= 29 (Android 10)
   val windowInsets = window.decorView.rootWindowInsets
   // Этот API стал публичным только в API 29
   

2. Более строгие проверки lint и компилятора: Новые версии инструментов сборки часто приносят дополнительные проверки на безопасность, производительность или устаревшие практики. Это может привести к появлению новых предупреждений или ошибок компиляции, которые потребуют исправления кода.

3. Изменения в генерируемом байткоде (D8/R8): Новые версии SDK часто идут в паре с обновлениями инструментов преобразования (D8) и обфускации (R8), которые могут по-другому оптимизировать и преобразовывать ваш код в .dex-файлы.

4. Обновлённые зависимости AndroidX: Часто обновление compileSdkVersion требует синхронного обновления библиотек AndroidX (appcompat, core-ktx и др.) до версий, совместимых с новым SDK. Это может принести как новые возможности, так и изменения в поведении библиотек.

Что НЕ изменится в поведении приложения?

Ключевой момент: Само по себе изменение compileSdkVersion не влияет на поведение приложения на устройстве пользователя, если targetSdkVersion остаётся прежним.

• Поведение обратной совместимости системы Android останется неизменным. Например, если targetSdkVersion зафиксирован на уровне 32 (Android 12L), а на устройстве с Android 14 (API 34) есть новые ограничения на запуск фоновых сервисов, они не будут применены к вашему приложению. Система увидит targetSdkVersion=32 и продолжит использовать режим совместимости, предусмотренный для API 32.
• Разрешения времени выполнения (runtime permissions), модель работы с хранилищем (Scoped Storage), обработка изменений в энергосбережении (Background Limits) — все эти аспекты будут вести себя согласно заявленному targetSdkVersion.

Рекомендуемая стратегия и пример

Рекомендуется поддерживать compileSdkVersion на максимально актуальной стабильной версии, а targetSdkVersion повышать осознанно, после тщательного тестирования.

Представьте сценарий:

• Было: compileSdkVersion = 33, targetSdkVersion = 33
• Стало: compileSdkVersion = 34, targetSdkVersion = 33

В коде:

// Мы можем использовать новый API из SDK 34, например, новые параметры для Toast
// Но только если обернём вызов в проверку на версию SDK, чтобы приложение не крашнулось на старых устройствах.
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
    // Новый метод setGravity() с дополнительными флагами, доступный с API 34
    Toast.makeText(context, "Новый API!", Toast.LENGTH_SHORT).apply {
        setGravity(Gravity.TOP, 0, 0, WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS)
        show()
    }
} else {
    // Старый код для обратной совместимости
    Toast.makeText(context, "Старый API", Toast.LENGTH_SHORT).show()
}

Итог: Повышение compileSdkVersion — это в первую очередь инфраструктурное обновление, которое позволяет использовать современные инструменты разработки и готовить код к будущему повышению targetSdkVersion. Основное поведение приложения на устройствах пользователей продолжает определяться значением targetSdkVersion.