Соответствовать требованиям целевого уровня API Google Play.

Загружаемый APK-файл должен соответствовать требованиям целевого уровня API Google Play.

С 31 августа 2024 г.:

  • Для отправки в Google Play новые приложения и обновления приложений должны быть ориентированы на Android 14 (уровень API 34) или выше; за исключением приложений Wear OS и Android TV, которые должны быть ориентированы на Android 13 (уровень API 33) или выше.
  • Существующие приложения должны быть ориентированы на Android 13 (уровень API 33) или выше, чтобы оставаться доступными для новых пользователей на устройствах под управлением ОС Android выше целевого уровня API вашего приложения. Приложения, предназначенные для Android 12 (уровень API 31) или ниже (Android 10 (уровень API 29) или ниже для Wear OS и Android 11 (уровень API 30) или ниже для Android TV), будут доступны только на устройствах под управлением ОС Android того же или более низкого уровня, чем целевой уровень API вашего приложения.

Вы сможете запросить продление до 1 ноября 2024 г., если вам нужно больше времени для обновления приложения. Позже в этом году вы сможете получить доступ к формам расширения вашего приложения в Play Console.

Исключения из этих требований включают:

  • Постоянно частные приложения, которые доступны только пользователям определенной организации и предназначены только для внутреннего распространения.
  • Приложения, предназначенные для ОС Android Automotive или входящие в состав APK-файлов, предназначенных для ОС Android Automotive.

Зачем ориентироваться на новые SDK?

В каждой новой версии Android представлены изменения, которые повышают безопасность и производительность, а также улучшают удобство использования Android. Некоторые из этих изменений применяются только к приложениям, которые явно заявляют о поддержке через атрибут манифеста targetSdkVersion (также известный как целевой уровень API).

Настройка вашего приложения для использования последнего уровня API гарантирует, что пользователи смогут воспользоваться этими улучшениями, в то время как ваше приложение по-прежнему может работать на более старых версиях Android. Ориентация на последний уровень API также позволяет вашему приложению использовать новейшие функции платформы, чтобы порадовать ваших пользователей. Кроме того, начиная с Android 10 (уровень API 29), пользователи видят предупреждение при первом запуске приложения, если приложение предназначено для Android 5.1 (уровень API 22) или ниже.

В этом документе освещены важные моменты, которые необходимо знать при обновлении целевого уровня API для соответствия требованиям Google Play . См. инструкции в следующих разделах в зависимости от того, на какую версию вы переходите.

Перейдите с Android 12 и более поздних версий (уровень API 31) на более позднюю версию.

Чтобы обновить приложение для использования более последней версии Android, следуйте соответствующему списку изменений поведения:

Переход с Android 11 (уровень API 30) на Android 12 (уровень API 31)

Безопасность и разрешения

  • Bluetooth : необходимо заменить объявления разрешений BLUETOOTH и BLUETOOTH_ADMIN разрешениями BLUETOOTH_SCAN , BLUETOOTH_ADVERTISE или BLUETOOTH_CONNECT . Вам больше не нужно запрашивать разрешения во время выполнения LOCATION для операций Bluetooth.
  • Местоположение: пользователи могут запрашивать у приложений только приблизительную информацию о местоположении. Вы должны запрашивать разрешение ACCESS_COARSE_LOCATION каждый раз, когда запрашиваете ACCESS_FINE_LOCATION .
  • Спящий режим. Приложения могут быть переведены в режим гибернации, если они не используются в течение определенного периода времени. В режиме гибернации разрешения и кэш вашего приложения сбрасываются, и вы не можете запускать задания или оповещения. Вы можете проверить состояние спящего режима вашего приложения .
  • Изменяемость ожидающего намерения : необходимо указать изменчивость каждого объекта PendingIntent, создаваемого вашим приложением.

Пользовательский опыт

  • Пользовательские уведомления . Уведомления с настраиваемым представлением контента больше не будут использовать всю область уведомлений; вместо этого система применяет стандартный шаблон. Этот шаблон гарантирует, что настраиваемые уведомления будут иметь такое же оформление, как и другие уведомления во всех состояниях. Это поведение почти идентично поведению Notification.DecoratedCustomViewStyle .
  • Изменения в проверке ссылок на приложения Android . При использовании проверки ссылок на приложения Android убедитесь, что ваши фильтры намерений включают категорию ПРОСМОТР и поддерживают схему HTTPS.

Производительность

  • Ограничения на запуск служб переднего плана . Для Android 12 или более поздней версии ваше приложение не может запускать службы переднего плана, пока оно работает в фоновом режиме, за исключением нескольких особых случаев. Если приложение пытается запустить службу переднего плана во время работы в фоновом режиме, возникает исключение (за исключением нескольких особых случаев).

    Рассмотрите возможность использования WorkManager для планирования и запуска ускоренной работы , пока ваше приложение работает в фоновом режиме. Чтобы выполнить срочные действия, которые запрашивает пользователь, запускайте службы приоритетного плана точно по сигналу тревоги.

  • Ограничения на уведомления : когда пользователи нажимают на уведомления, некоторые приложения в ответ запускают компонент приложения, который запускает действие, которое пользователь видит и с которым взаимодействует. Этот компонент приложения известен как батут уведомлений.

    Приложения не должны запускать действия сервисов или приемников вещания, которые используются в качестве трамплинов уведомлений. После того, как пользователь нажимает кнопку уведомления или действия в уведомлении, ваше приложение не может вызвать startActivity() внутри службы или приемника вещания.

Просмотрите полный набор изменений, которые затрагивают приложения, предназначенные для Android 12 (уровень API 31) .

Миграция с Android ниже 11 (уровень API 30)

Выберите версию Android, с которой вы будете мигрировать:

Переход на Android 5 (уровень API 21)

См. соответствующую страницу «Изменения поведения» для каждого из следующих выпусков, чтобы убедиться, что в вашем приложении учтены изменения, внесенные в эти выпуски:

Продолжайте, следуя инструкциям в следующем разделе.

Переход на Android 6 (уровень API 23)

Следующие соображения применимы к приложениям, предназначенным для Android 6.0 и более поздних версий платформы:

  • Разрешения во время выполнения

    • Опасные разрешения предоставляются только во время выполнения. Ваши потоки пользовательского интерфейса должны предоставлять возможности для предоставления этих разрешений.

    • По возможности убедитесь, что ваше приложение готово обрабатывать отклонения запросов на разрешения. Например, если пользователь отклоняет запрос на доступ к GPS устройства, убедитесь, что у вашего приложения есть другой способ продолжить работу.

Исчерпывающий список изменений, представленных в Android 6.0 (уровень API 23), см. на странице «Изменения поведения» для этой версии платформы.

Продолжайте, следуя инструкциям в следующем разделе.

Переход на Android 7 (уровень API 24)

