Изменения в поведении: приложения для Android 16 или более поздней версии.

Как и предыдущие выпуски, Android 16 включает изменения поведения, которые могут повлиять на ваше приложение. Следующие изменения поведения применяются исключительно к приложениям, предназначенным для Android 16 или выше. Если ваше приложение предназначено для Android 16 или выше, вам следует изменить свое приложение для поддержки этих поведений, где это применимо.

Обязательно ознакомьтесь со списком изменений поведения, которые влияют на все приложения, работающие на Android 16, независимо от targetSdkVersion вашего приложения.

Пользовательский опыт и системный пользовательский интерфейс

Android 16 (уровень API 36) включает в себя следующие изменения, направленные на создание более последовательного и интуитивно понятного пользовательского опыта.

Отказ от использования Edge to Edge прекращается

Android 15 принудительно использует Edge-to-Edge для приложений, ориентированных на Android 15 (уровень API 35), но ваше приложение может отказаться от этого, установив R.attr#windowOptOutEdgeToEdgeEnforcement в значение true . Для приложений, ориентированных на Android 16 (уровень API 36), R.attr#windowOptOutEdgeToEdgeEnforcement устарел и отключен, и ваше приложение не может отказаться от перехода на Edge-to-Edge.

  • Если ваше приложение ориентировано на Android 16 (уровень API 36) и работает на устройстве Android 15, R.attr#windowOptOutEdgeToEdgeEnforcement продолжает работать.
  • Если ваше приложение ориентировано на Android 16 (уровень API 36) и работает на устройстве Android 16, R.attr#windowOptOutEdgeToEdgeEnforcement отключен.

Для тестирования в Android 16 Beta 3 убедитесь, что ваше приложение поддерживает Edge-to-Edge, и удалите любое использование R.attr#windowOptOutEdgeToEdgeEnforcement чтобы ваше приложение также поддерживало Edge-to-Edge на устройстве Android 15. Чтобы обеспечить поддержку Edge-to-Edge, см. руководство Compose и Views .

,

Android 15 принудительно использует Edge-to-Edge для приложений, ориентированных на Android 15 (уровень API 35), но ваше приложение может отказаться от этого, установив R.attr#windowOptOutEdgeToEdgeEnforcement в значение true . Для приложений, ориентированных на Android 16 (уровень API 36), R.attr#windowOptOutEdgeToEdgeEnforcement устарел и отключен, и ваше приложение не может отказаться от перехода на Edge-to-Edge.

  • Если ваше приложение ориентировано на Android 16 (уровень API 36) и работает на устройстве Android 15, R.attr#windowOptOutEdgeToEdgeEnforcement продолжает работать.
  • Если ваше приложение ориентировано на Android 16 (уровень API 36) и работает на устройстве Android 16, R.attr#windowOptOutEdgeToEdgeEnforcement отключен.

Для тестирования в Android 16 Beta 3 убедитесь, что ваше приложение поддерживает Edge-to-Edge, и удалите любое использование R.attr#windowOptOutEdgeToEdgeEnforcement чтобы ваше приложение также поддерживало Edge-to-Edge на устройстве Android 15. Чтобы обеспечить поддержку Edge-to-Edge, см. руководство Compose и Views .

Для прогнозируемого возврата требуется миграция или отказ

Для приложений, ориентированных на Android 16 (API уровня 36) или выше и работающих на устройстве Android 16 или выше, предиктивные анимации системы возврата (возврат на главную страницу, кросс-задача и кросс-активность) включены по умолчанию. Кроме того, onBackPressed не вызывается, а KeyEvent.KEYCODE_BACK больше не отправляется.

Если ваше приложение перехватывает событие возврата, а вы еще не перешли на предиктивный возврат, обновите свое приложение, чтобы использовать поддерживаемые API обратной навигации , или временно откажитесь от этого, установив атрибут android:enableOnBackInvokedCallback на false в теге <application> или <activity> файла AndroidManifest.xml вашего приложения.

Предиктивная анимация возвращения домой.
Предиктивная анимация перекрестной активности.
Предиктивная анимация перекрестных задач.

API элегантных шрифтов устарели и отключены

