Verhaltensänderungen: Apps, die auf Android 16 oder höher ausgerichtet sind

Wie bei früheren Releases enthält Android 16 Verhaltensänderungen, die sich auf Ihre App auswirken können. Die folgenden Verhaltensänderungen gelten ausschließlich für Apps, die auf Android 16 oder höher ausgerichtet sind. Wenn Ihre App auf Android 16 oder höher ausgerichtet ist, sollten Sie sie gegebenenfalls so ändern, dass sie diese Verhaltensweisen unterstützt.

Lesen Sie sich auch die Liste der Verhaltensänderungen durch, die sich auf alle Apps auswirken, die unter Android 16 ausgeführt werden, unabhängig von der targetSdkVersion Ihrer App.

Nutzerfreundlichkeit und System-UI

Android 16 (API-Level 36) enthält die folgenden Änderungen, die eine einheitlichere und intuitivere Nutzererfahrung ermöglichen sollen.

Deaktivierung von „Edge to Edge“ wird eingestellt

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 Beta 版 3 中进行测试,请确保您的应用支持无边框设计,并移除对 R.attr#windowOptOutEdgeToEdgeEnforcement 的所有使用,以便您的应用在 Android 15 设备上也支持无边框设计。如需支持边到边,请参阅 ComposeViews 指南。

Migration oder Deaktivierung für die Prognosefunktion erforderlich

对于以 Android 16(API 级别 36)或更高版本为目标平台且在 Android 16 或更高版本的设备上运行的应用,预测性返回系统动画(返回主屏幕、跨任务和跨 activity)默认处于启用状态。此外,系统不会调用 onBackPressed,也不会再调度 KeyEvent.KEYCODE_BACK

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

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

Elegant-Schrift-APIs werden eingestellt und deaktiviert

Bei Apps, die auf Android 15 (API-Level 35) ausgerichtet sind, ist das Attribut elegantTextHeight TextView standardmäßig auf true festgelegt. Dadurch wird die kompakte Schrift durch eine deutlich lesbarere Schrift ersetzt. Sie können dies überschreiben, indem Sie das elegantTextHeight-Attribut auf false festlegen.

Unter Android 16 wird das Attribut elegantTextHeight eingestellt. Es wird ignoriert, sobald Ihre App auf Android 16 ausgerichtet ist. Die von diesen APIs gesteuerten „UI-Schriftarten“ werden eingestellt. Sie sollten daher alle Layouts anpassen, um eine einheitliche und zukunftssichere Textdarstellung in Arabisch, Lao, Myanmar, Tamil, Gujarati, Kannada, Malayalam, Odia, Telugu oder Thai zu gewährleisten.

elegantTextHeight-Verhalten für Apps, die auf Android 14 (API-Level 34) und niedriger oder auf Android 15 (API-Level 35) ausgerichtet sind und bei denen die Standardeinstellung durch Festlegen des Attributs elegantTextHeight auf false überschrieben wurde.
elegantTextHeight-Verhalten für Apps, die auf Android 16 ausgerichtet sind, oder für Apps, die auf Android 15 (API-Level 35) ausgerichtet sind und bei denen die Standardeinstellung nicht durch Festlegen des elegantTextHeight-Attributs auf false überschrieben wurde.

Hauptfunktion

Android 16 (API-Level 36) enthält die folgenden Änderungen, die verschiedene Kernfunktionen des Android-Systems ändern oder erweitern.

Optimierung der Planung von Aufträgen mit fester Rate

在以 Android 16 为目标平台之前,如果 scheduleAtFixedRate 因不在有效的进程生命周期内而错过了任务执行,则当应用返回到有效的生命周期时,所有错过的执行会立即执行。

以 Android 16 为目标平台时,当应用返回到有效的生命周期时,系统会立即执行最多 1 次未执行的 scheduleAtFixedRate 执行。此行为变更预计会提升应用性能。在您的应用中测试此行为,检查您的应用是否受到影响。您还可以使用应用兼容性框架并启用 STPE_SKIP_MULTIPLE_MISSED_PERIODIC_TASKS 兼容性标志进行测试。