Следующие соображения применимы к приложениям, предназначенным для Android 7.0 и более поздних версий платформы:

  • Режим сна и режим ожидания приложения

    Разработка поведений, описанных в разделе «Оптимизация для режима ожидания и режима ожидания приложений» , который включает в себя дополнительные изменения, внесенные в несколько выпусков платформы.

    Когда устройство находится в режиме ожидания и режиме ожидания приложения, система ведет себя следующим образом:

    • Ограничивает доступ к сети
    • Откладывает сигналы тревоги, синхронизацию и задания
    • Ограничивает сканирование GPS и Wi-Fi.
    • Ограничивает сообщения Firebase Cloud Messaging с обычным приоритетом.

  • Изменения разрешений

    • Система ограничивает доступ к личным каталогам приложений.
    • Предоставление URI file:// за пределами вашего приложения вызывает исключение FileUriExposedException . Если вам нужно обмениваться файлами за пределами вашего приложения, реализуйте FileProvider

  • Система запрещает связывание с библиотеками, не принадлежащими NDK.

Исчерпывающий список изменений, представленных в Android 7.0 (уровень API 24), см. на странице «Изменения поведения» для этой версии платформы.

Продолжайте, следуя инструкциям в следующем разделе.

Переход на Android 8 (уровень API 26)

Следующие соображения применимы к приложениям, предназначенным для Android 8.0 и более поздних версий платформы:

  • Пределы фонового выполнения
    • Система ограничивает службы для приложений, которые не работают на переднем плане.
      • startService() теперь генерирует исключение, когда приложение пытается его вызвать, хотя startService() запрещен.
      • Чтобы запустить службы переднего плана, приложение должно использовать startForeground() и startForegroundService() .
      • Внимательно просмотрите изменения, внесенные в API JobScheduler, как описано на странице «Изменения поведения» Android 8.0 (уровень API 26).
      • Для Firebase Cloud Messaging требуется SDK сервисов Google Play версии 10.2.1 или выше.
      • При использовании Firebase Cloud Messaging на доставку сообщений распространяются ограничения на фоновое выполнение. Если после получения сообщения необходима фоновая работа, например, для фоновой синхронизации данных, ваше приложение должно планировать задания с помощью диспетчера заданий Firebase или JobIntentService. Дополнительную информацию см. в документации Firebase Cloud Messaging .
    • Неявные трансляции
      • Неявные трансляции ограничены. Сведения об обработке фоновых событий см. в документации API JobScheduler .
    • Ограничения фонового местоположения
      • Приложения, работающие в фоновом режиме, имеют ограниченный доступ к данным о местоположении.
  • Каналы уведомлений
  • Конфиденциальность
    • ANDROID_ID определяется для каждого ключа подписи приложения.

Исчерпывающий список изменений, представленных в Android 8.0 (уровень API 26), см. на странице «Изменения поведения» для этой версии платформы.

Переход с Android 8 (API 26) на Android 9 (API 28)

Исчерпывающий список изменений, представленных в Android 9.0 (уровень API 28), см. в разделе «Изменения поведения» .

Переход с Android 9 (уровень API 28) на Android 10 (уровень API 29)

  • Уведомления с полноэкранным намерением
    • Необходимо запросить обычное разрешение USE_FULL_SCREEN_INTENT (не разрешение времени выполнения).
  • Поддержка складных устройств и устройств с большим экраном.
    • Несколько действий теперь могут находиться в состоянии «возобновлено» одновременно, но фактически только одно из них имеет фокус.
      • Это изменение влияет на поведение onResume() и onPause() .
      • Новая концепция жизненного цикла «самого верхнего возобновления», которую можно обнаружить, подписавшись на onTopResumedActivityChanged() .
        • Только одно действие может быть «возобновлено на самом верху».
    • Если для resizeableActivity установлено значение false , приложения могут дополнительно указать minAspectRatio , который автоматически помещает приложение в почтовый ящик с более узкими соотношениями сторон.
  • Изменения конфиденциальности
    • Ограниченное хранилище
      • Доступ к внешнему хранилищу ограничен только каталогом приложения и определенными типами носителей, созданными приложением.
    • Ограниченный доступ к местоположению, пока приложение работает в фоновом режиме, требуется разрешение ACCESS_BACKGROUND_LOCATION .
    • Ограниченный доступ к несбрасываемым идентификаторам, таким как IMEI и серийный номер.
    • Ограниченный доступ к информации о физической активности, такой как количество шагов пользователя, требующий разрешения ACTIVITY_RECOGNITION .
    • Ограниченный доступ к некоторым API телефонии, Bluetooth и Wi-Fi , требующий разрешения ACCESS_FINE_LOCATION .
    • Ограниченный доступ к настройкам Wi-Fi

Переход с Android 10 (уровень API 29) на Android 11 (уровень API 30)

Исчерпывающий список изменений, представленных в Android 11 (уровень API 30), см. на странице «Изменения поведения» .

Продолжайте обновляться до API 31, следуя инструкциям в предыдущем разделе .

Модернизируйте свои приложения

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

  • Рассмотрите возможность использования CameraX , которая находится в бета-версии, чтобы максимально эффективно использовать камеру.
  • Используйте компоненты Jetpack , чтобы следовать передовым практикам, освободить вас от написания шаблонного кода и упростить сложные задачи, чтобы вы могли сосредоточиться на коде, который вам важен.
  • Используйте Kotlin , чтобы писать лучшие приложения быстрее и с меньшим количеством кода.
  • Убедитесь, что вы соблюдаете требования конфиденциальности и лучшие практики.
  • Добавьте поддержку темных тем в свои приложения.
  • Добавьте поддержку навигации с помощью жестов в свои приложения.
  • Перенесите свое приложение из Google Cloud Messaging (GCM) в последнюю версию Firebase Cloud Messaging.
  • Воспользуйтесь преимуществами расширенного управления окнами.

Проверьте и обновите свои SDK и библиотеки.

Убедитесь, что зависимости вашего стороннего SDK поддерживают API 31: некоторые поставщики SDK публикуют его в своем манифесте; другие потребуют дополнительного расследования. Если вы используете SDK, который не поддерживает API 31, сделайте приоритетной работу с поставщиком SDK для решения этой проблемы.

Кроме того, обратите внимание, что targetSdkVersion вашего приложения или игры может ограничивать доступ к частным библиотекам платформы Android; дополнительные сведения см. в разделе «Приложения NDK, связывающиеся с библиотеками платформы» .

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

Мы рекомендуем вам выбрать targetSdkVersion , меньший или равный основной версии библиотеки поддержки. Мы рекомендуем вам обновить последнюю совместимую библиотеку поддержки, чтобы воспользоваться новейшими функциями совместимости и исправлениями ошибок.

Проверьте свое приложение