В приложениях, предназначенных для Android 15 (уровень API 35), атрибуту elegantTextHeight TextView по умолчанию присвоено значение true , заменяя компактный шрифт гораздо более читаемым. Вы можете переопределить это, установив для атрибута elegantTextHeight значение false .

В Android 16 атрибут elegantTextHeight устарел, и этот атрибут будет игнорироваться, как только ваше приложение будет ориентировано на Android 16. Поддержка «шрифтов пользовательского интерфейса», управляемых этими API, прекращается, поэтому вам следует адаптировать любые макеты, чтобы обеспечить согласованное и перспективное отображение текста на арабском, лаосском, мьянманском, тамильском, гуджаратском, каннада, малаялам, одиа, телугу или тайском языках.

поведение elegantTextHeight для приложений, ориентированных на Android 14 (уровень API 34) и ниже, или для приложений, ориентированных на Android 15 (уровень API 35), которые переопределили значение по умолчанию, установив для атрибута elegantTextHeight значение false .
поведение elegantTextHeight для приложений, ориентированных на Android 16, или для приложений, ориентированных на Android 15 (уровень API 35), которые не переопределили значение по умолчанию, установив для атрибута elegantTextHeight значение false .

Основная функциональность

Android 16 (уровень API 36) включает в себя следующие изменения, которые изменяют или расширяют различные основные возможности системы Android.

Оптимизация графика работы с фиксированной ставкой

До ориентации на Android 16, когда scheduleAtFixedRate пропускало выполнение задачи из-за того, что оно находилось за пределами допустимого жизненного цикла процесса , все пропущенные выполнения выполнялись немедленно, когда приложение возвращалось к допустимому жизненному циклу.

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

Форм-факторы устройств

Android 16 (уровень API 36) включает следующие изменения для приложений при отображении на устройствах с большим экраном.

Адаптивные макеты

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

Игнорировать ограничения по ориентации, изменению размера и соотношению сторон

Для приложений, ориентированных на Android 16 (API уровня 36), Android 16 включает изменения в том, как система управляет ограничениями ориентации, изменения размера и соотношения сторон. На дисплеях с наименьшей шириной >= 600dp ограничения больше не применяются. Приложения также заполняют все окно дисплея, независимо от соотношения сторон или предпочитаемой пользователем ориентации, а Pillarboxing не используется.

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

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

Общие критические изменения

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

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

Подробности реализации

Следующие атрибуты манифеста и API среды выполнения игнорируются на устройствах с большим экраном в полноэкранном и многооконном режимах:

Следующие значения для screenOrientation , setRequestedOrientation() и getRequestedOrientation() игнорируются:

  • portrait
  • reversePortrait
  • sensorPortrait
  • userPortrait
  • landscape
  • reverseLandscape
  • sensorLandscape
  • userLandscape

Что касается изменения размера дисплея, android:resizeableActivity="false" , android:minAspectRatio и android:maxAspectRatio не оказывают никакого эффекта.

Для приложений, ориентированных на Android 16 (уровень API 36), ограничения по ориентации, изменению размера и соотношению сторон приложения по умолчанию игнорируются на больших экранах, но каждое приложение, которое не полностью готово, может временно переопределить это поведение, отказавшись от него (что приведет к предыдущему поведению — переходу в режим совместимости).

Исключения

Ограничения Android 16 по ориентации, изменению размера и соотношению сторон не применяются в следующих ситуациях:

  • Игры (на основе флага android:appCategory )
  • Пользователи явно соглашаются на поведение приложения по умолчанию в настройках соотношения сторон устройства.
  • Экраны меньше sw600dp

Отказаться временно

Чтобы отказаться от определенного действия, объявите свойство манифеста PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY :

<activity ...>
  <property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY" android:value="true" />
  ...
</activity>

Если слишком много частей вашего приложения не готовы к Android 16, вы можете полностью отказаться от этого, применив то же свойство на уровне приложения:

<application ...>
  <property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY" android:value="true" />
</application>

Здоровье и фитнес

Android 16 (уровень API 36) включает следующие изменения, связанные с данными о здоровье и фитнесе.

Разрешения на здоровье и фитнес

