Migrer vos applications vers Android 10

Bienvenue ! Android 10 propose de nombreuses nouvelles API pour créer de nouvelles expériences, ainsi que des comportements système mis à jour qui peuvent affecter votre application lorsqu'elle s'exécute sur des appareils Android 10.

Pour commencer, nous vous recommandons de consulter les modifications de comportement du système, les modifications de confidentialité et 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 Découvrez ensuite les nouvelles fonctionnalités et API d'Android 10. Configurez votre environnement de développement, modifiez le targetSdkVersion de votre application et créez-la avec les nouvelles API pertinentes pour votre application.

Les sections suivantes décrivent ce que vous devez faire à chaque phase. Avant de commencer, assurez-vous d'avoir préparé un appareil matériel ou un émulateur pour exécuter et tester votre application.

Phase 1: Compatibilité de base

L'objectif de cette phase est d'identifier toute régression fonctionnelle ou tout autre impact lorsque votre application s'exécute sur Android 10, puis de les résoudre et de publier une version mise à jour auprès des utilisateurs. Dans de nombreux cas, vous n'avez pas besoin de modifier la targetSdkVersion de votre application ni d'utiliser de nouvelles API, bien que vous puissiez modifier votre compileSdkVersion pour assurer la compatibilité.

Il est important de tester les fonctionnalités de votre application existante dans tous les flux, car certaines modifications de la plate-forme peuvent avoir un impact sur 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 les notes de mise à jour.

Pour que vos utilisateurs puissent passer facilement à Android 10, nous vous recommandons de publier une version compatible de votre application dès que 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 tests que vous effectuez lorsque vous vous préparez à publier votre application. C'est le moment de consulter les consignes fondamentales relatives à la qualité des applications et les bonnes pratiques en matière de test.

Familiarisez-vous avec les modifications de comportement connues qui peuvent affecter votre application. Ces modifications 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 inclut des modifications importantes en termes de confidentialité. Veillez donc à examiner les principales modifications apportées à la confidentialité et à comprendre les conséquences possibles sur votre application.

Phase 2: Compilation 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, puis 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.

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

Obtenir le SDK

Pour obtenir les packages de SDK permettant 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 compiler votre application, puis la tester plus en détail 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 importante sur le comportement de votre application ou provoquer des plantages, même si vous n'utilisez pas encore les nouvelles API.