Formfaktoren von Geräten

Android 16 (API-Level 36) enthält die folgenden Änderungen für Apps, die auf Geräten mit großen Bildschirmen angezeigt werden.

Adaptive Layouts

Da Android-Apps jetzt auf einer Vielzahl von Geräten (z. B. Smartphones, Tablets, faltbare Smartphones, Computer, Autos und Fernseher) und in Fenstermodi auf großen Bildschirmen (z. B. Splitscreen und Desktopfenster) ausgeführt werden, sollten Entwickler Android-Apps entwickeln, die sich unabhängig von der Geräteausrichtung an jede Bildschirm- und Fenstergröße anpassen. Paradigmen wie die Einschränkung der Ausrichtung und Größenänderung sind in der heutigen Welt mit vielen Geräten zu restriktiv.

Einschränkungen für Ausrichtung, Größenänderung und Seitenverhältnis ignorieren

Bei Apps, die auf Android 16 (API-Level 36) ausgerichtet sind, gibt es Änderungen an der Verwaltung von Einschränkungen für Ausrichtung, Größenänderung und Seitenverhältnis. Auf Displays mit einer Mindestbreite von mindestens 600 dp gelten diese Einschränkungen nicht mehr. Apps füllen außerdem unabhängig vom Seitenverhältnis oder der bevorzugten Ausrichtung des Nutzers das gesamte Displayfenster aus. Pillarboxing wird nicht verwendet.

Durch diese Änderung wird ein neues Standardverhalten der Plattform eingeführt. Android strebt ein Modell an, bei dem sich Apps an verschiedene Ausrichtungen, Displaygrößen und Seitenverhältnisse anpassen sollen. Einschränkungen wie eine feste Ausrichtung oder eine eingeschränkte Größe beeinträchtigen die Anpassungsfähigkeit der App. Wir empfehlen Ihnen daher, Ihre App adaptiv zu gestalten, um die bestmögliche Nutzererfahrung zu bieten.

Sie können dieses Verhalten auch mit dem App-Kompatibilitäts-Framework testen und das Flag UNIVERSAL_RESIZABLE_BY_DEFAULT compat aktivieren.

Häufige funktionsgefährdende Änderungen

Wenn Sie die Einschränkungen für Ausrichtung, Größe und Seitenverhältnis ignorieren, kann sich das auf die Benutzeroberfläche Ihrer App auf einigen Geräten auswirken, insbesondere auf Elemente, die für kleine Layouts in Hochformat entwickelt wurden. Dies kann zu Problemen wie gestreckten Layouts und nicht sichtbaren Animationen und Komponenten führen. Annahmen hinsichtlich des Seitenverhältnisses oder der Ausrichtung können zu visuellen Problemen mit Ihrer App führen. Weitere Informationen dazu, wie Sie diese vermeiden und das adaptive Verhalten Ihrer App verbessern können.

Wenn die Gerätedrehung zulässig ist, werden Aktivitäten häufiger neu erstellt. Wenn der Nutzerstatus nicht richtig beibehalten wird, kann das zu einem Verlust des Nutzerstatus führen. Informationen zum korrekten Speichern des UI-Status

Implementierungsdetails

Die folgenden Manifestattribute und Laufzeit-APIs werden auf Geräten mit großem Bildschirm im Vollbild- und im Multifenstermodus ignoriert:

Die folgenden Werte für screenOrientation, setRequestedOrientation() und getRequestedOrientation() werden ignoriert:

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

Auf die Größe des Displays haben android:resizeableActivity="false", android:minAspectRatio und android:maxAspectRatio keine Auswirkungen.

Bei Apps, die auf Android 16 (API-Level 36) ausgerichtet sind, werden die Einschränkungen für App-Ausrichtung, Größe und Seitenverhältnis auf großen Bildschirmen standardmäßig ignoriert. Jede App, die noch nicht vollständig bereit ist, kann dieses Verhalten vorübergehend aufheben, indem sie die Funktion deaktiviert. Dies führt dazu, dass die App in den bisherigen Modus für die Kompatibilität versetzt wird.

Ausnahmen