Для приложений, ориентированных на Android 16 (уровень API 36) или выше, разрешения BODY_SENSORS используют более детальные разрешения в android.permissions.health , которые также использует Health Connect . Начиная с Android 16, любой API, ранее требовавший BODY_SENSORS или BODY_SENSORS_BACKGROUND требует вместо этого соответствующее разрешение android.permissions.health . Это влияет на следующие типы данных, API и типы служб переднего плана:

Если ваше приложение использует эти API, оно должно запрашивать соответствующие детальные разрешения:

  • Для мониторинга частоты сердечных сокращений, SpO2 или температуры кожи во время использования: запросите детальное разрешение в android.permissions.health , например READ_HEART_RATE вместо BODY_SENSORS .
  • Для доступа к фоновому датчику: запросите READ_HEALTH_DATA_IN_BACKGROUND вместо BODY_SENSORS_BACKGROUND .

Эти разрешения аналогичны тем, которые защищают доступ к чтению данных из Health Connect — хранилища данных Android для здоровья, фитнеса и благополучия.

Мобильные приложения

Мобильные приложения, мигрирующие для использования READ_HEART_RATE и других детализированных разрешений, также должны объявить активность для отображения политики конфиденциальности приложения. Это то же требование, что и для Health Connect.

Связность

Android 16 (уровень API 36) включает следующие изменения в стеке Bluetooth для улучшения связи с периферийными устройствами.

Новые намерения по управлению потерями облигаций и изменениями шифрования

В рамках улучшенной обработки потери облигаций в Android 16 также представлены 2 новых намерения, которые предоставляют приложениям более подробную информацию об изменениях в потере облигаций и шифровании.

Приложения для Android 16 теперь могут:

  • Получать намерение ACTION_KEY_MISSING при обнаружении удаленной потери связи, что позволяет им предоставлять более информативную обратную связь пользователю и предпринимать соответствующие действия.
  • Получайте намерение ACTION_ENCRYPTION_CHANGE всякий раз, когда изменяется статус шифрования ссылки. Это включает изменение статуса шифрования, изменение алгоритма шифрования и изменение размера ключа шифрования. Приложения должны считать связь восстановленной, если ссылка успешно зашифрована при получении намерения ACTION_ENCRYPTION_CHANGE позже.

Адаптация к различным реализациям OEM

Хотя Android 16 представляет эти новые намерения, их реализация и трансляция могут различаться у разных производителей устройств (OEM). Чтобы гарантировать, что ваше приложение обеспечивает единообразный и надежный опыт на всех устройствах, разработчикам следует разработать обработку потери связи, чтобы изящно адаптироваться к этим потенциальным изменениям.

Мы рекомендуем следующее поведение приложения:

  • Если транслируется намерение ACTION_KEY_MISSING :

    Система отключит соединение ACL (асинхронное соединение без установления соединения), но информация о соединении для устройства будет сохранена (как описано здесь ).

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

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

  • Если намерение ACTION_KEY_MISSING НЕ транслируется:

    Ссылка ACL останется подключенной, а информация о связи для устройства будет удалена системой, аналогично поведению в Android 15.

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

Новый способ удаления связи Bluetooth

Все приложения, ориентированные на Android 16, теперь могут отключать сопряжение устройств Bluetooth с помощью общедоступного API в CompanionDeviceManager . Если сопутствующее устройство управляется как ассоциация CDM, то приложение может инициировать удаление связи Bluetooth с помощью нового API removeBond(int) на связанном устройстве. Приложение может отслеживать изменения состояния связи, прослушивая событие широковещательной передачи устройства Bluetooth ACTION_BOND_STATE_CHANGED .

Безопасность

Android 16 (уровень API 36) включает следующие изменения безопасности.

Блокировка версии MediaStore

Для приложений, предназначенных для Android 16 или более поздних версий, MediaStore#getVersion() теперь будет уникальным для каждого приложения. Это исключает идентификацию свойств из строки версии, чтобы предотвратить злоупотребление и использование методов снятия отпечатков пальцев. Приложения не должны делать никаких предположений относительно формата этой версии. Приложения уже должны обрабатывать изменения версий при использовании этого API, и в большинстве случаев им не нужно менять свое текущее поведение, если только разработчик не попытался получить дополнительную информацию, выходящую за рамки предполагаемой области действия этого API.

