Changements de comportement: applications ciblant Android 16 ou version ultérieure

Comme les versions précédentes, Android 16 apporte des modifications de comportement pouvant affecter votre application. Les modifications de comportement suivantes s'appliquent exclusivement aux applications qui ciblent Android 16 ou version ultérieure. Si votre application cible Android 16 ou une version ultérieure, vous devez la modifier pour qu'elle prenne en charge ces comportements, le cas échéant.

Veillez également à consulter la liste des modifications de comportement qui affectent toutes les applications exécutées sur Android 16, quelle que soit la targetSdkVersion de votre application.

Expérience utilisateur et interface utilisateur du système

Android 16 (niveau d'API 36) inclut les modifications suivantes, qui visent à créer une expérience utilisateur plus cohérente et intuitive.

Fin de la possibilité de désactiver l'affichage bord à bord

Android 15 enforced edge-to-edge for apps targeting Android 15 (API level 35), but your app could opt-out by setting R.attr#windowOptOutEdgeToEdgeEnforcement to true. For apps targeting Android 16 (API level 36), R.attr#windowOptOutEdgeToEdgeEnforcement is deprecated and disabled, and your app can't opt-out of going edge-to-edge.

  • If your app targets Android 16 (API level 36) and is running on an Android 15 device, R.attr#windowOptOutEdgeToEdgeEnforcement continues to work.
  • If your app targets Android 16 (API level 36) and is running on an Android 16 device, R.attr#windowOptOutEdgeToEdgeEnforcement is disabled.

For testing in Android 16 Beta 3, ensure your app supports edge-to-edge and remove any use of R.attr#windowOptOutEdgeToEdgeEnforcement so that your app also supports edge-to-edge on an Android 15 device. To support edge-to-edge, see the Compose and Views guidance.

Migration ou désactivation requise pour la prévisualisation du Retour

Pour les applications ciblant Android 16 (niveau d'API 36) ou version ultérieure et exécutées sur un appareil Android 16 ou version ultérieure, les animations système de prévisualisation du Retour sont activées par défaut (retour à l'écran d'accueil, multi-tâche et multi-activité). De plus, onBackPressed n'est pas appelé et KeyEvent.KEYCODE_BACK n'est plus distribué.

Si votre application intercepte l'événement "Retour" et que vous n'avez pas encore migré vers la prévisualisation du Retour, mettez à jour votre application pour qu'elle utilise les API de navigation "Retour" compatibles ou désactivez temporairement cette fonctionnalité en définissant l'attribut android:enableOnBackInvokedCallback sur false dans la balise <application> ou <activity> du fichier AndroidManifest.xml de votre application.

Animation pour la prévisualisation du Retour à l'écran d'accueil.
Animation multi-activité prédictive.
Animation prédictive inter-tâches.

API de polices élégantes obsolètes et désactivées

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.

Fonctionnalité de base

Android 16 (niveau d'API 36) inclut les modifications suivantes qui modifient ou étendent diverses fonctionnalités de base du système Android.

Optimisation de la planification des tâches à tarif fixe

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.

Facteurs de forme des appareils

Android 16 (niveau d'API 36) inclut les modifications suivantes pour les applications lorsqu'elles sont affichées sur des appareils à grand écran.

Mises en page adaptatives

With Android apps now running on a variety of devices (such as phones, tablets, foldables, desktops, cars, and TVs) and windowing modes on large screens (such as split screen and desktop windowing), developers should build Android apps that adapt to any screen and window size, regardless of device orientation. Paradigms like restricting orientation and resizability are too restrictive in today's multidevice world.

Ignore orientation, resizability, and aspect ratio restrictions

For apps targeting Android 16 (API level 36), Android 16 includes changes to how the system manages orientation, resizability, and aspect ratio restrictions. On displays with smallest width >= 600dp, the restrictions no longer apply. Apps also fill the entire display window, regardless of aspect ratio or a user's preferred orientation, and pillarboxing isn't used.

This change introduces a new standard platform behavior. Android is moving toward a model where apps are expected to adapt to various orientations, display sizes, and aspect ratios. Restrictions like fixed orientation or limited resizability hinder app adaptability, so we recommend making your app adaptive to deliver the best possible user experience.

You can also test this behavior by using the app compatibility framework and enabling the UNIVERSAL_RESIZABLE_BY_DEFAULT compat flag.

Common breaking changes

Ignoring orientation, resizability, and aspect ratio restrictions might impact your app's UI on some devices, especially elements that were designed for small layouts locked in portrait orientation: for example, issues like stretched layouts and off-screen animations and components. Any assumptions about aspect ratio or orientation can cause visual issues with your app. Learn more about how to avoid them and improve your app's adaptive behaviour.

Allowing device rotation results in more activity re-creation, which can result in losing user state if not properly preserved. Learn how to correctly save UI state in Save UI states.

Implementation details

The following manifest attributes and runtime APIs are ignored across large screen devices in full-screen and multi-window modes:

The following values for screenOrientation, setRequestedOrientation(), and getRequestedOrientation() are ignored:

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

Regarding display resizability, android:resizeableActivity="false", android:minAspectRatio, and android:maxAspectRatio have no effect.

For apps targeting Android 16 (API level 36), app orientation, resizability, and aspect ratio constraints are ignored on large screens by default, but every app that isn't fully ready can temporarily override this behavior by opting out (which results in the previous behavior of being placed in compatibility mode).

Exceptions

The Android 16 orientation, resizability, and aspect ratio restrictions don't apply in the following situations:

  • Games (based on the android:appCategory flag)
  • Users explicitly opting in to the app's default behavior in aspect ratio settings of the device
  • Screens that are smaller than sw600dp

Opt out temporarily

To opt out a specific activity, declare the PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY manifest property:

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

If too many parts of your app aren't ready for Android 16, you can opt out completely by applying the same property at the application level:

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

Santé et remise en forme

Android 16 (niveau d'API 36) inclut les modifications suivantes concernant les données de santé et de remise en forme.

Autorisations de santé et remise en forme

Pour les applications ciblant Android 16 (niveau d'API 36) ou version ultérieure, les autorisations BODY_SENSORS sont remplacées par des autorisations précises sous android.permissions.health, qui sont également utilisées par Santé Connect. Toute API qui nécessitait auparavant BODY_SENSORS ou BODY_SENSORS_BACKGROUND requiert désormais l'autorisation android.permissions.health correspondante. Cela affecte les types de données, les API et les types de services de premier plan suivants:

Si votre application utilise ces API, elle doit désormais demander les autorisations précises correspondantes:

Ces autorisations sont les mêmes que celles qui protègent l'accès à la lecture des données de Santé Connect, le datastore Android pour les données de santé, de remise en forme et de bien-être.

Dans les applications mobiles

Les applications mobiles qui migrent vers l'utilisation de READ_HEART_RATE et d'autres autorisations précises doivent également déclarer une activité pour afficher les règles de confidentialité de l'application. Il s'agit de la même exigence que pour Santé Connect.

Connectivité

Android 16 (niveau d'API 36) inclut les modifications suivantes dans la pile Bluetooth pour améliorer la connectivité avec les périphériques.

Nouveaux intents pour gérer la perte de liaison et les modifications de chiffrement

Dans le cadre de la gestion améliorée de la perte de liaison, Android 16 introduit également deux nouveaux intents pour mieux informer les applications de la perte de liaison et des modifications de chiffrement.

Les applications ciblant Android 16 peuvent désormais:

  • Recevoir un intent ACTION_KEY_MISSING lorsqu'une perte de liaison à distance est détectée, ce qui leur permet de fournir des commentaires plus informatifs sur l'utilisateur et de prendre les mesures appropriées.
  • Recevoir un intent ACTION_ENCRYPTION_CHANGE chaque fois que l'état du chiffrement du lien change. Cela inclut la modification de l'état du chiffrement, de l'algorithme de chiffrement et de la taille de la clé de chiffrement. Les applications doivent considérer que l'association est rétablie si le lien est correctement chiffré lors de la réception de l'intent ACTION_ENCRYPTION_CHANGE ultérieurement.

Si votre application utilise actuellement des mécanismes personnalisés pour la gestion des pertes de liaison, migrez vers le nouvel intent ACTION_KEY_MISSING pour détecter et gérer les événements de perte de liaison. Nous vous recommandons de demander à l'utilisateur de vérifier que l'appareil distant est à portée avant de lancer l'oubli de l'appareil et le nouvel appariement.

De plus, si un appareil se déconnecte après la réception de l'intent ACTION_KEY_MISSING, votre application doit être attentive à se reconnecter à l'appareil, car il est possible qu'il ne soit plus associé au système.

Sécurité

Android 16 (niveau d'API 36) inclut les modifications de sécurité suivantes.

Verrouillage de la version MediaStore

Pour les applications ciblant Android 16 ou version ultérieure, MediaStore#getVersion() sera désormais unique pour chaque application. Cela élimine les propriétés d'identification de la chaîne de version pour éviter les utilisations abusives et l'utilisation de techniques d'empreinte digitale. Les applications ne doivent pas faire d'hypothèses sur le format de cette version. Les applications doivent déjà gérer les modifications de version lorsqu'elles utilisent cette API et, dans la plupart des cas, elles ne doivent pas avoir besoin de modifier leur comportement actuel, sauf si le développeur a tenté d'inférer des informations supplémentaires qui dépassent le champ d'application prévu de cette API.

Confidentialité

Android 16 (niveau d'API 36) inclut les modifications de confidentialité suivantes.

Autorisation d'accès au réseau local

Les appareils du LAN peuvent être accessibles par n'importe quelle application disposant de l'autorisation INTERNET. Cela permet aux applications de se connecter facilement aux appareils locaux, mais cela a également des implications en termes de confidentialité, telles que la création d'une empreinte de l'utilisateur et le fait d'être un proxy pour la position.

Le projet Local Network Protections vise à protéger la confidentialité de l'utilisateur en limitant l'accès au réseau local derrière une nouvelle autorisation d'exécution.

Plan de publication

Cette modification sera déployée entre deux versions, 25Q2 et TBD respectivement. Il est impératif que les développeurs suivent ces consignes pour 25Q2 et partagent leurs commentaires, car ces protections seront appliquées dans une version ultérieure d'Android. De plus, ils devront mettre à jour les scénarios qui dépendent de l'accès réseau local implicite en suivant les conseils ci-dessous et se préparer au refus de l'utilisateur et à la révocation de la nouvelle autorisation.

Impact

Pour le moment, la fonctionnalité LNP est disponible sur inscription, ce qui signifie que seules les applications qui l'activent seront concernées. L'objectif de la phase d'activation est que les développeurs d'applications comprennent quelles parties de leur application dépendent de l'accès au réseau local implicite afin de pouvoir les protéger par autorisation pour la prochaine version.

Les applications seront affectées si elles accèdent au réseau local de l'utilisateur à l'aide des éléments suivants:

  • Utilisation directe ou par bibliothèque de sockets bruts sur des adresses réseau locales (par exemple, protocole de détection de services mDNS ou SSDP)
  • Utilisation de classes au niveau du framework qui accèdent au réseau local (par exemple, NsdManager)

Le trafic vers et à partir d'une adresse réseau locale nécessite une autorisation d'accès au réseau local. Le tableau suivant présente quelques cas courants:

Opérations réseau de bas niveau de l'application Autorisation de réseau local requise
Établir une connexion TCP sortante oui
Accepter les connexions TCP entrantes oui
Envoyer une diffusion UDP, une diffusion unicast ou une diffusion multicast oui
Recevoir une diffusion, une multidiffusion ou un unicast UDP entrant oui

Ces restrictions sont implémentées profondément dans la pile réseau et s'appliquent donc à toutes les API réseau. Cela inclut les sockets créés en code natif ou géré, les bibliothèques réseau telles que Cronet et OkHttp, ainsi que les API implémentées en plus. Essayer de résoudre des services sur le réseau local (c'est-à-dire ceux avec un suffixe .local) nécessite une autorisation de réseau local.

Exceptions aux règles ci-dessus:

  • Si le serveur DNS d'un appareil se trouve sur un réseau local, le trafic vers ou depuis celui-ci (sur le port 53) ne nécessite pas d'autorisation d'accès au réseau local.
  • Les applications qui utilisent le sélecteur de sortie comme sélecteur intégré à l'application n'auront pas besoin d'autorisations de réseau local (plus d'informations à venir au 4e trimestre 2025).

Conseils aux développeurs (activation)

Pour activer les restrictions de réseau local, procédez comme suit:

  1. Flashez l'appareil avec une version 25Q2 bêta 3 ou ultérieure.
  2. Installez l'application à tester.
  3. Activez/désactivez l'indicateur Appcompat dans adb:

    adb shell am compat enable RESTRICT_LOCAL_NETWORK <package_name>
    
  4. Redémarrez l'appareil.

L'accès de votre application au réseau local est désormais limité, et toute tentative d'accès au réseau local entraînera des erreurs de socket. Si vous utilisez des API qui effectuent des opérations réseau locales en dehors de votre processus d'application (par exemple, NsdManager), elles ne seront pas affectées pendant la phase d'activation.

Pour restaurer l'accès, vous devez accorder à votre application l'autorisation NEARBY_WIFI_DEVICES.

  1. Assurez-vous que l'application déclare l'autorisation NEARBY_WIFI_DEVICES dans son fichier manifeste.
  2. Accédez à Settings > Apps > [Application Name] > Permissions > Nearby devices > Allow (Paramètres > Applications > [Nom de l'application] > Autorisations > Appareils à proximité > Autoriser).

L'accès de votre application au réseau local devrait maintenant être rétabli, et tous vos scénarios devraient fonctionner comme avant l'activation de l'application.

Une fois l'application de la protection du réseau local lancée, voici comment le trafic réseau de l'application sera affecté.

Autorisation Requête LAN sortante Requête Internet sortante/entrante Requête LAN entrante
Accordé Works Works Works
Refusé Gags Works Gags

Utilisez la commande suivante pour désactiver l'indicateur App-Compat

adb shell am compat disable RESTRICT_LOCAL_NETWORK <package_name>

Erreurs

Les erreurs découlant de ces restrictions sont renvoyées au socket appelant chaque fois qu'il appelle send ou une variante d'envoi vers une adresse réseau locale.

Exemples d'erreurs:

sendto failed: EPERM (Operation not permitted)

sendto failed: ECONNABORTED (Operation not permitted)

Définition du réseau local

Dans ce projet, un réseau local désigne un réseau IP qui utilise une interface réseau compatible avec la diffusion, telle que le Wi-Fi ou l'Ethernet, mais qui exclut les connexions mobiles (WWAN) ou VPN.

Les réseaux suivants sont considérés comme des réseaux locaux:

IPv4 :

  • 169.254.0.0/16 // Liaison locale
  • 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 :

  • Lien local
  • Routes directement connectées
  • Réseaux stub tels que Thread
  • Plusieurs sous-réseaux (à définir)

De plus, les adresses multicast (224.0.0.0/4, ff00::/8) et l'adresse de diffusion IPv4 (255.255.255.255) sont classées comme adresses de réseau local.