Migrer vos applications vers Android 10

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

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

  1. Assurez 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 fonctionnant sous Android 10. Testez votre application pour vérifier qu'elle fonctionne entièrement, puis publiez la version compatible de l'application pour les utilisateurs.
  2. Profitez des fonctionnalités et des API d'Android 10. Ensuite, découvrez les nouvelles fonctionnalités et API d'Android 10. Configurez votre environnement de développement, modifiez le targetSdkVersion de votre application et compilez l'application avec les nouvelles API pertinentes.

Les sections suivantes décrivent ce que vous devrez faire dans chacune de ces phases. 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é basique

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 corriger 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, bien que vous puissiez éventuellement modifier votre compileSdkVersion pour assurer la compatibilité.

Il est important de tester les fonctionnalités de votre application existante sur 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'en informer les utilisateurs de la compatibilité avec Android 10 dans vos notes de mise à jour.

Pour faciliter la transition vers Android 10 pour vos utilisateurs, 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 bon moment pour consulter les consignes fondamentales relatives à la qualité des applications et les bonnes pratiques en matière de test.

Veillez à vous familiariser 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 à résoudre les problèmes plus rapidement.

Android 10 apporte des modifications importantes concernant la confidentialité. Assurez-vous donc d'examiner également les principales modifications apportées à la confidentialité et de comprendre leurs impacts potentiels sur votre application.

Phase 2: Compiler avec Android 10

Dès que vous serez prêt, vous pourrez 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. Par conséquent, veillez à 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 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 pour vous assurer qu'elle fonctionne correctement lorsque vous ciblez Android 10. C'est aussi le 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 le targetSdkVersion défini sur 29, des modifications spécifiques de la plate-forme doivent être prises en compte. Certaines de ces modifications, décrites sur la page Modifications de comportement d'Android 10, peuvent avoir un impact significatif sur le comportement de votre application ou provoquer des plantages, même si vous n'utilisez pas encore de nouvelles API.