Более безопасные намерения

Функция Safer Intents — это многоэтапная инициатива безопасности, призванная улучшить безопасность механизма разрешения намерений Android. Цель — защитить приложения от вредоносных действий путем добавления проверок во время обработки намерений и фильтрации намерений, которые не соответствуют определенным критериям.

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

Реализуются два ключевых изменения:

  1. Явные намерения должны соответствовать фильтру намерений целевого компонента: если намерение явно нацелено на компонент, оно должно соответствовать фильтру намерений этого компонента.

  2. Намерения без действия не могут соответствовать ни одному фильтру намерений: Намерения, для которых не указано действие, не должны разрешаться ни в один фильтр намерений.

Эти изменения применяются только при использовании нескольких приложений и не влияют на обработку намерений в рамках одного приложения.

Влияние

Природа Opt-in означает, что разработчики должны явно включить его в манифесте своего приложения, чтобы он вступил в силу. В результате влияние функции будет ограничено приложениями, разработчики которых:

  • Знают о функции Safer Intents и ее преимуществах.
  • Активно внедрять в свои приложения более строгие практики обработки намерений.

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

Хотя первоначальное воздействие в Android 16 может быть ограниченным, инициатива Safer Intents имеет дорожную карту для более широкого воздействия в будущих выпусках Android. План состоит в том, чтобы в конечном итоге сделать строгое разрешение намерений поведением по умолчанию.

Функция Safer Intents может значительно повысить безопасность экосистемы Android, затруднив вредоносным приложениям использование уязвимостей в механизме разрешения намерений.

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

Выполнение

Разработчикам необходимо явно включить более строгое сопоставление намерений с помощью атрибута intentMatchingFlags в манифесте приложения. Вот пример, где функция включена для всего приложения, но отключена/отключена для получателя:

<application android:intentMatchingFlags="enforceIntentFilter">
    <receiver android:name=".MyBroadcastReceiver" android:exported="true" android:intentMatchingFlags="none">
        <intent-filter>
            <action android:name="com.example.MY_CUSTOM_ACTION" />
        </intent-filter>
        <intent-filter>
            <action android:name="com.example.MY_ANOTHER_CUSTOM_ACTION" />
        </intent-filter>
    </receiver>
</application>

Подробнее о поддерживаемых флагах:

Имя флага Описание
Принудительный фильтр намерений Обеспечивает более строгое соответствие входящим намерениям
никто Отключает все специальные правила сопоставления для входящих намерений. При указании нескольких флагов конфликтующие значения разрешаются путем предоставления приоритета флагу "none"
разрешитьNullAction Ослабляет правила сопоставления, чтобы разрешить сопоставление намерений без действия. Этот флаг следует использовать вместе с "enforceIntentFilter" для достижения определенного поведения

Тестирование и отладка

Когда принудительное применение активно, приложения должны работать правильно, если вызывающий намерение правильно заполнил намерение. Однако заблокированные намерения вызовут предупреждающие сообщения журнала, такие как "Intent does not match component's intent filter:" и "Access blocked:" с тегом "PackageManager." Это указывает на потенциальную проблему, которая может повлиять на приложение и требует внимания.

Фильтр Logcat:

tag=:PackageManager & (message:"Intent does not match component's intent filter:" | message: "Access blocked:")

Конфиденциальность

Android 16 (уровень API 36) включает следующие изменения в конфиденциальности.

Разрешение локальной сети

具有 INTERNET 权限的任何应用都可以访问 LAN 上的设备。这样一来，应用便可以轻松连接到本地设备，但也存在隐私问题，例如形成用户的指纹，以及充当位置信息的代理。

本地网络保护项目旨在通过将对本地网络的访问权限置于新的运行时权限后面来保护用户的隐私。

发布计划

这项更改将在两个版本（分别为 25Q2 和 TBD）之间部署。开发者必须遵循 25Q2 的相关指南并分享反馈，因为这些保护措施将在较新的 Android 版本中强制执行。此外，他们需要按照以下指南更新依赖于隐式本地网络访问权限的场景，并为用户拒绝和撤消新权限做好准备。