После того как вы соответствующим образом обновите уровень API и функции вашего приложения, вам следует протестировать некоторые основные варианты использования. Следующие предложения не являются исчерпывающими, но призваны помочь вам в процессе тестирования. Мы предлагаем протестировать:

  • Что ваше приложение компилируется в API 29 без ошибок и предупреждений.

  • Что в вашем приложении есть стратегия для случаев, когда пользователь отклоняет запросы на разрешения и запрашивает у пользователя разрешения. Для этого:

    • Перейдите на экран «Информация о приложении» вашего приложения и отключите все разрешения.
    • Откройте приложение и убедитесь в отсутствии сбоев.
      • Выполните основные тесты сценариев использования и убедитесь, что требуемые разрешения запрашиваются повторно.

  • Обрабатывает Doze с ожидаемыми результатами и без ошибок.

    • Используя adb, поместите тестовое устройство в Doze, пока ваше приложение работает.
      • Протестируйте все варианты использования, которые вызывают сообщения Firebase Cloud Messaging.
      • Протестируйте все варианты использования, в которых используются сигналы тревоги или задания.
      • Устраните любые зависимости от фоновых служб.
    • Переведите свое приложение в режим ожидания приложения
      • Протестируйте все варианты использования, которые вызывают сообщения Firebase Cloud Messaging.
      • Протестируйте все варианты использования, в которых используются сигналы тревоги.

  • Обрабатывает новые фотографии/видео

    • Убедитесь, что ваше приложение правильно обрабатывает ограниченные трансляции ACTION_NEW_PICTURE и ACTION_NEW_VIDEO (т. е. перемещается в задания JobScheduler).
    • Убедитесь, что все критические варианты использования, зависящие от этих событий, по-прежнему работают.

  • Обеспечивает обмен файлами с другими приложениями. Протестируйте любой вариант использования, при котором данные файла используются совместно с любым другим приложением (даже с другим приложением того же разработчика).

    • Проверьте, чтобы контент был виден в другом приложении и не вызывал сбоев.

Дополнительная информация

Подпишитесь на электронную рассылку в консоли Google Play, чтобы мы могли отправлять вам важные обновления и объявления из Android и Google Play, включая нашу ежемесячную рассылку новостей для партнеров.

,

Загружаемый APK-файл должен соответствовать требованиям целевого уровня API Google Play.

С 31 августа 2024 г.:

  • Для отправки в Google Play новые приложения и обновления приложений должны быть ориентированы на Android 14 (уровень API 34) или выше; за исключением приложений Wear OS и Android TV, которые должны быть ориентированы на Android 13 (уровень API 33) или выше.
  • Существующие приложения должны быть ориентированы на Android 13 (уровень API 33) или выше, чтобы оставаться доступными для новых пользователей на устройствах под управлением ОС Android выше целевого уровня API вашего приложения. Приложения, предназначенные для Android 12 (уровень API 31) или ниже (Android 10 (уровень API 29) или ниже для Wear OS и Android 11 (уровень API 30) или ниже для Android TV), будут доступны только на устройствах под управлением ОС Android того же или более низкого уровня, чем целевой уровень API вашего приложения.

Вы сможете запросить продление до 1 ноября 2024 г., если вам нужно больше времени для обновления приложения. Позже в этом году вы сможете получить доступ к формам расширения вашего приложения в Play Console.

Исключения из этих требований включают:

  • Постоянно частные приложения, которые доступны только пользователям определенной организации и предназначены только для внутреннего распространения.
  • Приложения, предназначенные для ОС Android Automotive или входящие в состав APK-файлов, предназначенных для ОС Android Automotive.

Зачем ориентироваться на новые SDK?

В каждой новой версии Android представлены изменения, которые повышают безопасность и производительность, а также улучшают удобство использования Android. Некоторые из этих изменений применяются только к приложениям, которые явно заявляют о поддержке через атрибут манифеста targetSdkVersion (также известный как целевой уровень API).

Настройка вашего приложения для использования последнего уровня API гарантирует, что пользователи смогут воспользоваться этими улучшениями, в то время как ваше приложение по-прежнему может работать на более старых версиях Android. Ориентация на последний уровень API также позволяет вашему приложению использовать новейшие функции платформы, чтобы порадовать ваших пользователей. Кроме того, начиная с Android 10 (уровень API 29), пользователи видят предупреждение при первом запуске приложения, если приложение предназначено для Android 5.1 (уровень API 22) или ниже.

В этом документе освещены важные моменты, которые необходимо знать при обновлении целевого уровня API для соответствия требованиям Google Play . См. инструкции в следующих разделах, в зависимости от того, на какую версию вы переходите.

Перейдите с Android 12 и более поздних версий (уровень API 31) на более позднюю версию.

Чтобы обновить приложение для использования более последней версии Android, следуйте соответствующему списку изменений поведения:

Переход с Android 11 (уровень API 30) на Android 12 (уровень API 31)

Безопасность и разрешения

  • Bluetooth : необходимо заменить объявления разрешений BLUETOOTH и BLUETOOTH_ADMIN разрешениями BLUETOOTH_SCAN , BLUETOOTH_ADVERTISE или BLUETOOTH_CONNECT . Вам больше не нужно запрашивать разрешения во время выполнения LOCATION для операций Bluetooth.
  • Местоположение: пользователи могут запрашивать у приложений только приблизительную информацию о местоположении. Вы должны запрашивать разрешение ACCESS_COARSE_LOCATION каждый раз, когда запрашиваете ACCESS_FINE_LOCATION .
  • Спящий режим. Приложения могут быть переведены в режим гибернации, если они не используются в течение определенного периода времени. В режиме гибернации разрешения и кэш вашего приложения сбрасываются, и вы не можете запускать задания или оповещения. Вы можете проверить состояние спящего режима вашего приложения .
  • Изменяемость ожидающего намерения : необходимо указать изменчивость каждого объекта PendingIntent, создаваемого вашим приложением.

Пользовательский опыт

  • Пользовательские уведомления . Уведомления с настраиваемым представлением контента больше не будут использовать всю область уведомлений; вместо этого система применяет стандартный шаблон. Этот шаблон гарантирует, что настраиваемые уведомления будут иметь такое же оформление, как и другие уведомления во всех состояниях. Это поведение почти идентично поведению Notification.DecoratedCustomViewStyle .
  • Изменения в проверке ссылок на приложения Android . При использовании проверки ссылок на приложения Android убедитесь, что ваши фильтры намерений включают категорию ПРОСМОТР и поддерживают схему HTTPS.

Производительность

  • Ограничения на запуск служб переднего плана . Для Android 12 или более поздней версии ваше приложение не может запускать службы переднего плана, пока оно работает в фоновом режиме, за исключением нескольких особых случаев. Если приложение пытается запустить службу переднего плана во время работы в фоновом режиме, возникает исключение (за исключением нескольких особых случаев).

    Рассмотрите возможность использования WorkManager для планирования и запуска ускоренной работы , пока ваше приложение работает в фоновом режиме. Чтобы выполнить срочные действия, которые запрашивает пользователь, запускайте службы приоритетного плана точно по сигналу тревоги.

  • Ограничения на уведомления : когда пользователи нажимают на уведомления, некоторые приложения в ответ запускают компонент приложения, который запускает действие, которое пользователь видит и с которым взаимодействует. Этот компонент приложения известен как батут уведомлений.

    Приложения не должны запускать действия сервисов или приемников вещания, которые используются в качестве трамплинов уведомлений. После того, как пользователь нажимает кнопку уведомления или действия в уведомлении, ваше приложение не может вызвать startActivity() внутри службы или приемника широковещательной передачи.

Просмотрите полный набор изменений, которые затрагивают приложения, предназначенные для Android 12 (уровень API 31) .

Миграция с Android ниже 11 (уровень API 30)

Выберите версию Android, с которой вы будете мигрировать:

Переход на Android 5 (уровень API 21)

См. соответствующую страницу «Изменения поведения» для каждого из следующих выпусков, чтобы убедиться, что в вашем приложении учтены изменения, внесенные в эти выпуски:

Продолжайте, следуя инструкциям в следующем разделе.

Переход на Android 6 (уровень API 23)

