Changements de comportement: applications ciblant le niveau d'API 29 ou supérieur

Android 10 inclut des modifications de comportement du système mises à jour qui peuvent affecter votre application. Les modifications listées sur cette page s'appliquent exclusivement aux applications qui ciblent l'API 29 ou version ultérieure. Si votre application définit targetSdkVersion sur "29" ou une valeur supé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 10.

Remarque  : En plus des modifications listées sur cette page, Android 10 introduit un grand nombre de modifications et de restrictions liées à la confidentialité, y compris les suivantes :

  • Espace de stockage cloisonné
  • Accès au numéro de série de l'appareil USB
  • Possibilité d'activer, de désactiver et de configurer le Wi-Fi
  • Autorisations de localisation pour les API de connectivité

Ces modifications, qui affectent les applications ciblant le niveau d'API 29 ou supérieur, améliorent la confidentialité des utilisateurs. Pour savoir comment prendre en charge ces modifications, consultez la page Modifications concernant la confidentialité.

Mises à jour des restrictions d'interface non SDK

Pour garantir la stabilité et la compatibilité des applications, la plate-forme a commencé à limiter les interfaces non SDK que votre application peut utiliser dans Android 9 (niveau d'API 28). Android 10 inclut des listes à jour d'interfaces non SDK limitées grâce à la collaboration avec les développeurs Android et aux derniers tests internes. Notre objectif est de nous assurer que des alternatives publiques sont disponibles avant de limiter les interfaces non SDK.

Si vous ne ciblez pas Android 10 (niveau d'API 29), certaines de ces modifications ne vous affecteront peut-être pas immédiatement. Cependant, bien que vous puissiez actuellement utiliser certaines interfaces non SDK (en fonction du niveau d'API cible de votre application), l'utilisation d'un champ ou d'une méthode non SDK présente toujours un risque élevé d'endommager votre application.

Si vous n'êtes pas sûr que votre application utilise des interfaces non SDK, vous pouvez tester votre application pour le savoir. Si votre application repose sur des interfaces non SDK, vous devriez commencer à planifier une migration vers des alternatives SDK. Nous comprenons néanmoins que certaines applications ont des cas d'utilisation valides pour utiliser des interfaces non SDK. Si vous ne trouvez pas d'alternative à l'utilisation d'une interface non SDK pour une fonctionnalité de votre application, vous devriez demander une nouvelle API publique.

Pour en savoir plus, consultez Mises à jour des restrictions d'interface non SDK dans Android 10 et Restrictions concernant les interfaces non SDK.

Souvenir partagé

Ashmem a modifié le format des cartes Dalvik dans /proc/<pid>/maps, ce qui affecte les applications qui analysent directement le fichier de cartes. Les développeurs d'applications doivent tester le format /proc/<pid>/maps sur les appareils équipés d'Android 10 ou version ultérieure, et l'analyser en conséquence si l'application dépend des formats de mappage Dalvik.

Les applications ciblant Android 10 ne peuvent pas utiliser directement ashmem (/dev/ashmem). Elles doivent accéder à la mémoire partagée via la classe ASharedMemory du NDK. De plus, les applications ne peuvent pas effectuer d'IOCTL directes vers les descripteurs de fichiers ashmem existants. Elles doivent plutôt utiliser la classe ASharedMemory du NDK ou les API Java Android pour créer des régions de mémoire partagée. Ce changement renforce la sécurité et la robustesse lorsque vous travaillez avec la mémoire partagée, ce qui améliore les performances et la sécurité d'Android dans son ensemble.

Autorisation d'exécution supprimée pour le répertoire de base de l'application

L'exécution de fichiers à partir du répertoire d'accueil de l'application accessible en écriture est un cas de non-respect de la règle W^X. Les applications ne doivent charger que le code binaire intégré au fichier APK d'une application.

Les applications non approuvées qui ciblent Android 10 ne peuvent pas appeler execve() directement sur les fichiers du répertoire d'accueil de l'application.

En outre, les applications qui ciblent Android 10 ne peuvent pas modifier le code exécutable en mémoire des fichiers ouverts avec dlopen() et s'attendre à ce que ces modifications soient écrites sur le disque, car la bibliothèque n'a pas pu être mappée PROT_EXEC via un descripteur de fichier accessible en écriture. Cela inclut tous les fichiers d'objets partagés (.so) associés à des transferts de texte.

Le runtime Android n'accepte que les fichiers OAT générés par le système

L'environnement d'exécution Android (ART) n'appelle plus dex2oat à partir du processus d'application. Cela signifie que l'ART n'acceptera que les fichiers OAT générés par le système.

Appliquer l'exactitude de la compilation anticipée dans ART

Par le passé, la compilation en amont (AOT) effectuée par Android Runtime (ART) pouvait entraîner des plantages d'exécution si l'environnement classpath n'était pas le même au moment de la compilation et de l'exécution. Android 10 et les versions ultérieures exigent toujours que ces contextes d'environnement soient identiques, ce qui entraîne les changements de comportement suivants :

  • Les chargeurs de classe personnalisés (c'est-à-dire les chargeurs de classe écrits par les applications, contrairement aux chargeurs de classe du package dalvik.system) ne sont pas compilés AOT. En effet, ART ne peut pas connaître l'implémentation de la recherche de classe personnalisée au moment de l'exécution.
  • Les fichiers dex secondaires (c'est-à-dire les fichiers dex chargés manuellement par les applications qui ne se trouvent pas dans l'APK principal) sont compilés AOT en arrière-plan. En effet, la compilation lors de la première utilisation peut être trop coûteuse, ce qui entraîne une latence indésirable avant l'exécution. Notez que pour les applications, il est recommandé d'adopter les splits et d'abandonner les fichiers dex secondaires.
  • Les bibliothèques partagées dans Android (entrées <library> et <uses-library> dans un fichier manifeste Android) sont implémentées à l'aide d'une hiérarchie de chargeur de classe différente de celle utilisée dans les versions précédentes de la plate-forme.

Modifications apportées aux autorisations pour les intents en plein écran

Les applications qui ciblent Android 10 ou version ultérieure et qui utilisent des notifications avec des intents plein écran doivent demander l'autorisation USE_FULL_SCREEN_INTENT dans le fichier manifeste de leur application. Il s'agit d'une autorisation normale, de sorte que le système l'accorde automatiquement à l'application à l'origine de la demande.

Si une application ciblant Android 10 ou version ultérieure tente de créer une notification avec une intention plein écran sans demander l'autorisation nécessaire, le système ignore l'intention plein écran et génère le message de journal suivant :

Package your-package-name: Use of fullScreenIntent requires the USE_FULL_SCREEN_INTENT permission

Compatibilité avec les appareils pliables

Android 10 apporte des modifications qui prennent en charge les appareils pliables et à grand écran.

Lorsqu'une application s'exécute sur Android 10, les méthodes onResume() et onPause() fonctionnent différemment. Lorsque plusieurs applications s'affichent en même temps en mode multifenêtre ou multi-écran, toutes les activités supérieures pouvant être sélectionnées dans les piles visibles sont à l'état "reprise", mais une seule d'entre elles, l'activité "reprise la plus haute", est réellement ciblée. Lors de l'exécution sur des versions antérieures à Android 10, une seule activité du système peut être reprise à la fois, toutes les autres activités visibles sont mises en pause.

Ne confondez pas la "mise au point" avec l'activité "la plus réactivée". Le système attribue des priorités aux activités en fonction de l'ordre Z pour accorder une priorité plus élevée aux activités avec lesquelles l'utilisateur a interagi en dernier. Une activité peut être reprise au premier plan, mais ne pas avoir le focus (par exemple, si la barre de notifications est développée).

Dans Android 10 (niveau d'API 29) et versions ultérieures, vous pouvez vous abonner au rappel onTopResumedActivityChanged() pour être averti lorsque votre activité acquiert ou perd la première position réactivée. Il s'agit de l'équivalent de l'état "reprise" avant Android 10. Il peut être utile comme indication si votre application utilise des ressources exclusives ou singleton qui peuvent avoir besoin d'être partagées avec d'autres applications.

Le comportement de l'attribut manifeste resizeableActivity a également changé. Si une application définit resizeableActivity=false dans Android 10 (niveau d'API 29) ou version ultérieure, elle peut être placée en mode de compatibilité lorsque la taille d'écran disponible change ou si l'application passe d'un écran à un autre.

Les applications peuvent utiliser l'attribut android:minAspectRatio, introduit dans Android 10, pour indiquer les formats d'écran compatibles avec votre application.

À partir de la version 3.5, l'outil d'émulateur d'Android Studio inclut des appareils virtuels de 7,3" et 8" pour tester votre code avec des écrans plus grands.

Pour en savoir plus, consultez Concevoir vos applications pour les appareils pliables.