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

Android 10 inclut des modifications du comportement du système qui peuvent affecter votre application. Les modifications listées sur cette page s'appliquent exclusivement aux applications qui ciblent l'API 29 ou une 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 d'accéder à la position 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 en savoir plus sur la prise en charge de ces modifications, consultez la page Modifications de la confidentialité.

Mises à jour des restrictions des interfaces hors 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.

Mémoire partagée

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) et doivent accéder à la mémoire partagée via la classe ASharedMemory du NDK. De plus, les applications ne peuvent pas effectuer d'IOCTL directs vers des descripteurs de fichiers ashmem existants. Elles doivent 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 lors de l'utilisation de la mémoire partagée, ce qui améliore les performances et la sécurité d'Android dans son ensemble.

Suppression de l'autorisation d'exécution pour le répertoire d'accueil 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 ne peut pas avoir été 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.

L'environnement d'exécution 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 qu'ART n'acceptera que les fichiers OAT générés par le système.

Appliquer l'exactitude de l'AOT dans ART

Auparavant, la compilation en amont (AOT) effectuée par l'environnement d'exécution Android (ART) pouvait provoquer des plantages de l'environnement d'exécution si l'environnement de classpath n'était pas le même au moment de la compilation et de l'exécution. Android 10 et 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 en AOT. En effet, ART ne peut pas connaître l'implémentation de 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 des applications qui ne se trouvent pas dans l'APK principal) sont compilés en 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 divisions et d'abandonner les fichiers DEX secondaires.
  • Les bibliothèques partagées dans Android (les entrées <library> et <uses-library> dans un fichier manifeste Android) sont implémentées à l'aide d'une hiérarchie de chargeurs de classe différente de celle utilisée dans les versions précédentes de la plate-forme.

Modifications des autorisations pour les intents plein écran

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

Si une application ciblant Android 10 ou version ultérieure tente de créer une notification avec un intent plein écran sans demander l'autorisation nécessaire, le système ignore l'intent 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 pliables

Android 10 inclut des modifications qui permettent de prendre en charge les appareils pliables et les grands écrans.

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 principales sélectionnables dans les piles visibles sont à l'état "reprise", mais une seule d'entre elles, l'activité "reprise la plus élevée", est réellement sélectionnée. Sur les 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 "focus" et "activité la plus réactivée". Le système attribue des priorités aux activités en fonction de l'ordre Z afin de donner une priorité plus élevée aux activités avec lesquelles l'utilisateur a interagi en dernier. Une activité peut être reprise en premier plan, mais ne pas être active (par exemple, si le volet de notification est développé).

Sur Android 10 (niveau d'API 29) ou version ultérieure, 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. Cela peut être utile si votre application utilise des ressources exclusives ou uniques qui doivent être partagées avec d'autres applications.

Le comportement de l'attribut de fichier manifeste resizeableActivity a également changé. Si une application définit resizeableActivity=false sous 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 proportions d'écran qu'elles prennent en charge.

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

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