Следующие соображения применимы к приложениям, предназначенным для Android 6.0 и более поздних версий платформы:

  • Разрешения во время выполнения

    • Опасные разрешения предоставляются только во время выполнения. Ваши потоки пользовательского интерфейса должны предоставлять возможности для предоставления этих разрешений.

    • По возможности убедитесь, что ваше приложение готово обрабатывать отклонения запросов на разрешения. Например, если пользователь отклоняет запрос на доступ к GPS устройства, убедитесь, что у вашего приложения есть другой способ продолжить работу.

Исчерпывающий список изменений, представленных в Android 6.0 (уровень API 23), см. на странице «Изменения поведения» для этой версии платформы.

Продолжайте, следуя инструкциям в следующем разделе.

Переход на Android 7 (уровень API 24)

Следующие соображения применимы к приложениям, предназначенным для Android 7.0 и более поздних версий платформы:

  • Режим сна и режим ожидания приложения

    Разработка поведений, описанных в разделе «Оптимизация для режима ожидания и режима ожидания приложений» , который включает в себя дополнительные изменения, внесенные в несколько выпусков платформы.

    Когда устройство находится в режиме ожидания и режиме ожидания приложения, система ведет себя следующим образом:

    • Ограничивает доступ к сети
    • Откладывает сигналы тревоги, синхронизацию и задания
    • Ограничивает сканирование GPS и Wi-Fi.
    • Ограничивает сообщения Firebase Cloud Messaging с обычным приоритетом.

  • Изменения разрешений

    • Система ограничивает доступ к личным каталогам приложений.
    • Предоставление URI file:// за пределами вашего приложения вызывает исключение FileUriExposedException . Если вам нужно обмениваться файлами за пределами вашего приложения, реализуйте FileProvider

  • Система запрещает связывание с библиотеками, не принадлежащими NDK.

Исчерпывающий список изменений, представленных в Android 7.0 (уровень API 24), см. на странице «Изменения поведения» для этой версии платформы.

Продолжайте, следуя инструкциям в следующем разделе.

Переход на Android 8 (уровень API 26)

Следующие соображения применимы к приложениям, предназначенным для Android 8.0 и более поздних версий платформы:

  • Пределы фонового выполнения
    • Система ограничивает службы для приложений, которые не работают на переднем плане.
      • startService() теперь генерирует исключение, когда приложение пытается его вызвать, хотя startService() запрещен.
      • Чтобы запустить службы переднего плана, приложение должно использовать startForeground() и startForegroundService() .
      • Внимательно просмотрите изменения, внесенные в API JobScheduler, как описано на странице «Изменения поведения» Android 8.0 (уровень API 26).
      • Для Firebase Cloud Messaging требуется SDK сервисов Google Play версии 10.2.1 или выше.
      • При использовании Firebase Cloud Messaging на доставку сообщений распространяются ограничения на фоновое выполнение. Если при получении сообщения необходима фоновая работа, например, для фоновой синхронизации данных, ваше приложение должно планировать задания с помощью диспетчера заданий Firebase или JobIntentService. Дополнительную информацию см. в документации Firebase Cloud Messaging .
    • Неявные трансляции
      • Неявные трансляции ограничены. Сведения об обработке фоновых событий см. в документации API JobScheduler .
    • Ограничения фонового местоположения
      • Приложения, работающие в фоновом режиме, имеют ограниченный доступ к данным о местоположении.
  • Каналы уведомлений
  • Конфиденциальность
    • ANDROID_ID определяется для каждого ключа подписи приложения.

Исчерпывающий список изменений, представленных в Android 8.0 (уровень API 26), см. на странице «Изменения поведения» для этой версии платформы.

Переход с Android 8 (API 26) на Android 9 (API 28)

Исчерпывающий список изменений, представленных в Android 9.0 (уровень API 28), см. в разделе «Изменения поведения» .

Переход с Android 9 (уровень API 28) на Android 10 (уровень API 29)

  • Уведомления с полноэкранным намерением
    • Необходимо запросить обычное разрешение USE_FULL_SCREEN_INTENT (не разрешение времени выполнения).
  • Поддержка складных устройств и устройств с большим экраном.
    • Несколько действий теперь могут находиться в состоянии «возобновлено» одновременно, но фактически только одно из них имеет фокус.
      • Это изменение влияет на поведение onResume() и onPause() .
      • Новая концепция жизненного цикла «самого верхнего возобновления», которую можно обнаружить, подписавшись на onTopResumedActivityChanged() .
        • Только одно действие может быть «возобновлено на самом верху».
    • Если для resizeableActivity установлено значение false , приложения могут дополнительно указать minAspectRatio , который автоматически помещает приложение в почтовый ящик с более узкими соотношениями сторон.
  • Изменения конфиденциальности
    • Ограниченное хранилище
      • Доступ к внешнему хранилищу ограничен только каталогом приложения и определенными типами носителей, созданными приложением.
    • Ограниченный доступ к местоположению, пока приложение работает в фоновом режиме, требуется разрешение ACCESS_BACKGROUND_LOCATION .
    • Ограниченный доступ к несбрасываемым идентификаторам, таким как IMEI и серийный номер.
    • Ограниченный доступ к информации о физической активности, такой как количество шагов пользователя, требующий разрешения ACTIVITY_RECOGNITION .
    • Ограниченный доступ к некоторым API телефонии, Bluetooth и Wi-Fi , требующий разрешения ACCESS_FINE_LOCATION .
    • Ограниченный доступ к настройкам Wi-Fi

Переход с Android 10 (уровень API 29) на Android 11 (уровень API 30)

Для исчерпывающего списка изменений, введенных в Android 11 (API -уровне 30), см. Страницу «Изменения поведения» .

Продолжайте обновлять API 31, следуя инструкциям в предыдущем разделе .

Модернизируйте ваши приложения

Когда вы обновляете целевой уровень API для ваших приложений, рассмотрите возможность принятия недавних функций платформы для модернизации ваших приложений и восхищения ваших пользователей.

  • Подумайте об использовании Camerax , которая находится в бета -версии, чтобы максимально использовать использование камеры.
  • Используйте компоненты JetPack , чтобы помочь вам следить за лучшими практиками, освободить вас от написания кода шаблон и упростить сложные задачи, чтобы вы могли сосредоточиться на коде, который вам заботится.
  • Используйте Kotlin , чтобы писать лучшие приложения быстрее и с меньшим кодом.
  • Убедитесь, что вы следуете требованиям конфиденциальности и передовым практикам.
  • Добавьте темную поддержку темы в ваши приложения.
  • Добавьте поддержку навигации по жестам в ваши приложения.
  • Перенесите свое приложение из Google Cloud Messaging (GCM) на последнюю версию обмена обменами Firebase Cloud.
  • Воспользуйтесь преимуществами передового управления окнами.
    • Поддержите большие соотношения сторон (более 16: 9), чтобы воспользоваться последними достижениями в области аппаратного обеспечения. Убедитесь, что ваше приложение изменяется, чтобы заполнить доступное пространство экрана. Только объявляет максимальное соотношение сторон как последнее средство. Для получения дополнительной информации о максимальных соотношениях сторон см. Вспомогательную поддержку с ограниченным экраном .
    • Добавьте поддержку с несколькими Window , чтобы помочь вашему приложению повысить производительность и управлять несколькими дисплеями .
    • Если отличный минимальный опыт приложения улучшит пользовательский опыт, добавьте поддержку для картины .

