Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .

Эта страница переведена с помощью Cloud Translation API.

Мультирезюме

В Android 9 (и более ранних версиях) приложения переводились в состояние PAUSED когда:

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

Эти ситуации различаются количеством приостановок , которое должно выполнять приложение, но их нельзя различить на уровне приложения.

В Android 10 все основные действия в видимых стеках находятся в состоянии RESUMED . Это улучшает совместимость с режимами Multi-Window и MD для приложений, которые используют onPause() вместо onStop() , чтобы прекратить обновление пользовательского интерфейса и взаимодействие с пользователем. Это означает:

Оба действия в разделенном экране возобновляются.
Возобновляются все самые видимые действия в свободном оконном режиме.
Действия на нескольких экранах могут быть возобновлены одновременно.

Рисунок 1. Мультирезюме на складном устройстве

Рисунок 2. Мультирезюме в режиме рабочего стола

Действия могут находиться в состоянии PAUSED когда на них нельзя сфокусироваться или они частично закрыты, например:

В свернутом разделенном экране (с панелью запуска сбоку) верхняя активность не возобновляется, потому что на нее нельзя сфокусироваться.
В режиме «картинка в картинке» действие не возобновляется, потому что на него нельзя сфокусироваться.
Когда действия покрываются другими прозрачными действиями в том же стеке.

Этот подход указывает приложениям, что действие может получать ввод от пользователя только в состоянии RESUMED . До Android 10 действия также могли получать входные данные в состоянии PAUSED (например, попробуйте одновременно коснуться обоих действий в режиме разделенного экрана на устройстве под управлением Android 9).

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

Activity#onTopResumedActivityChanged(boolean onTop)

При вызове этот обратный вызов вызывается между Activity#onResume() и Activity#onPause() . Этот обратный вызов является необязательным и может быть пропущен, поэтому действие может перейти из состояния RESUMED в состояние PAUSED , не становясь самым верхним в системе. Например, в многооконном режиме. Поскольку этот обратный вызов является необязательным, он не является частью жизненного цикла действия и должен использоваться редко.

Предыдущее действие с возобновлением наверху получает и завершает выполнение onTopResumedActivity(false) до того, как следующее действие с возобновлением наверху получит onTopResumedActivity(true) , если предыдущее действие не занимает слишком много времени для обработки вызова метода и не достигает тайм-аута 500 мс.

Совместимость

Чтобы обеспечить совместимость при реализации нескольких резюме, рассмотрите эти решения.

Несколько возобновленных действий в одном процессе приложения

Проблема. В Android 9 и ниже одновременно возобновляется только одно действие в системе. Все переходы между действиями предполагают приостановку действия перед возобновлением другого. Некоторые приложения и фреймворки (такие как Flutter или Android LocalActivityManager) используют этот факт и сохраняют состояние возобновленной активности в синглтонах.
Решение. В Android 9 и более ранних версиях, если возобновляются два действия из одного и того же процесса, система возобновляет только действие с более высоким Z-порядком. Приложения, ориентированные на Android 10, могут поддерживать одновременное возобновление нескольких действий.

Одновременный доступ к камере

Проблемы . Эти проблемы также присутствуют в Android 9 и более ранних версиях. Например, полноэкранное и возобновленное действие может переключить фокус камеры на приостановленное действие вверху в режиме «картинка в картинке», но стать более заметным при более широком внедрении многооконного и многоэкранного режимов.
- Из-за изменений, внесенных в состояние RESUME , приложения могут быть отключены от камеры даже во время возобновления работы. Чтобы решить эту проблему, приложения должны обрабатывать отключение камеры без сбоев. При отключении приложения получают обратный вызов отключения, и все вызовы в API начинают CameraAccessException .
- resizeableActivity=false не является гарантией эксклюзивного доступа к камере, поскольку другие приложения, использующие камеру, могут быть открыты на других дисплеях.
Решения. Разработчики должны включить логику, когда приложение отключается от камеры. Если приложение отключено от камеры, оно должно отслеживать обратные вызовы доступности камеры, чтобы попытаться повторно подключиться и продолжить использование камеры. В дополнение к существующему CameraManager#AvailabilityCallback#onCameraAvailable() в Android 10 добавлен CameraManager#AvailabilityCallback#onCameraAccessPrioritiesChanged() , который охватывает случай, когда фокус (и приоритет камеры) переключается между несколькими возобновленными действиями. Разработчики приложений должны использовать оба этих обратных вызова, чтобы определить подходящее время для попытки получить доступ к камере.

Мульти-резюме

В Android 10 состояние жизненного цикла активности определяется видимостью и Z-порядком. Чтобы убедиться, что правильное состояние после обновления видимости для действия и оценить, какое состояние жизненного цикла применимо, вызовите метод ActivityRecord#makeActiveIfNeeded() из разных мест. В Android 10 активный означает RESUMED или PAUSED и работает только в этих двух случаях.

В Android 10 возобновление действия отслеживается отдельно в каждом стеке, а не в одном месте в системе. Это связано с тем, что несколько переходов активности могут выполняться одновременно в многооконных режимах. Дополнительные сведения см. в разделе ActivityStack#mInResumeTopActivity .

Обратный вызов по возобновленной активности

После действий, которые могут привести к изменению основного действия (например, запуск, возобновление действия или изменение Z-порядка), ActivityStackSupervisor#updateTopResumedActivityIfNeeded() . Этот метод проверяет, изменилась ли самая верхняя возобновленная активность, и при необходимости выполняет обновление. Если предыдущее действие с возобновлением наибольшей активности не освободило состояние возобновления наибольшей активности, то ему отправляется сообщение о потере состояния наибольшей возобновленной активности, а на стороне сервера планируется тайм-аут ( ActivityStackSupervisor#scheduleTopResumedStateLossTimeout() ). Отчет о состоянии верхнего возобновления отправляется следующему действию после того, как предыдущее освободило состояние или когда истекло время ожидания (см. Использование:

ActivityStackSupervisor#scheduleTopResumedActivityStateIfNeeded()

Был добавлен новый элемент транзакции TopResumedActivityChangeItem , чтобы сообщать клиентам об изменениях состояния, возобновленных в верхней части, и использует архитектуру ActivityLifecycler из Android 9.

Верхнее возобновленное состояние сохраняется на стороне клиента, и каждый раз, когда действие переходит в RESUMED или PAUSED , оно также проверяет, следует ли вызывать обратный вызов onTopResumedActivityChanged() . Это обеспечивает определенную развязку в обмене состояниями жизненного цикла и состоянием верхнего возобновления между серверной и клиентской сторонами.