Die Einschränkungen für Ausrichtung, Größenänderung und Seitenverhältnis unter Android 16 gelten nicht in den folgenden Fällen:

  • Spiele (basierend auf dem Flaggensymbol android:appCategory)
  • Wenn Nutzer das Standardverhalten der App in den Seitenverhältniseinstellungen des Geräts explizit aktivieren
  • Displays, die kleiner als sw600dp sind

Vorübergehend deaktivieren

Wenn Sie eine bestimmte Aktivität deaktivieren möchten, deklarieren Sie die Manifesteigenschaft PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY:

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

Wenn zu viele Teile Ihrer App nicht für Android 16 bereit sind, können Sie die Funktion vollständig deaktivieren, indem Sie dieselbe Property auf Anwendungsebene anwenden:

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

Gesundheit und Fitness

Android 16 (API-Level 36) enthält die folgenden Änderungen im Zusammenhang mit Gesundheits- und Fitnessdaten.

Berechtigungen für Gesundheit und Fitness

Für Apps, die auf Android 16 (API-Level 36) oder höher ausgerichtet sind, werden die BODY_SENSORS-Berechtigungen auf die detaillierten Berechtigungen unter android.permissions.health umgestellt, die auch von Health Connect verwendet werden. Für alle APIs, für die bisher BODY_SENSORS oder BODY_SENSORS_BACKGROUND erforderlich war, ist jetzt die entsprechende android.permissions.health-Berechtigung erforderlich. Dies betrifft die folgenden Datentypen, APIs und Dienste im Vordergrund:

Wenn Ihre App diese APIs verwendet, sollten jetzt die entsprechenden detaillierten Berechtigungen angefordert werden:

Diese Berechtigungen sind dieselben, die den Zugriff auf das Lesen von Daten aus Health Connect schützen, dem Android-Datenspeicher für Gesundheits-, Fitness- und Wellnessdaten.

Mobile Apps

Bei der Migration zu READ_HEART_RATE und anderen detaillierten Berechtigungen müssen Entwickler in mobilen Apps auch eine Aktivität deklarieren, damit die Datenschutzerklärung der App angezeigt wird. Diese Anforderung gilt auch für Health Connect.

Konnektivität

Android 16 (API-Level 36) enthält die folgenden Änderungen am Bluetooth-Stack, um die Verbindung mit Peripheriegeräten zu verbessern.

Neue Intents zum Umgang mit verlorenen Geräten und Verschlüsselungsänderungen

作为改进了对键值对丢失的处理的一部分,Android 16 还引入了 2 个新 intent,以便应用更好地了解键值对丢失和加密更改。

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

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

如果您的应用目前使用自定义机制来处理键盘键失效,请迁移到新的 intent ACTION_KEY_MISSING 以检测和管理键盘键失效事件。我们建议您的应用在发起设备忘记和重新配对之前,引导用户确认远程设备是否在有效范围内。

此外,如果设备在收到 ACTION_KEY_MISSING intent 后断开连接,您的应用应注意重新连接到设备,因为该设备可能已不再与系统绑定。

Sicherheit

Android 16 (API-Level 36) enthält die folgenden Sicherheitsänderungen.

MediaStore-Version gesperrt

Bei Apps, die auf Android 16 oder höher ausgerichtet sind, ist MediaStore#getVersion() jetzt für jede App eindeutig. Dadurch werden identifizierende Eigenschaften aus dem Versionsstring entfernt, um Missbrauch und Verwendung für Fingerprinting-Techniken zu verhindern. Apps dürfen keine Annahmen über das Format dieser Version treffen. Apps sollten Versionsänderungen bereits bei der Verwendung dieser API verarbeiten und in den meisten Fällen sollte ihr aktuelles Verhalten nicht geändert werden müssen, es sei denn, der Entwickler hat versucht, zusätzliche Informationen abzuleiten, die über den beabsichtigten Umfang dieser API hinausgehen.

Datenschutz

Android 16 (API-Level 36) enthält die folgenden Änderungen im Hinblick auf den Datenschutz.

Berechtigung für das lokale Netzwerk

具有 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) 都被归类为本地网络地址。