Проверьте и обновите свои SDK и библиотеки

Убедитесь, что ваши сторонние зависимости SDK поддерживают API 31: некоторые поставщики SDK публикуют его в своем манифесте; Другие потребуют дополнительного расследования. Если вы используете SDK, который не поддерживает API 31, сделайте это приоритетом для работы с поставщиком SDK для решения этой проблемы.

Кроме того, обратите внимание, что ваше приложение или targetSdkVersion вашего приложения или игры может ограничить доступ к частным библиотекам платформы Android; См. Приложения NDK, ссылаясь на библиотеки платформ для деталей.

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

Мы рекомендуем вам выбрать targetSdkVersion , меньшее, чем или равное основной версии библиотеки поддержки. Мы рекомендуем вам обновить недавнюю библиотеку совместимой поддержки, чтобы воспользоваться последними функциями совместимости и исправлениями ошибок.

Проверьте свое приложение

После обновления уровня и функций API вашего приложения вам следует проверить некоторые основные варианты использования. Следующие предложения не являются исчерпывающими, но стремятся направить процесс тестирования. Мы предлагаем тестирование:

  • Что ваше приложение компилируется в API 29 без ошибок или предупреждений.

  • Что в вашем приложении есть стратегия для случаев, когда пользователь отклоняет запросы на разрешение, и побуждает пользователя разрешения. Для этого:

    • Перейдите на экран информации о приложении вашего приложения и отключите каждое разрешение.
    • Откройте приложение и убедитесь, что нет сбоев.
      • Выполните тесты на использование основных вариантов и убедитесь, что требуемые разрешения будут переоборудованы.

  • Рыряет доуз с ожидаемыми результатами и без ошибок.

    • Используя ADB, поместите ваше тестовое устройство в Doze во время работы вашего приложения.
      • Проверьте любые варианты использования, которые запускают сообщения об обмене облачными сообщениями Firebase.
      • Проверьте любые варианты использования, которые используют аварийные сигналы или задания.
      • Устранить любые зависимости от фоновых услуг.
    • Установите свое приложение в резервную речь
      • Проверьте любые варианты использования, которые запускают сообщения об обмене облачными сообщениями Firebase.
      • Проверьте любые варианты использования, которые используют аварийные сигналы.

  • Обрабатывает новые фотографии / видео, снятые

    • Убедитесь, что ваше приложение обрабатывает ограниченное ACTION_NEW_PICTURE и ACTION_NEW_VIDEO , правильно транслируется (то есть перенесено на задание Jobscheduler).
    • Убедитесь, что любые критические варианты использования, которые зависят от этих событий, все еще работают.

  • Обрабатывает совместные файлы с другими приложениями - протестируйте любой случай использования, который делится файлами данных с любым другим приложением (даже другое приложение от того же разработчика)

    • Проверьте контент, виден в другом приложении и не запускает сбои.

Дополнительная информация

Выберите электронные письма в консоли Google Play, чтобы мы могли отправить вам важные обновления и объявления от Android и Google Play, включая нашу ежемесячную бюллетени для партнеров.

,

Когда вы загружаете APK, он должен соответствовать требованиям API Google Play.

Начиная с 31 августа 2024 года:

  • Новые приложения и обновления приложений должны быть нацелены на Android 14 (API -уровень 34) или выше, чтобы быть отправленным в Google Play; За исключением приложений для Android OS и Android TV, которые должны ориентироваться на Android 13 (API -уровень 33) или выше.
  • Существующие приложения должны нацелиться на Android 13 (API -уровне 33) или выше, чтобы оставаться доступными для новых пользователей на устройствах с помощью ОС Android выше, чем целевой уровень API вашего приложения. Приложения, которые нацелены на Android 12 (API -уровень 31) или ниже (Android 10 (API -уровни 29) или ниже для ОС Wear и Android 11 (уровень API 30) или ниже для Android TV), будут доступны только на устройствах, работающих на ОС Android, которые одинаковы или ниже, чем уровень API API вашего приложения.

Вы сможете запросить продление до 1 ноября 2024 года, если вам нужно больше времени для обновления вашего приложения. Вы сможете получить доступ к формам расширения вашего приложения в игровой консоли в конце этого года.

Исключения из этих требований включают в себя:

  • Постоянно частные приложения, которые ограничены пользователями в конкретной организации и предназначены только для внутреннего распространения.
  • Приложения, которые нацелены на Android Automotive OS, или упакованы с APK, нацеленными на Android Automotive OS.

Зачем нацелиться на новые SDK?

Каждая новая версия Android вводит изменения, которые обеспечивают улучшение безопасности и производительность и улучшают пользовательский опыт Android. Некоторые из этих изменений применяются только к приложениям, которые явно заявляют о поддержке через их атрибут targetSdkVersion Manifest (также известный как целевой уровень API).

Настройка вашего приложения для нацеливания на недавний уровень API гарантирует, что пользователи могут извлечь выгоду из этих улучшений, в то время как ваше приложение все еще может работать на старых версиях Android. Нацеливание на недавний уровень API также позволяет вашему приложению воспользоваться последними функциями платформы, чтобы порадовать ваших пользователей. Кроме того, по состоянию на Android 10 (API -уровень 29) пользователи видят предупреждение , когда они впервые запускают приложение, если приложение нацелен на Android 5.1 (API -уровень 22) или ниже.

В этом документе подчеркиваются важные моменты, которые вам нужно знать при обновлении целевого уровня API, чтобы удовлетворить требования Google Play . См. Инструкции в следующих разделах, в зависимости от того, в какую версию вы мигрируете.

Мигрируйте из Android 12 и выше (API -уровень 31) в более позднюю версию

Чтобы обновить ваше приложение для нацеливания на более позднюю версию Android, следуйте соответствующему списку изменений поведения:

Мигрируйте с Android 11 (API -уровни 30) в Android 12 (уровень API 31)

Безопасность и разрешения

  • Bluetooth : вы должны заменить объявления разрешений BLUETOOTH и BLUETOOTH_ADMIN с помощью BLUETOOTH_SCAN , BLUETOOTH_ADVERTISE или BLUETOOTH_CONNECT Promisions. Вам больше не нужно делать запросы на прочтку выполнения LOCATION на операции Bluetooth.
  • Местоположение: Пользователи могут запросить приложения для получения только приблизительной информации о местоположении. Вы должны запросить разрешение ACCESS_COARSE_LOCATION в любое время, когда вы запросите ACCESS_FINE_LOCATION .
  • Спячка: приложения могут быть помещены в режим спячки, если они не используются в течение определенного периода времени. В режиме сгибания разрешения на выполнение вашего приложения и кэш сброшены, и вы не можете запускать задания или оповещения. Вы можете проверить статус спящего приложения .
  • В ожидании намерения изменяют : вы должны указать изменяемость каждого объекта, который создает ваше приложение.

