Changements de comportement: applications ciblant une API de niveau 29 ou supérieur

Android 10 inclut des modifications du comportement du système mises à jour pouvant affecter votre application. Les modifications répertoriées sur cette page ne s'appliquent qu'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 de nombreuses modifications et restrictions liées à la confidentialité. En voici quelques-unes:

  • 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 qui ciblent le niveau d'API 29 ou supérieur, renforcent la confidentialité des utilisateurs. Pour en savoir plus sur la compatibilité de ces modifications, consultez la page Modifications apportées à la confidentialité.

Mises à jour des restrictions des interfaces 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 risquent de ne pas vous affecter immédiatement. Toutefois, bien que vous puissiez actuellement utiliser certaines interfaces non SDK (en fonction du niveau d'API cible de votre application), l'utilisation d'une méthode ou d'un champ non SDK présente toujours un risque élevé d'endommager votre application.

Si vous ne savez pas si 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 devez 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 devez demander une nouvelle API publique.

Pour en savoir plus, consultez Mises à jour des restrictions des interfaces 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 a un impact sur 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 carte 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 diriger les IOCTL vers des descripteurs de fichiers Ashmem existants. Elles doivent plutôt utiliser la classe ASharedMemory du NDK ou les API Android Java pour créer des régions de mémoire partagée. Cette modification améliore la sécurité et la robustesse 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'appli

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é à leur fichier APK.

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.

De plus, les applications qui ciblent Android 10 ne peuvent pas modifier en mémoire le code exécutable 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) avec 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 de l'application. Cette modification signifie qu'ART n'accepte que les fichiers OAT générés par le système.

Appliquer l'exactitude AOT dans ART

Auparavant, la compilation en amont effectuée par l'environnement d'exécution Android Runtime (ART) pouvait entraîner des plantages au moment de l'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 versions ultérieures exigent toujours que ces contextes d'environnement soient identiques, ce qui entraîne les modifications de comportement suivantes:

  • Contrairement aux chargeurs de classe du package dalvik.system, les chargeurs de classes personnalisés, c'est-à-dire des chargeurs de classes écrits par des applications, ne sont pas compilés de façon anticipée. 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 les applications ne figurant pas dans l'APK principal, sont compilés de manière anticipée en arrière-plan. En effet, la compilation à 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 des divisions et de s'éloigner des 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 chargeur 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 le fichier manifeste de leur application. Il s'agit d'une autorisation normale. Le système l'accorde donc automatiquement à l'application à l'origine de la demande.

Si une application qui cible Android 10 ou une 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 appareils pliables

Des modifications ont été apportées à Android 10 pour les appareils pliables et à grand écran.

Lorsqu'une application s'exécute sous Android 10, les méthodes onResume() et onPause() fonctionnent différemment. Lorsque plusieurs applications apparaissent en même temps en mode multifenêtre ou multi-écran, toutes les activités principales sélectionnables dans les piles visibles sont réactivées, mais seule l'une d'entre elles, l'activité la plus réactivée, est ciblée. Sur les versions antérieures à Android 10, une seule activité du système peut être réactivée à la fois. Toutes les autres activités visibles sont suspendues.

Ne confondez pas le concept de "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 de plan pour donner une priorité plus élevée aux activités avec lesquelles l'utilisateur a interagi en dernier. Une activité peut être réactivée, mais pas être ciblée (par exemple, si le volet des notifications est développé).

Dans 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 position la plus réactivée. Il s'agit de l'équivalent de l'état de reprise avant Android 10. Il peut vous servir d'indice si votre application utilise des ressources exclusives ou singleton qui devront peut-être être partagées avec d'autres applications.

Le comportement de l'attribut manifeste resizeableActivity a également changé. Si une application définit resizeableActivity=false sous Android version 10 (niveau 29 d'API) ou ultérieure, elle peut être mise 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 ratios 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 pouces pour tester votre code sur des écrans plus grands.

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