影响

目前，LNP 是一项用户可选择启用的功能，这意味着只有选择启用该功能的应用会受到影响。选择启用阶段的目标是让应用开发者了解其应用的哪些部分依赖于隐式本地网络访问权限，以便他们为下一个版本做好权限保护准备。

如果应用使用以下方式访问用户的本地网络，则会受到影响：

  • 在本地网络地址上直接或通过库使用原始套接字（例如 mDNS 或 SSDP 服务发现协议）
  • 使用访问本地网络的框架级类（例如 NsdManager）

到和从本地网络地址发送的流量需要本地网络访问权限。下表列出了一些常见用例：

应用低级网络操作 需要本地网络权限
建立出站 TCP 连接 是
接受传入的 TCP 连接 是
发送 UDP 单播、多播、广播 是
接收传入的 UDP 单播、多播、广播 是

这些限制在网络堆栈深处实现，因此适用于所有网络 API。这包括在原生代码或受管理代码中创建的套接字、Cronet 和 OkHttp 等网络库，以及在这些库之上实现的任何 API。尝试解析本地网络上的服务（即带有 .local 后缀的服务）需要本地网络权限。

上述规则的例外情况：

  • 如果设备的 DNS 服务器位于本地网络中，则向其发送或从其接收的流量（在端口 53 上）不需要本地网络访问权限。
  • 使用输出切换器作为应用内选择器的应用无需本地网络权限（更多指南将于 2025 年第 4 季度发布）。

开发者指南（用户选择启用）

如需选择启用本地网络限制，请执行以下操作：

  1. 将设备刷写为搭载 25Q2 Beta 版 3 或更高版本的 build。
  2. 安装要测试的应用。

  3. 在 adb 中切换 Appcompat 标志：

    adb shell am compat enable RESTRICT_LOCAL_NETWORK <package_name>

  4. 重启设备

现在，您的应用对本地网络的访问权限受到限制，任何尝试访问本地网络的操作都会导致套接字错误。如果您使用的 API 在应用进程之外执行本地网络操作（例如 NsdManager），则在用户选择启用该功能期间，这些 API 不会受到影响。

如需恢复访问权限，您必须向应用授予 NEARBY_WIFI_DEVICES 权限。

  1. 确保应用在其清单中声明了 NEARBY_WIFI_DEVICES 权限。
  2. 依次前往设置 > 应用 > [应用名称] > 权限 > 附近的设备 > 允许。

现在，您的应用对本地网络的访问权限应该已恢复，并且所有场景都应像在应用选择启用之前一样正常运行。

本地网络保护功能开始强制执行后，应用网络流量将受到以下影响。

权限 出站 LAN 请求 出站/入站互联网请求 入站 LAN 请求
已授予 Works Works Works
未授予 最差排行榜 Works 最差排行榜

使用以下命令关闭 App-Compat 标志

adb shell am compat disable RESTRICT_LOCAL_NETWORK <package_name>

错误

每当调用套接字向本地网络地址调用 send 或 send 变体时，系统都会将因这些限制而产生的错误返回给调用套接字。

错误示例：

sendto failed: EPERM (Operation not permitted)

sendto failed: ECONNABORTED (Operation not permitted)

本地网络定义

本项目中的本地网络是指使用支持广播的网络接口（例如 Wi-Fi 或以太网）的 IP 网络，但不包括移动网络 (WWAN) 或 VPN 连接。

以下网络被视为本地网络：

IPv4：

  • 169.254.0.0/16 // 链路本地
  • 100.64.0.0/10 // CGNAT
  • 10.0.0.0/8 // RFC1918
  • 172.16.0.0/12 // RFC1918
  • 192.168.0.0/16 // RFC1918

IPv6：

  • 链路本地
  • 直接连接的路线
  • Thread 等桩网络
  • 多个子网（待定）

此外，多播地址 (224.0.0.0/4、ff00::/8) 和 IPv4 广播地址 (255.255.255.255) 都被归类为本地网络地址。

Фотографии, принадлежащие приложению

{% включают "/training/data-storage/shared/___owned-photos" %}