Пользовательский опыт

  • Пользовательские уведомления : уведомления с пользовательскими представлениями контента больше не будут использовать полную область уведомления; Вместо этого система применяет стандартный шаблон. Этот шаблон гарантирует, что пользовательские уведомления имеют одинаковое украшение, что и другие уведомления во всех штатах. Такое поведение почти идентично поведению Notification.DecoratedCustomViewStyle DecoratedCustomViewStyle.
  • Приложение Android ссылки на проверку изменений : при использовании проверки ссылки на Android убедитесь, что ваши фильтры намерения включают категорию для просмотра и поддерживают схему HTTPS.

Производительность

  • Ограничения запуска обслуживания переднего плана : для нацеливания на Android 12 или выше ваше приложение не может запустить услуги переднего плана, пока оно работает в заднем плане, за исключением нескольких особых случаев. Если приложение пытается запустить службу переднего плана во время работы на заднем плане, происходит исключение (за исключением нескольких особых случаев).

    Подумайте об использовании Workmanager для планирования и запуска ускоренной работы , пока ваше приложение работает в фоновом режиме. Чтобы завершить чувствительные к во времени действия, которые запрашивает пользователь, запустите службы переднего плана в рамках точной тревоги.

  • Уведомления об ограничениях батута : Когда пользователи используют уведомления, некоторые приложения отвечают, запустив компонент приложения, который запускает деятельность, с которой пользователь видит и взаимодействует. Этот компонент приложения известен как батут уведомлений.

    Приложения не должны начинать действия с услуг или вещательных приемников, которые используются в качестве батутов уведомлений. После того, как пользователь нажимает на кнопку уведомления или действия в рамках уведомления, ваше приложение не может вызовать startActivity() внутри службы или вещательного приемника.

Просмотреть полный набор изменений, которые влияют на приложения, нацеленные на Android 12 (уровень API 31) .

Мигрируйте с ниже, чем Android 11 (API -уровень 30)

Выберите версию Android, вы будете мигрировать из:

Мигрировать в Android 5 (API -уровень 21)

Смотрите страницу «Изменения в поведении» для каждого из следующих выпусков, чтобы убедиться, что ваше приложение объяснило изменения, введенные в этих выпусках:

Продолжить, следуя инструкциям в следующем разделе.

Мигрировать в Android 6 (уровень API 23)

Следующие соображения применяются к приложениям, нацеленным на Android 6.0 и более высокие версии платформы:

  • Разрешения времени выполнения

    • Опасные разрешения предоставляются только во время выполнения. Ваш пользовательский интерфейс должен предоставлять возможности для предоставления этих разрешений.

    • Везде, где это возможно, убедитесь, что ваше приложение готово обрабатывать отклонение от запросов на разрешение. Например, если пользователь отказывается от запроса на доступ к GPS устройства, убедитесь, что у вашего приложения есть другой способ продолжить.

Для исчерпывающего списка изменений, введенных в Android 6.0 (API -уровне 23), см. Страницу «Изменения поведения» для этой версии платформы.

Продолжить, следуя инструкциям в следующем разделе.

Мигрируйте в Android 7 (уровень API 24)

Следующие соображения применимы к приложениям, нацеленным на Android 7.0 и более высокие версии платформы:

  • DOZE и APP STANBY

    Дизайн для поведения, описанный в оптимизации для Doze и App Satchby , который охватывает постепенные изменения, введенные в нескольких выпусках платформы.

    Когда устройство находится в режиме режима Doze и App, система ведет себя следующим образом:

    • Ограничивает доступ к сети
    • Определяет сигналы тревоги, синхронизации и рабочих мест
    • Ограничивает сканы GPS и Wi-Fi
    • Ограничивает нормальные приоритетные сообщения общего обмена сообщениями.

  • Изменения разрешения

    • Система ограничивает доступ к частным каталогам приложения.
    • Распределение file:// URI за пределами вашего приложения запускает FileUriExposedException . Если вам нужно обмениваться файлами за пределами вашего приложения, реализуйте FileProvider

  • Система запрещает ссылку на библиотеки не-NDK.

Для исчерпывающего списка изменений, введенных в Android 7.0 (уровень API 24), см. Страницу «Изменения поведения» для этой версии платформы.

Продолжить, следуя инструкциям в следующем разделе.

Мигрировать в Android 8 (API -уровень 26)

Следующие соображения применяются к приложениям, нацеленным на Android 8.0 и более высокие версии платформы:

Для исчерпывающего списка изменений, введенных в Android 8.0 (уровень API 26), см. Страницу «Изменения поведения» для этой версии платформы.

Мигрировать с Android 8 (API 26) в Android 9 (API 28)

Для исчерпывающего списка изменений, введенных в Android 9.0 (уровень API 28), см. Изменения поведения .

Мигрируйте с Android 9 (API -уровень 28) в Android 10 (уровень API 29)

  • Уведомления с полноэкранным намерением
    • Необходимо запросить обычное разрешение USE_FULL_SCREEN_INTENT (не разрешение времени выполнения).
  • Поддержка складных и больших экранных устройств
    • Многочисленные действия теперь могут быть в «возобновляемом» состоянии одновременно, но только один на самом деле сосредоточен.
      • Это изменение влияет на поведение onResume() и onPause() .
      • Новая концепция жизненного цикла «Самых самых возобновляемых», которая может быть обнаружена путем подписки на onTopResumedActivityChanged() .
        • Только одно действие может быть «самым возобновлением».
    • Когда resizeableActivity устанавливается на false , приложения могут дополнительно указывать minAspectRatio , который автоматически питает приложение на более узких соотношениях сторон.
  • Замена конфиденциальности
    • Ограниченное хранилище
      • Внешнее доступ к хранилищу ограничен только специфичным для приложения каталог и определенными типами носителя, которые создало приложение.
    • Ограниченный доступ к местоположению, пока приложение находится в фоновом режиме, требуя разрешения ACCESS_BACKGROUND_LOCATION .
    • Ограниченный доступ к неретируемым идентификаторам, таким как IMEI и серийный номер.
    • Ограниченный доступ к информации о физической активности, такой как количество шагов пользователя, требуя разрешения ACTIVITY_RECOGNITION .
    • Ограниченный доступ к некоторым API-интерфейсам телефонии, Bluetooth и Wi-Fi , требующим разрешения ACCESS_FINE_LOCATION .
    • Ограниченный доступ к настройкам Wi-Fi

Мигрируйте с Android 10 (API -уровень 29) в Android 11 (API -уровень 30)

Для исчерпывающего списка изменений, введенных в Android 11 (API -уровне 30), см. Страницу «Изменения поведения» .

Продолжайте обновлять API 31, следуя инструкциям в предыдущем разделе .

Модернизируйте ваши приложения

Когда вы обновляете целевой уровень API для ваших приложений, рассмотрите возможность принятия недавних функций платформы для модернизации ваших приложений и восхищения ваших пользователей.

  • Подумайте об использовании Camerax , которая находится в бета -версии, чтобы максимально использовать использование камеры.
  • Используйте компоненты JetPack , чтобы помочь вам следить за лучшими практиками, освободить вас от написания кода шаблон и упростить сложные задачи, чтобы вы могли сосредоточиться на коде, который вам заботится.
  • Используйте Kotlin , чтобы писать лучшие приложения быстрее и с меньшим кодом.
  • Убедитесь, что вы следуете требованиям конфиденциальности и передовым практикам.
  • Добавьте темную поддержку темы в ваши приложения.
  • Добавьте поддержку навигации по жестам в ваши приложения.
  • Перенесите свое приложение из Google Cloud Messaging (GCM) на последнюю версию обмена обменами Firebase Cloud.
  • Воспользуйтесь преимуществами передового управления окнами.
    • Поддержите большие соотношения сторон (более 16: 9), чтобы воспользоваться последними достижениями в области аппаратного обеспечения. Убедитесь, что ваше приложение изменяется, чтобы заполнить доступное пространство экрана. Только объявляет максимальное соотношение сторон как последнее средство. Для получения дополнительной информации о максимальных соотношениях сторон см. Вспомогательную поддержку с ограниченным экраном .
    • Добавьте поддержку с несколькими Window , чтобы помочь вашему приложению повысить производительность и управлять несколькими дисплеями .
    • Если отличный минимальный опыт приложения улучшит пользовательский опыт, добавьте поддержку для картины .

