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 du comportement du système, modifications concernant la confidentialité, ainsi que les nouvelles fonctionnalités et API, puis de migrer vos applications en deux phases :

  1. Assurez-vous d'une 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 exécutant Android 10. Testez votre application pour vérifier qu'elle est entièrement fonctionnelle, puis publiez la version compatible de l'application pour les utilisateurs.
  2. Créez des applications avec les fonctionnalités et les API Android 10. Ensuite, découvrez les nouvelles fonctionnalités et API d'Android 10. Configurez votre environnement de développement, modifiez le de votre application targetSdkVersion, et créez des applications avec les nouvelles API qui sont pertinentes pour votre application.

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

Phase 1 : Compatibilité de base

L'objectif de cette phase est d'identifier toute régression de fonctionnalité ou tout autre impact lorsque votre application s'exécute sur Android 10, puis de résoudre ces problèmes et de publier une version mise à jour pour les utilisateurs. Dans de nombreux cas, vous n'aurez 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 la fonctionnalité 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 vos 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 ceux 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.

Assurez-vous de 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. Si vous examinez les modifications à l'avance, vous pourrez identifier les zones d'impact possibles et déboguer les problèmes plus rapidement.

Android 10 inclut de nombreuses modifications concernant la confidentialité. Assurez-vous donc également de consulter les principales modifications concernant la confidentialité et de comprendre les impacts possibles sur votre application.

Phase 2 : Créer des applications avec Android 10

Lorsque vous êtes prêt, vous pouvez découvrir 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 modifier votre targetSdkVersion et votre compileSdkVersion en 29.

Lorsque vous modifiez votre targetSdkVersion, vous devez également tenir compte des modifications du 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. Assurez-vous donc de consulter les modifications et de les tester de manière approfondie avant de publier une mise à jour de l'application qui modifie votre targetSdkVersion.

Obtenir le SDK

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

Effectuer des tests

Une fois les préparatifs décrits précédemment terminés, vous pouvez créer votre application et la tester davantage pour vous assurer qu'elle fonctionne correctement lorsque vous ciblez Android 10. C'est également le moment de consulter les consignes fondamentales relatives à la qualité des applications et les bonnes pratiques en matière de test.

Lorsque vous créez votre application avec le targetSdkVersion défini sur 29, vous devez connaître certaines modifications spécifiques de la plate-forme. Certaines de ces modifications, qui sont décrites sur la page Modifications de comportement d'Android 10, peuvent avoir un impact significatif sur le comportement de votre application ou entraîner des plantages, même si vous n'utilisez pas encore de nouvelles API.