Изменения в поведении: приложения для 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 或更高版本的设备上运行的应用，预测性返回系统动画（返回主屏幕、跨任务和跨 activity）默认处于启用状态。此外，系统不会调用 onBackPressed，也不会再调度 KeyEvent.KEYCODE_BACK。

如果您的应用拦截了返回事件，并且您尚未迁移到预测性返回，请更新应用以使用受支持的返回导航 API；或者，在应用的 AndroidManifest.xml 文件的 <application> 或 <activity> 标记中将 android:enableOnBackInvokedCallback 属性设置为 false，以暂时停用此功能。

“返回主页”预测性返回动画。
预测性跨 activity 动画。
预测性跨任务动画。

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

Apps targeting Android 15 (API level 35) have the elegantTextHeight TextView attribute set to true by default, replacing the compact font with one that is much more readable. You could override this by setting the elegantTextHeight attribute to false.

Android 16 deprecates the elegantTextHeight attribute, and the attribute will be ignored once your app targets Android 16. The "UI fonts" controlled by these APIs are being discontinued, so you should adapt any layouts to ensure consistent and future proof text rendering in Arabic, Lao, Myanmar, Tamil, Gujarati, Kannada, Malayalam, Odia, Telugu or Thai.

elegantTextHeight behavior for apps targeting Android 14 (API level 34) and lower, or for apps targeting Android 15 (API level 35) that overrode the default by setting the elegantTextHeight attribute to false.
elegantTextHeight behavior for apps targeting Android 16, or for apps targeting Android 15 (API level 35) that didn't override the default by setting the elegantTextHeight attribute to false.

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

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

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

Prior to targeting Android 16, when scheduleAtFixedRate missed a task execution due to being outside a valid process lifecycle, all missed executions immediately execute when the app returns to a valid lifecycle.

When targeting Android 16, at most one missed execution of scheduleAtFixedRate is immediately executed when the app returns to a valid lifecycle. This behavior change is expected to improve app performance. Test this behavior in your app to check if your app is impacted. You can also test by using the app compatibility framework and enabling the STPE_SKIP_MULTIPLE_MISSED_PERIODIC_TASKS compat flag.

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

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 个新 intent，以便应用更好地了解键值对丢失和加密更改。

以 Android 16 为目标平台的应用现在可以：

  • 在检测到远程键盘连接丢失时接收 ACTION_KEY_MISSING intent，以便提供更具信息量的用户反馈并采取适当的措施。
  • 每当链接的加密状态发生变化时，都会收到 ACTION_ENCRYPTION_CHANGE intent。这包括加密状态更改、加密算法更改和加密密钥大小更改。如果应用在稍后收到 ACTION_ENCRYPTION_CHANGE intent 时成功加密了链接，则必须将该绑定视为已恢复。

适应不同的 OEM 实现

虽然 Android 16 引入了这些新 intent，但其实现和广播可能会因不同的设备制造商 (OEM) 而异。为了确保您的应用在所有设备上都能提供一致且可靠的体验，开发者应设计其绑定丢失处理机制，以妥善适应这些潜在的变化。

我们建议您采用以下应用行为：

  • 如果广播 ACTION_KEY_MISSING intent：

    系统会断开 ACL（异步无连接）链接，但会保留设备的配对信息（如此处所述）。

    您的应用应将此 intent 用作检测配对丢失的主要信号，并在发起设备忘记或重新配对之前引导用户确认远程设备是否在范围内。

    如果设备在收到 ACTION_KEY_MISSING 后断开连接，您的应用应谨慎重新连接，因为设备可能已不再与系统绑定。

  • 如果未广播 ACTION_KEY_MISSING intent：

    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

For apps targeting Android 16 or higher, MediaStore#getVersion() will now be unique to each app. This eliminates identifying properties from the version string to prevent abuse and usage for fingerprinting techniques. Apps shouldn't make any assumptions around the format of this version. Apps should already handle version changes when using this API and in most cases shouldn't need to change their current behavior, unless the developer has attempted to infer additional information that is beyond the intended scope of this 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" %}