Проверьте и обновите свои SDK и библиотеки

Убедитесь, что ваши сторонние зависимости SDK поддерживают API 31: некоторые поставщики SDK публикуют его в своем манифесте; Другие потребуют дополнительного расследования. Если вы используете SDK, который не поддерживает API 31, сделайте это приоритетом для работы с поставщиком SDK для решения этой проблемы.

Кроме того, обратите внимание, что ваше приложение или targetSdkVersion вашего приложения или игры может ограничить доступ к частным библиотекам платформы Android; См. Приложения NDK, ссылаясь на библиотеки платформ для деталей.

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

Мы рекомендуем вам выбрать targetSdkVersion , меньшее, чем или равное основной версии библиотеки поддержки. Мы рекомендуем вам обновить недавнюю библиотеку совместимой поддержки, чтобы воспользоваться последними функциями совместимости и исправлениями ошибок.

Проверьте свое приложение

После обновления уровня и функций API вашего приложения вам следует проверить некоторые основные варианты использования. Следующие предложения не являются исчерпывающими, но стремятся направить процесс тестирования. Мы предлагаем тестирование:

  • Что ваше приложение компилируется в API 29 без ошибок или предупреждений.

  • Что в вашем приложении есть стратегия для случаев, когда пользователь отклоняет запросы на разрешение, и побуждает пользователя разрешения. Для этого:

    • Перейдите на экран информации о приложении вашего приложения и отключите каждое разрешение.
    • Откройте приложение и убедитесь, что нет сбоев.
      • Выполните тесты на использование основных вариантов и убедитесь, что требуемые разрешения будут переоборудованы.

  • Рыряет доуз с ожидаемыми результатами и без ошибок.

    • Используя ADB, поместите ваше тестовое устройство в Doze во время работы вашего приложения.
      • Проверьте любые варианты использования, которые запускают сообщения об обмене облачными сообщениями Firebase.
      • Проверьте любые варианты использования, которые используют аварийные сигналы или задания.
      • Устранить любые зависимости от фоновых услуг.
    • Установите свое приложение в резервную речь
      • Проверьте любые варианты использования, которые запускают сообщения об обмене облачными сообщениями Firebase.
      • Проверьте любые варианты использования, которые используют аварийные сигналы.

  • Обрабатывает новые фотографии / видео, снятые

    • Убедитесь, что ваше приложение обрабатывает ограниченное ACTION_NEW_PICTURE и ACTION_NEW_VIDEO , правильно транслируется (то есть перенесено на задание Jobscheduler).
    • Убедитесь, что любые критические варианты использования, которые зависят от этих событий, все еще работают.

  • Обрабатывает совместные файлы с другими приложениями - протестируйте любой случай использования, который делится файлами данных с любым другим приложением (даже другое приложение от того же разработчика)

    • Проверьте контент, виден в другом приложении и не запускает сбои.

Дополнительная информация

Выберите электронные письма в консоли Google Play, чтобы мы могли отправить вам важные обновления и объявления от Android и Google Play, включая нашу ежемесячную бюллетени для партнеров.

,

Когда вы загружаете APK, он должен соответствовать требованиям API Google Play.

Начиная с 31 августа 2024 года:

  • Новые приложения и обновления приложений должны быть нацелены на Android 14 (API -уровень 34) или выше, чтобы быть отправленным в Google Play; За исключением приложений для Android OS и Android TV, которые должны ориентироваться на Android 13 (API -уровень 33) или выше.
  • Существующие приложения должны нацелиться на Android 13 (API -уровне 33) или выше, чтобы оставаться доступными для новых пользователей на устройствах с помощью ОС Android выше, чем целевой уровень API вашего приложения. Приложения, которые нацелены на Android 12 (API -уровень 31) или ниже (Android 10 (API -уровни 29) или ниже для ОС Wear и Android 11 (уровень API 30) или ниже для Android TV), будут доступны только на устройствах, работающих на ОС Android, которые одинаковы или ниже, чем уровень API API вашего приложения.

Вы сможете запросить продление до 1 ноября 2024 года, если вам нужно больше времени для обновления вашего приложения. Вы сможете получить доступ к формам расширения вашего приложения в игровой консоли в конце этого года.

Исключения из этих требований включают в себя:

  • Постоянно частные приложения, которые ограничены пользователями в конкретной организации и предназначены только для внутреннего распространения.
  • Приложения, которые нацелены на Android Automotive OS, или упакованы с APK, нацеленными на Android Automotive OS.

Зачем нацелиться на новые SDK?

Каждая новая версия Android вводит изменения, которые обеспечивают улучшение безопасности и производительность и улучшают пользовательский опыт Android. Некоторые из этих изменений применяются только к приложениям, которые явно заявляют о поддержке через их атрибут targetSdkVersion Manifest (также известный как целевой уровень API).

Настройка вашего приложения для нацеливания на недавний уровень API гарантирует, что пользователи могут извлечь выгоду из этих улучшений, в то время как ваше приложение все еще может работать на старых версиях Android. Нацеливание на недавний уровень API также позволяет вашему приложению воспользоваться последними функциями платформы, чтобы порадовать ваших пользователей. Кроме того, по состоянию на Android 10 (API -уровень 29) пользователи видят предупреждение , когда они впервые запускают приложение, если приложение нацелен на Android 5.1 (API -уровень 22) или ниже.

В этом документе подчеркиваются важные моменты, которые вам нужно знать при обновлении целевого уровня API, чтобы удовлетворить требования Google Play . См. Инструкции в следующих разделах, в зависимости от того, в какую версию вы мигрируете.

Мигрируйте из Android 12 и выше (API -уровень 31) в более позднюю версию

Чтобы обновить ваше приложение для нацеливания на более позднюю версию Android, следуйте соответствующему списку изменений поведения:

Мигрируйте с Android 11 (API -уровни 30) в Android 12 (уровень API 31)

Безопасность и разрешения

  • Bluetooth : вы должны заменить объявления разрешений BLUETOOTH и BLUETOOTH_ADMIN с помощью BLUETOOTH_SCAN , BLUETOOTH_ADVERTISE или BLUETOOTH_CONNECT Promisions. Вам больше не нужно делать запросы на прочтку выполнения LOCATION на операции Bluetooth.
  • Местоположение: Пользователи могут запросить приложения для получения только приблизительной информации о местоположении. Вы должны запросить разрешение ACCESS_COARSE_LOCATION в любое время, когда вы запросите ACCESS_FINE_LOCATION .
  • Спячка: приложения могут быть помещены в режим спячки, если они не используются в течение определенного периода времени. В режиме сгибания разрешения на выполнение вашего приложения и кэш сброшены, и вы не можете запускать задания или оповещения. Вы можете проверить статус спящего приложения .
  • В ожидании намерения изменяют : вы должны указать изменяемость каждого объекта, который создает ваше приложение.

