Partager via


AndroidX avec Xamarin

Comment commencer à développer des applications avec AndroidX à l’aide de Xamarin.Android.

AndroidX est une amélioration majeure de la bibliothèque de support Android d’origine, qui n’est plus conservée. Les packages AndroidX remplacent entièrement la bibliothèque de support Android en fournissant la parité des fonctionnalités et de nouvelles bibliothèques que vous pouvez utiliser dans vos applications Android.

AndroidX inclut les fonctionnalités suivantes :

  • Tous les packages à l’intérieur d’AndroidX ont désormais un espace de noms cohérent commençant par androidx. Cela signifie que tous les packages de la bibliothèque de support Android sont mappés à un package correspondant androidx.* .
  • androidx les packages sont gérés et mis à jour séparément. Cela signifie que vous pouvez mettre à jour les bibliothèques AndroidX indépendamment les unes des autres.
  • À compter de la version 28 de la bibliothèque de support Android, il n’y aura plus de versions. Tous les développements seront inclus dans androidx à la place.

AndroidX Logo

Spécifications

La liste suivante est requise pour utiliser les fonctionnalités AndroidX dans les applications basées sur Xamarin :

  • Visual Studio : sur Windows update vers Visual Studio 2019 version 16.4 ou ultérieure. Sur macOS, mettez à jour vers Visual Studio 2019 pour Mac version 8.4 ou ultérieure.
  • Xamarin.Android : Xamarin.Android 10.0 ou version ultérieure doit être installé avec Visual Studio (Xamarin.Android est automatiquement installé dans le cadre de la charge de travail Développement mobile avec .NET sur Windows et installé dans le cadre du programme d’installation Visual Studio pour Mac)
  • Kit de développement Java : le développement Xamarin.Android 10.0 nécessite le JDK 8. La distribution d’OpenJDK par Microsoft est automatiquement installée dans le cadre de Visual Studio.
  • Sdk Android : l’API android SDK 28 ou ultérieure doit être installée via le Gestionnaire du SDK Android.

Bien démarrer

Vous pouvez commencer à utiliser AndroidX en incluant n’importe quel package NuGet AndroidX à l’intérieur de votre projet Android. En savoir plus sur l’installation et l’utilisation d’un package dans Visual Studio ou Visual Studio pour Mac

Changements de comportement

Étant donné qu’AndroidX est une refonte de la bibliothèque de support Android, il inclut des étapes de migration qui affecteront les applications Android créées avec la bibliothèque de support Android.

Modification du nom du package

Les noms des packages ont été modifiés entre l’ancien et le nouveau. Vous pouvez voir ci-dessous un exemple de ces modifications :

Ancien Nouveau
android.support.** androidx. @
android.design.** com.google.android.material. @
android.support.test.** androidx.test. @
android.arch.** androidx. @
android.arch.persistence.room.** androidx.room. @
android.arch.persistence.** androidx.sqlite. @

Pour plus d’informations sur l’affectation de noms de package, consultez la documentation suivante.

Outils de migration

Vous devez connaître trois étapes de migration pour votre application.

  1. Si votre application inclut des espaces de noms de bibliothèque de support Android et que vous souhaitez les migrer vers des espaces de noms AndroidX, vous pouvez utiliser nos outils de migration vers l’IDE AndroidX pour prendre en charge la plupart des scénarios d’espace de noms.

Activez androidX Migrator via les options Outils >> Paramètres Android Xamarin > dans Visual Studio 2019 (vous pouvez ignorer cette étape sur Visual Studio pour Mac).

Activer AndroidX Migrator

Cliquez avec le bouton droit sur votre projet et migrez vers AndroidX.

Migrer vers AndroidX

Notes

Vous devez apporter des modifications manuelles à l’espace de noms pour les scénarios que l’outil ne couvre pas. Nous allons mapper le package approprié pour vous, mais nous vous encourageons à jeter un coup d’œil aux mappages d’artefacts officiels et aux mappages de classes pour faciliter la migration de votre projet.

  1. Si votre application inclut des dépendances qui n’ont pas été migrées vers l’espace de noms AndroidX, vous devez utiliser le package de migration de la bibliothèque de support Android vers AndroidX.
  2. Si votre application n’inclut pas de dépendances qui nécessitent une migration d’espace de noms AndroidX, vous pouvez utiliser les bibliothèques AndroidX sur NuGet dès aujourd’hui.

Dépannage

  • Certains packages d’architecture dans AndroidX entreront en conflit avec les versions de la bibliothèque de support. Pour résoudre ce problème, vous devez utiliser la version AndroidX de ces packages et supprimer la version de la bibliothèque de support. Par exemple, si vous faites référence Xamarin.Android.Arch.Work.Runtime dans votre projet, il est en conflit avec les types du package nouvellement ajouté AndroidX.Work .

Résumé

Cet article a présenté AndroidX et expliqué comment installer et configurer les derniers outils et packages pour le développement Xamarin.Android avec AndroidX. Il a fourni une vue d’ensemble de ce qu’est AndroidX. Il comprenait des liens vers la documentation de l’API et des rubriques développeur Android pour vous aider à commencer à créer des applications à l’aide d’AndroidX. Il a également mis en évidence les changements de comportement androidX et les rubriques de résolution des problèmes les plus importants susceptibles d’avoir un impact sur les applications existantes.