Migrer vos applications vers Android 10

Bienvenue ! Android 10 dispose de nombreuses nouvelles API permettant de créer de nouvelles expériences, ainsi que de nouveaux comportements système susceptibles d'affecter votre application lorsqu'elle s'exécute sur des appareils Android 10.

Pour commencer, nous vous recommandons d'examiner les modifications de comportement du système, les modifications apportées à la confidentialité, ainsi que les nouvelles fonctionnalités et API, puis de migrer vos applications en deux phases:

  1. Assurer la compatibilité de base. Dès que possible, assurez-vous que votre application publiée existante est prête pour les utilisateurs qui mettent à jour ou achètent de nouveaux appareils équipés d'Android 10. Testez votre application pour vérifier qu'elle est entièrement fonctionnelle, puis publiez la version compatible de l'application auprès des utilisateurs.
  2. Compiler avec les fonctionnalités et les API d'Android 10 Ensuite, explorez les nouvelles fonctionnalités et API d'Android 10. Configurez votre environnement de développement, modifiez le targetSdkVersion de votre application et compilez-le avec les nouvelles API pertinentes pour votre application.

Les sections suivantes décrivent ce que vous devrez faire à chacune de ces phases. Avant de commencer, assurez-vous d'avoir préparé un appareil matériel ou un émulateur) à exécuter et à tester votre application.

Phase 1: Compatibilité de base

L'objectif de cette phase est d'identifier les régressions de fonctionnalités ou d'autres impacts lorsque votre application s'exécute sur Android 10, puis de les traiter et de publier une version mise à jour auprès des utilisateurs. Dans de nombreux cas, vous n'avez pas besoin de modifier le targetSdkVersion de votre application ni d'utiliser de nouvelles API. Toutefois, vous pouvez éventuellement modifier votre compileSdkVersion pour prendre en charge la compatibilité.

Il est important de tester le fonctionnement de votre application existante dans tous les flux, car certaines modifications de la plate-forme peuvent affecter le comportement de votre application. Lorsque vous publiez la version compatible de votre application, nous vous recommandons d'informer les utilisateurs de la prise en charge d'Android 10 dans vos notes de mise à jour.

Pour faciliter la transition vers Android 10, nous vous recommandons de publier une version compatible de votre application le plus tôt possible, idéalement avant que les appareils ne commencent à recevoir les mises à jour d'Android 10.

Effectuer des tests

Les tests de compatibilité impliquent le même type de test que celui que vous effectuez lorsque vous préparez la publication de votre application. C'est le moment de consulter les consignes fondamentales relatives à la qualité des applications et les bonnes pratiques de test.

Veillez à vous familiariser avec les changements de comportement connus qui peuvent affecter votre application. Ces changements de comportement s'appliqueront à votre application, même si vous n'avez pas modifié votre targetSdkVersion. L'examen des modifications à l'avance vous aidera à identifier les zones d'impact possibles et à déboguer les problèmes plus rapidement.

Android 10 apporte des modifications importantes concernant la confidentialité. Veillez donc à examiner les principaux changements concernant la confidentialité et à comprendre les conséquences possibles sur votre application.

Phase 2: Compiler avec Android 10

Lorsque vous le souhaitez, vous pouvez explorer les nouvelles fonctionnalités et API d'Android 10, et améliorer votre application avec de nouvelles expériences. Pour commencer à développer avec les nouvelles API, vous devez configurer le SDK Android 10 (API 29) dans Android Studio, et remplacer targetSdkVersion et compileSdkVersion par 29.

Lorsque vous modifiez votre targetSdkVersion, vous devez également tenir compte des modifications de comportement du système qui s'appliquent à votre application lorsque vous ciblez Android 10 (API 29) ou une version ultérieure.

Certains changements de comportement peuvent entraîner des régressions ou des plantages. Veillez donc à examiner les modifications et à effectuer des tests approfondis avant de publier une mise à jour d'application qui modifie votre targetSdkVersion.

Obtenir le SDK

Pour obtenir les packages SDK afin de compiler votre application avec Android 10, assurez-vous d'abord d'utiliser la dernière version d'Android Studio. Pour en savoir plus, consultez Configurer le SDK.

Effectuer des tests

Une fois les préparations décrites précédemment terminées, vous pouvez créer votre application, puis la tester plus avant pour vous assurer qu'elle fonctionne correctement lorsque vous ciblez Android 10. C'est un autre bon moment pour consulter les consignes fondamentales relatives à la qualité des applications et les bonnes pratiques en matière de test.

Lorsque vous compilez votre application avec targetSdkVersion défini sur 29, vous devez prendre connaissance de certaines modifications spécifiques à la plate-forme. Certaines de ces modifications, décrites sur la page Modifications de comportement d'Android 10, peuvent avoir une incidence significative sur le comportement de votre application ou entraîner des plantages, même si vous n'utilisez pas encore de nouvelles API.