Для чего нужно указывать targetSdk в build.gradle модуля?

Назначение targetSdkVersion в Android-приложении

Указание targetSdkVersion в файле build.gradle (или ранее в AndroidManifest.xml) — это критически важная настройка, которая сообщает системе Android, для какой версии API приложение было специально разработано и протестировано. Это не просто техническая формальность, а механизм, обеспечивающий как обратную совместимость, так и доступ к новым функциям платформы.

Основные цели и принципы работы

Основная идея targetSdkVersion заключается в управлении поведением системы по отношению к вашему приложению. Android использует этот параметр для определения, какие режимы совместимости (так называемые "комплекты поведения" — behavioral compatibility kits) необходимо применить.

• При targetSdkVersion = X: Вы заявляете: "Мое приложение полностью адаптировано под API уровень X и готово ко всем изменениям в поведении системы, которые появились к этому уровню". Система Android отключает для вашего приложения все устаревшие механизмы обратной совместимости, связанные с версиями до X, и применяет современное поведение.
• При targetSdkVersion < X: Вы говорите: "Мое приложение не тестировалось с новым поведением системы, введенным в уровне X". В этом случае Android может включить специальные режимы совместимости, чтобы эмулировать старое поведение и предотвратить поломку вашего приложения.

Конкретные примеры влияния targetSdkVersion

Изменение targetSdkVersion может затронуть десятки аспектов поведения приложения. Вот некоторые ключевые примеры:

1. Управление разрешениями (Runtime Permissions):

    Начиная с API 23 (Android 6.0), опасные разрешения запрашиваются во время выполнения. Если `targetSdkVersion` < 23, система автоматически предоставляет все разрешения, объявленные в манифесте, при установке (старая модель). При `targetSdkVersion` >= 23 вы обязаны реализовать запрос разрешений в коде.

1. Изменения в работе с внешним хранилищем (Scoped Storage):

    С API 29 (Android 10) и особенно API 30 (Android 11) вводятся серьезные ограничения на доступ к общим файлам. При `targetSdkVersion` >= 30 ваше приложение по умолчанию получает доступ только к своим собственным файлам и медиа-контенту через MediaStore, если только оно не является файловым менеджером или не получило специального разрешения `MANAGE_EXTERNAL_STORAGE`. При более старом `targetSdkVersion` сохраняется более широкий доступ для совместимости.

1. Поведение веб-вью (WebView):

    Настройки безопасности и рендеринга в `WebView` меняются между версиями. Например, с определенного уровня по умолчанию блокируется смешанный контент (HTTP внутри HTTPS).

1. Изменения в работе служб (Services):

    На API 26 (Android 8.0) вводятся ограничения на работу фоновых служб. Если `targetSdkVersion` >= 26, неявный вызов `startService()` для службы, объявленной в манифесте, выбросит исключение `IllegalStateException`. Необходимо использовать `startForegroundService()` или `JobScheduler`.

Отличие от compileSdkVersion и minSdkVersion

Важно не путать три основных параметра:

• minSdkVersion: Минимальная версия Android, на которой может быть установлено ваше приложение. Определяет самую старую аудиторию.
• compileSdkVersion: Версия Android SDK, против которой компилируется ваш код. Определяет, какие классы и методы API доступны вам во время разработки.
• targetSdkVersion: Версия, на которую нацелено приложение. Определяет поведение системы во время выполнения.

Рекомендации по использованию

1. Регулярно обновляйте: Стремитесь поддерживать targetSdkVersion на уровне последней стабильной версии Android. Это дает пользователям лучшую производительность, безопасность и опыт, а также является требованием для публикации в Google Play (компания устанавливает обязательные deadlines для обновления).
2. Тщательно тестируйте после обновления: Повышение targetSdkVersion — это не автоматическая операция. Необходимо полноценно протестировать все функции приложения, особенно те, которые затрагиваются важными изменениями платформы (разрешения, хранилище, фоновая работа, изменения в компонентах UI).
3. Используйте lint и документацию: Android Studio и lint часто указывают на участки кода, поведение которых зависит от targetSdkVersion. Внимательно изучайте примечания о версиях API в официальной документации Android.

Пример конфигурации в build.gradle (module):

android {
    compileSdkVersion 34 // Компилируем с последним SDK

    defaultConfig {
        applicationId "com.example.myapp"
        minSdkVersion 24 // Поддерживаем устройства начиная с Android 7.0
        targetSdkVersion 34 // Приложение оптимизировано под поведение Android 14
        versionCode 1
        versionName "1.0"
    }
    // ...
}

Таким образом, targetSdkVersion — это ключевой контракт между разработчиком и операционной системой, который позволяет современным приложениям работать безопасно и эффективно, одновременно защищая старые приложения от непреднамеренных поломок при обновлении ОС.