AndroidX avec Xamarin

  • Article

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 les 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 à partir de androidx. Cela signifie que tous les packages de bibliothèque de support Android sont mappés à un package correspondant androidx.* .
  • androidx les packages sont gérés séparément et mis à jour. Cela signifie que vous pouvez mettre à jour les bibliothèques AndroidX indépendamment les unes des autres.
  • Depuis la version 28 de la bibliothèque de support Android, il n’y aura plus de versions. Tous les développements seront inclus à androidx la place.

AndroidX Logo

Configuration requise

La liste suivante est nécessaire pour utiliser les fonctionnalités AndroidX dans les applications Xamarin :

  • Visual Studio - Sur Windows mise à jour vers Visual Studio 2019 version 16.4 ou ultérieure. Sur macOS, mettez à jour 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 Mobile Development With .NET sur Windows et installé dans le cadre du programme d’installation de Visual Studio pour Mac)
  • Kit de développement Java - Le développement Xamarin.Android 10.0 nécessite JDK 8. La distribution de Microsoft d’OpenJDK est automatiquement installée dans le cadre de Visual Studio.
  • Sdk Android - L’API du Kit de développement logiciel (SDK) Android 28 ou une version ultérieure doit être installée via le Gestionnaire du Kit de développement logiciel (SDK) Android.

Prendre en main

Vous pouvez commencer à utiliser AndroidX en incluant n’importe quel package d’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é que AndroidX est une nouvelle conception de la bibliothèque de support Android, elle 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 les anciens et les nouveaux packages. Vous pouvez voir ci-dessous un exemple de ces modifications :

Vieux 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 le nommage de package, consultez la documentation suivante.

Outils de migration

Il existe trois étapes de migration que vous souhaitez connaître 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 notre outil Migrate vers AndroidX IDE pour prendre en charge la plupart des scénarios d’espace de noms.

Activez AndroidX Migrator via les options > d’outils > Xamarin > Android Paramètres à l’intérieur Visual Studio 2019 (vous pouvez ignorer cette étape sur Visual Studio pour Mac).

Enable AndroidX Migrator

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

Migrate To AndroidX

Notes

Vous devez apporter des modifications manuelles à l’espace de noms pour les scénarios que l’outil ne couvre pas. Bien que nous mapperons le package approprié pour vous, nous vous recommandons de consulter les mappages officiels d’artefacts et les 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 la bibliothèque de support Android vers le package de migration AndroidX.
  2. Si votre application n’inclut aucune dépendance nécessitant une migration d’espace de noms AndroidX, vous pouvez utiliser les bibliothèques AndroidX sur NuGet aujourd’hui.

Résolution des problèmes

  • Certains packages d’architecture dans AndroidX sont 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 référencez 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 inclut des liens vers la documentation de l’API et les rubriques développeur Android pour vous aider à commencer à créer des applications à l’aide d’AndroidX. Il a également mis en évidence les modifications de comportement AndroidX les plus importantes et les rubriques de résolution des problèmes qui pourraient avoir un impact sur les applications existantes.