Aggiornare un'app Xamarin.Forms a un'app MAUI .NET con .NET Upgrade Assistant

.NET Upgrade Assistant consente di aggiornare Xamarin.Forms i progetti all'interfaccia utente dell'app multipiattaforma .NET (.NET MAUI) convertendo il file di progetto della soluzione e eseguendo aggiornamenti di codice comuni. In particolare, lo strumento:

• Convertire il progetto della libreria di classi, il Xamarin.Forms progetto Xamarin.iOS e il progetto Xamarin.Android in progetti in stile SDK.
• Aggiornare il framework di destinazione nei file di progetto in net8.0-android e net8.0-ios, secondo necessità.
• Impostare <UseMaui>true</UseMaui> nei file di progetto.
• Aggiungere altre proprietà del progetto e rimuovere le proprietà del progetto non necessarie.
• Aggiungere e rimuovere pacchetti NuGet specifici:
  • Rimuovere i Xamarin.Forms pacchetti NuGet e Xamarin.Essentials .
  • Sostituire il Xamarin.CommunityToolkit pacchetto NuGet con il .NET MAUI Community Toolkit pacchetto NuGet.
  • Sostituire le versioni compatibili Xamarin.Forms dei pacchetti NuGet SkiaSharp con versioni compatibili con .NET MAUI, se utilizzate.
• Rimuovere i riferimenti allo spazio dei nomi Xamarin.Essentials e sostituire lo spazio dei nomi Xamarin.Forms con lo spazio dei nomi Microsoft.Maui e lo spazio dei nomi Microsoft.Maui.Controls.

Dopo aver eseguito lo strumento, per completare la migrazione sarà necessario eseguire ulteriori operazioni.

Per altre informazioni su .NET Upgrade Assistant, inclusi gli altri tipi di app che è possibile convertire, vedere Panoramica di .NET Upgrade Assistant.

Inizia subito

.NET Upgrade Assistant è disponibile come estensione di Visual Studio in Windows e come strumento dell'interfaccia della riga di comando per Windows e Mac. Per usarlo, il Xamarin.Forms progetto deve usare Xamarin.Forms la versione 4.8 o successiva. Tuttavia, per ottenere risultati ottimali, consigliamo che il tuo progetto Xamarin.Forms utilizzi Xamarin.Forms 5.0 e .NET Standard 2.0 o versione successiva.

.NET Upgrade Assistant richiederà il tipo di aggiornamento da eseguire:

• In-loco: questa opzione aggiorna il tuo progetto senza creare una copia.
• Side-by-side: questa opzione copia il progetto e aggiorna la copia, lasciando solo il progetto originale. Attualmente, un aggiornamento side-by-side di .NET MAUI richiede la creazione di nuovi progetti per aggiornare ogni head del progetto. Il tentativo di aggiornare la testa di un progetto in un progetto esistente causerà probabilmente errori e non è attualmente supportato.

Prima di aggiornare l'app Xamarin.Forms a .NET MAUI, è necessario aggiornare Xamarin.Forms l'app per usare Xamarin.Forms 5 e assicurarsi che funzioni ancora correttamente. È anche necessario aggiornare le dipendenze usate dall'app alle versioni più recenti.

Ciò consentirà di semplificare il resto del processo di migrazione, in quanto ridurrà al minimo le differenze api tra Xamarin.Forms e .NET MAUI e garantirà l'uso di versioni compatibili con .NET delle dipendenze, se presenti.

Azioni rapide in Visual Studio

.NET Upgrade Assistant offre un'azione rapida per la conversione dei Xamarin.Forms namespace negli appropriati namespace .NET MAUI, che viene visualizzata come lampadina.

L'azione rapida eseguirà le sostituzioni necessarie nel file.

Installazione

dotnet tool install -g upgrade-assistant

dotnet tool update -g upgrade-assistant

dotnet tool install -g --ignore-failed-sources upgrade-assistant

Eseguire l'Assistente d'aggiornamento

upgrade-assistant upgrade

Passaggi successivi