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

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

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

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

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

Отказ от функции Edge to Edge прекращается

В Android 15 реализована функция «от края до края» для приложений, предназначенных для Android 15 (уровень API 35), но ваше приложение может отказаться от неё, установив параметр R.attr#windowOptOutEdgeToEdgeEnforcement в значение true . Для приложений, предназначенных для Android 16 (уровень API 36), R.attr#windowOptOutEdgeToEdgeEnforcement устарел и отключён, и ваше приложение не может отказаться от функции «от края до края».

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

Для тестирования на Android 16 убедитесь, что ваше приложение поддерживает режим «от края до края», и удалите любое использование R.attr#windowOptOutEdgeToEdgeEnforcement , чтобы ваше приложение также поддерживало режим «от края до края» на устройстве Android 15. Чтобы узнать о поддержке режима «от края до края», см. руководство по созданию и просмотру сообщений .

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

Для приложений, ориентированных на 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 (уровень API 36), или для приложений, ориентированных на 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), ограничения по ориентации, изменению размера и соотношению сторон больше не применяются на дисплеях с минимальной шириной >= 600dp. Приложения заполняют все окно дисплея независимо от соотношения сторон или предпочтительной ориентации пользователя, и черные полосы по бокам (pillarboxing) не используются.

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

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

Распространенные изменения, нарушающие обратную связь

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

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

Детали реализации

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

• screenOrientation
• resizableActivity
• minAspectRatio
• maxAspectRatio
• setRequestedOrientation()
• getRequestedOrientation()

Следующие значения для 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>

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

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

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 и типов приоритетных служб:

• HEART_RATE_BPM от Health Services на Wear OS
• Sensor.TYPE_HEART_RATE из Android Sensor Manager
• heartRateAccuracy и heartRateBpm от ProtoLayout на Wear OS
• FOREGROUND_SERVICE_TYPE_HEALTH , где вместо BODY_SENSORS требуется соответствующее разрешение android.permission.health

Если ваше приложение использует эти 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 为目标平台的所有应用都可以使用 CompanionDeviceManager 中的公共 API 解除蓝牙设备配对。如果配套设备作为 CDM 关联进行管理，则应用可以在关联的设备上使用新的 removeBond(int) API 触发蓝牙配对的移除。该应用可以通过监听蓝牙设备广播事件 ACTION_BOND_STATE_CHANGED 来监控配对状态变化。

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

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

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

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

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

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

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

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

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

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

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

Влияние

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

• Знают о функции 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>

Примечание: атрибут можно указать в теге <application> , а также в тегах компонентов, таких как <activity> , <activity-alias> , <receiver> , <service> , <provider> , а атрибут компонента можно использовать для переопределения того, что указано в теге <application>

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

Название флага	Описание
EnsureIntentFilter	Обеспечивает более строгое соответствие входящим намерениям
никто	Отключает все специальные правила сопоставления для входящих намерений. При указании нескольких флагов конфликтующие значения разрешаются путём предоставления приоритета флагу «none».
allowNullAction	Ослабляет правила сопоставления, позволяя сопоставлять намерения без действия. Этот флаг следует использовать вместе с «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:")

Фильтрация системных вызовов GPU

Для повышения безопасности графического процессора Mali в производственных сборках заблокированы устаревшие или предназначенные исключительно для разработки графических процессоров IOCTL-коды Mali GPU. Кроме того, IOCTL-коды, используемые для профилирования графических процессоров, ограничены процессом оболочки или отлаживаемыми приложениями. Подробнее о политике на уровне платформы см. в обновлении SAC.

Это изменение происходит на устройствах Pixel с графическим процессором Mali (Pixel 6-9). Компания Arm предоставила официальную классификацию своих IOCTL в Documentation/ioctl-categories.rst версии r54p2 . Этот список будет поддерживаться в будущих версиях драйверов.

Это изменение не повлияет на поддерживаемые графические API (включая Vulkan и OpenGL) и, как ожидается, не повлияет на разработчиков или существующие приложения. Инструменты профилирования графического процессора, такие как Streamline Performance Analyzer и Android GPU Inspector, не будут затронуты.

Тестирование

Если вы видите сообщение об отказе SELinux, похожее на следующее, скорее всего, это изменение повлияло на ваше приложение:

06-30 10:47:18.617 20360 20360 W roidJUnitRunner: type=1400 audit(0.0:85): avc:  denied  { ioctl }
for  path="/dev/mali0" dev="tmpfs" ino=1188 ioctlcmd=0x8023
scontext=u:r:untrusted_app_25:s0:c512,c768 tcontext=u:object_r:gpu_device:s0 tclass=chr_file
permissive=0 app=com.google.android.selinux.pts

Если вашему приложению необходимо использовать заблокированные IOCTL, сообщите об ошибке и направьте ее на адрес [e-mail].

Часто задаваемые вопросы

1. Распространяется ли это изменение политики на всех OEM-производителей? Это изменение будет добровольным, но доступным для всех OEM-производителей, желающих использовать этот метод защиты. Инструкции по внедрению изменения можно найти в документации по внедрению.

2. Обязательно ли вносить изменения в кодовую базу OEM для реализации этого, или это по умолчанию включено в новый релиз AOSP? Изменения на уровне платформы по умолчанию будут включены в новый релиз AOSP. Поставщики могут включить это изменение в свою кодовую базу, если захотят.

3. Отвечают ли SoC за поддержание списка IOCTL в актуальном состоянии? Например, если в моём устройстве используется графический процессор ARM Mali, нужно ли мне обращаться в ARM за какими-либо изменениями? Каждый SoC должен обновлять свои списки IOCTL для каждого устройства после выпуска драйвера. Например, ARM обновляет опубликованный список IOCTL при обновлении драйверов. Однако OEM-производители должны включить обновления в свою политику безопасности (SEPolicy) и добавлять в списки любые выбранные пользовательские IOCTL по мере необходимости.

4. Применяется ли это изменение автоматически ко всем устройствам Pixel, доступным на рынке, или для его применения требуется действие пользователя, чтобы включить какой-либо переключатель? Это изменение применяется ко всем устройствам Pixel, доступным на рынке, с графическим процессором Mali (Pixel 6-9). Для применения этого изменения не требуется никаких действий пользователя.

5. Повлияет ли использование этой политики на производительность драйвера ядра? Эта политика была протестирована на графическом процессоре Mali с помощью GFXBench, и никаких заметных изменений производительности графического процессора не наблюдалось.

6. Необходимо ли, чтобы список IOCTL соответствовал текущим версиям драйверов пользовательского пространства и ядра? Да, список разрешённых IOCTL должен быть синхронизирован с IOCTL, поддерживаемыми как драйверами пользовательского пространства, так и драйверами ядра. Если IOCTL в пользовательском пространстве или драйвере ядра обновляются, список IOCTL SEPolicy также должен быть обновлён для соответствия.

7. Компания ARM классифицировала IOCTL как «ограниченные»/«инструментальные», но мы хотим использовать некоторые из них в производственных сценариях и/или запретить другие. Каждый OEM-производитель/систем на кристалле самостоятельно определяет, как классифицировать используемые им IOCTL, основываясь на конфигурации библиотек Mali в пользовательском пространстве. Список ARM может помочь в принятии решения, но сценарии использования каждого OEM-производителя/системы на кристалле могут отличаться.

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

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

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

具有 INTERNET 权限的任何应用都可以访问局域网上的设备。 这使得应用可以轻松连接到本地设备，但也存在隐私影响，例如形成用户指纹，以及成为位置信息的代理。

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

发布计划

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

影响

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

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

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

向本地网络地址发送流量和从本地网络地址接收流量需要本地网络访问权限。下表列出了一些常见情况：

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

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

注意： 源自需要本地网络访问权限的 Android WebView 的流量将继承宿主应用的权限状态

上述规则的例外情况：

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

注意： 许多媒体投屏场景都依赖于对本地网络的访问权限，因此会受到此变更的影响。不过，并非所有提供投屏功能的应用都需要请求新权限。我们将在 25Q4 中提供未来 API 和处理投屏场景的指南。

开发者指南（选择启用）

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

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. 依次前往设置 > 应用 > [应用名称] > 权限 > 附近的设备 > 允许。

注意： 在未来的 Android 版本中，此功能将受“附近的设备”权限组中的新权限保护

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

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

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

使用以下命令切换关闭应用兼容性标志

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" %}