Пользовательский опыт

  • Пользовательские уведомления : уведомления с пользовательскими представлениями контента больше не будут использовать полную область уведомления; Вместо этого система применяет стандартный шаблон. Этот шаблон гарантирует, что пользовательские уведомления имеют одинаковое украшение, что и другие уведомления во всех штатах. Такое поведение почти идентично поведению Notification.DecoratedCustomViewStyle DecoratedCustomViewStyle.
  • Приложение Android ссылки на проверку изменений : при использовании проверки ссылки на Android убедитесь, что ваши фильтры намерения включают категорию для просмотра и поддерживают схему HTTPS.

Производительность

  • Ограничения запуска обслуживания переднего плана : для нацеливания на Android 12 или выше ваше приложение не может запустить услуги переднего плана, пока оно работает в заднем плане, за исключением нескольких особых случаев. Если приложение пытается запустить службу переднего плана во время работы на заднем плане, происходит исключение (за исключением нескольких особых случаев).

    Подумайте об использовании Workmanager для планирования и запуска ускоренной работы , пока ваше приложение работает в фоновом режиме. Чтобы завершить чувствительные к во времени действия, которые запрашивает пользователь, запустите службы переднего плана в рамках точной тревоги.

  • Уведомления об ограничениях батута : Когда пользователи используют уведомления, некоторые приложения отвечают, запустив компонент приложения, который запускает деятельность, с которой пользователь видит и взаимодействует. Этот компонент приложения известен как батут уведомлений.

    Приложения не должны начинать действия с услуг или вещательных приемников, которые используются в качестве батутов уведомлений. После того, как пользователь нажимает на кнопку уведомления или действия в рамках уведомления, ваше приложение не может вызовать startActivity() внутри службы или вещательного приемника.

Просмотреть полный набор изменений, которые влияют на приложения, нацеленные на Android 12 (уровень API 31) .

Мигрируйте с ниже, чем Android 11 (API -уровень 30)

Выберите версию Android, вы будете мигрировать из:

Мигрировать в Android 5 (API -уровень 21)

Смотрите страницу «Изменения в поведении» для каждого из следующих выпусков, чтобы убедиться, что ваше приложение объяснило изменения, введенные в этих выпусках:

Продолжить, следуя инструкциям в следующем разделе.

Мигрировать в Android 6 (уровень API 23)

Следующие соображения применяются к приложениям, нацеленным на Android 6.0 и более высокие версии платформы:

  • Разрешения времени выполнения

    • Опасные разрешения предоставляются только во время выполнения. Ваш пользовательский интерфейс должен предоставлять возможности для предоставления этих разрешений.

    • Везде, где это возможно, убедитесь, что ваше приложение готово обрабатывать отклонение от запросов на разрешение. Например, если пользователь отказывается от запроса на доступ к GPS устройства, убедитесь, что у вашего приложения есть другой способ продолжить.

Для исчерпывающего списка изменений, введенных в Android 6.0 (API -уровне 23), см. Страницу «Изменения поведения» для этой версии платформы.

Продолжить, следуя инструкциям в следующем разделе.

Мигрируйте в Android 7 (уровень API 24)

Следующие соображения применимы к приложениям, нацеленным на Android 7.0 и более высокие версии платформы:

  • DOZE и APP STANBY

    Дизайн для поведения, описанный в оптимизации для Doze и App Satchby , который охватывает постепенные изменения, введенные в нескольких выпусках платформы.

    Когда устройство находится в режиме режима Doze и App, система ведет себя следующим образом:

    • Ограничивает доступ к сети
    • Определяет сигналы тревоги, синхронизации и рабочих мест
    • Ограничивает сканы GPS и Wi-Fi
    • Ограничивает нормальные приоритетные сообщения общего обмена сообщениями.

  • Изменения разрешения

    • The system restricts access to app private directories.
    • Exposing a file:// URI outside of your app triggers a FileUriExposedException . If you need to share files outside of your app, implement FileProvider

  • The system forbids linking to non-NDK libraries.

For an exhaustive list of changes introduced in Android 7.0 (API level 24), see the Behavior Changes page for that version of the platform.

Continue by following the instructions in the next section.

Migrate to Android 8 (API level 26)

The following considerations apply to apps targeting Android 8.0 and higher versions of the platform:

For an exhaustive list of changes introduced in Android 8.0 (API level 26), see the Behavior Changes page for that version of the platform.

Migrate from Android 8 (API 26) to Android 9 (API 28)

For an exhaustive list of changes introduced in Android 9.0 (API level 28), see behavior changes .

Migrate from Android 9 (API level 28) to Android 10 (API level 29)

Migrate from Android 10 (API level 29) to Android 11 (API level 30)

For an exhaustive list of changes introduced in Android 11 (API level 30), see the Behavior Changes page.

Continue to update to API 31 by following the instructions in the previous section .

Modernize your apps

As you update the target API level for your apps, consider adopting recent platform features to modernize your apps and delight your users.

Check and update your SDKs and libraries

Make sure that your third-party SDK dependencies support API 31: Some SDK providers publish it in their manifest; others will require additional investigation. If you use an SDK that doesn't support API 31, make it a priority to work with the SDK provider to resolve the issue.

Additionally, note that your app or game's targetSdkVersion may restrict access to private Android platform libraries; see NDK Apps Linking to Platform Libraries for details.

You should also verify any restrictions that may exist in the version of the Android Support Library that you're using. As always, you must ensure compatibility between the major version of Android Support Library and your app's compileSdkVersion .

We recommend that you choose a targetSdkVersion smaller than or equal to the Support Library's major version. We encourage you to update to a recent compatible Support Library in order to take advantage of the latest compatibility features and bug fixes.

Test your app

After you update your app's API level and features as appropriate, you should test some core use cases. The following suggestions are not exhaustive, but aim to guide your testing process. We suggest testing:

  • That your app compiles to API 29 without errors or warnings.

  • That your app has a strategy for cases where the user rejects permission requests, and prompts the user for permissions. To do so:

    • Go to your app's App Info screen, and disable each permission.
    • Open the app and ensure no crashes.
      • Perform core use case tests and ensure required permissions are re-prompted.

  • Handles Doze with expected results and no errors.

    • Using adb, place your test device into Doze while your app is running.
      • Test any use cases that trigger Firebase Cloud Messaging messages.
      • Test any use cases that use Alarms or Jobs.
      • Eliminate any dependencies on background services.
    • Set your app into App Standby
      • Test any use cases that trigger Firebase Cloud Messaging messages.
      • Test any use cases that use Alarms.

  • Handles new photos / video being taken

  • Handles sharing files to other apps - Test any use case that shares file data with any other app (even another app by the same developer)

    • Test the content is visible in the other app and doesn't trigger crashes.

Дополнительная информация

Opt in to emails in the Google Play Console so that we can send you important updates and announcements from Android and Google Play, including our monthly partner newsletter.