Mettre à niveau une Xamarin.Forms application vers une application .NET MAUI avec l’Assistant Mise à niveau .NET

  • Article

L’Assistant Mise à niveau .NET vous aide à mettre à niveau Xamarin.Forms des projets vers l’interface utilisateur d’application multiplateforme .NET (.NET MAUI) en convertissant le fichier projet de la solution et en effectuant des mises à jour de code courantes. Plus précisément, l’outil :

  • Convertissez le Xamarin.Forms projet de bibliothèque de classes, le projet Xamarin.iOS et le projet Xamarin.Android en projets de style SDK.
  • Mettez à jour l’infrastructure cible dans les fichiers projet vers net8.0-android et net8.0-ios, si nécessaire.
  • Défini <UseMaui>true</UseMaui> dans les fichiers projet.
  • Ajoutez des propriétés de projet supplémentaires et supprimez les propriétés du projet qui ne sont pas requises.
  • Ajoutez et supprimez des packages NuGet spécifiques :
    • Supprimez les packages NuGet et Xamarin.Essentials les Xamarin.Forms packages NuGet.
    • Remplacez le Xamarin.CommunityToolkit package NuGet par le .NET MAUI Community Toolkit package NuGet.
    • Remplacez Xamarin.Forms les versions compatibles des SkiaSharp packages NuGet par les versions compatibles .NET MAUI, si elles sont utilisées.
  • Supprimez les références à l’espace Xamarin.Essentials de noms et remplacez l’espace Xamarin.Forms de noms par les espaces de noms et Microsoft.Maui.Controls les Microsoft.Maui espaces de noms.

Une fois que vous avez exécuté l’outil, des efforts supplémentaires seront nécessaires pour terminer la migration.

Remarque

L’Assistant Mise à niveau .NET pour .NET MAUI ne prend pas en charge la mise à niveau de projets UWP, de projets d’extension iOS ou de projets de liaison.

Pour plus d’informations sur l’Assistant Mise à niveau .NET, y compris les autres types d’applications qu’il peut convertir, consultez Vue d’ensemble de l’Assistant Mise à niveau .NET.

Bien démarrer

L’Assistant Mise à niveau .NET est disponible en tant qu’extension Visual Studio sur Windows et en tant qu’outil CLI pour Windows et Mac. Pour l’utiliser, votre Xamarin.Forms projet doit utiliser Xamarin.Forms la version 4.8 ou ultérieure. Toutefois, pour une meilleure réussite, nous vous recommandons d’utiliser Xamarin.Forms votre Xamarin.Forms projet 5.0 et .NET Standard 2.0 ou version ultérieure.

Important

L’Assistant Mise à niveau .NET pour .NET MAUI est toujours en cours de développement. Envoyez des commentaires avec une étiquette « area :Maui » pour continuer à améliorer cet outil.

L’Assistant Mise à niveau .NET vous invite à entrer le type de mise à niveau à effectuer :

  • Sur place : cette option met à niveau votre projet sans effectuer de copie.
  • Côte à côte : cette option copie votre projet et met à niveau la copie, en laissant le projet d’origine seul. Actuellement, une mise à niveau côte à côte .NET MAUI nécessite la création de nouveaux projets pour mettre à niveau chaque chef de projet. La tentative de mise à niveau d’un projet dans un projet existant entraîne probablement des erreurs et n’est pas une expérience prise en charge pour l’instant.

Avant de mettre à niveau votre Xamarin.Forms application vers .NET MAUI, vous devez d’abord mettre à jour votre Xamarin.Forms application pour utiliser Xamarin.Forms 5 et vous assurer qu’elle s’exécute toujours correctement. En outre, vous devez mettre à jour les dépendances que votre application utilise vers les dernières versions.

Cela permet de simplifier le reste du processus de migration, car il réduit les différences d’API entre Xamarin.Forms et .NET MAUI et vous garantit que vous utilisez des versions compatibles .NET de vos dépendances s’ils existent.

Actions rapides dans Visual Studio

L’Assistant Mise à niveau .NET a une action rapide pour convertir Xamarin.Forms des espaces de noms en espaces de noms .NET MAUI appropriés, qui s’affiche sous forme d’ampoule :

Screenshot of previewing the application of a light bulb suggestion.

L’action rapide effectue les remplacements nécessaires dans le fichier.

Remarque

Les ampoules d’action rapide s’affichent lorsque vous migrez les fichiers de votre Xamarin.Forms projet vers un projet MAUI .NET.

Installation

Visual Studio 2022 version 17.6.0 ou ultérieure est vivement recommandé pour exécuter l’Assistant mise à niveau. Pour installer l’extension de l’Assistant mise à niveau :

  1. Ouvrez Visual Studio et sélectionnez l’élément de menu Extensions Gérer les extensions>.
  2. Dans la boîte de dialogue Gérer les extensions , recherchez et téléchargez l’Assistant Mise à niveau .NET.
  3. Une fois l’extension téléchargée, fermez Visual Studio. L’extension sera ensuite installée.

Les extensions sont automatiquement mises à jour quand une nouvelle version est disponible sur Visual Studio Marketplace. Pour plus d’informations, consultez Mises à jour automatiques des extensions.

Exécuter l’Assistant mise à niveau

Cliquez avec le bouton droit sur le projet dans Explorateur de solutions, puis sélectionnez Mettre à niveau.

Étapes suivantes

Migration manuelle