Condividi tramite

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

  • Articolo

.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 e net8.0-ios, in base alle net8.0-android esigenze.
  • 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 Xamarin.Forms le versioni compatibili dei SkiaSharp pacchetti NuGet con le versioni compatibili con .NET MAUI, se usate.
  • Rimuovere i riferimenti allo Xamarin.Essentials spazio dei nomi e sostituire lo Xamarin.Forms spazio dei nomi con gli Microsoft.Maui spazi dei nomi e Microsoft.Maui.Controls .

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

Nota

.NET Upgrade Assistant per .NET MAUI non supporta l'aggiornamento di progetti UWP, progetti di estensione iOS o progetti di associazione.

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

Attività iniziali

.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, è Xamarin.Forms consigliabile usare il progetto Xamarin.Forms 5.0 e .NET Standard 2.0 o versione successiva.

Importante

.NET Upgrade Assistant per .NET MAUI è ancora in fase di sviluppo. Inviare commenti e suggerimenti con un'etichetta "area:Maui" per continuare a migliorare questo strumento.

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

  • Sul posto: questa opzione aggiorna il 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 un progetto in un progetto esistente causerà probabilmente errori e non è attualmente supportata.

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 Xamarin.Forms degli spazi dei nomi negli spazi dei nomi MAUI .NET appropriati, che viene visualizzata come lampadina:

Screenshot of previewing the application of a light bulb suggestion.

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

Nota

Le lampadine di azione rapida verranno visualizzate durante la migrazione dei file dal Xamarin.Forms progetto in un progetto MAUI .NET.

Installazione

È consigliabile usare Visual Studio 2022 versione 17.6.0 o successiva per eseguire l'Assistente aggiornamento. Per installare l'estensione assistente aggiornamento:

  1. Aprire Visual Studio e selezionare la voce di menu Gestione estensioni>.
  2. Nella finestra di dialogo Gestisci estensioni cercare e scaricare .NET Upgrade Assistant.
  3. Dopo aver scaricato l'estensione, chiudere Visual Studio. L'estensione verrà quindi installata.

Le estensioni vengono aggiornate automaticamente quando una nuova versione è disponibile in Visual Studio Marketplace. Per altre informazioni, vedere Aggiornamenti automatici delle estensioni.

Eseguire l'Assistente aggiornamento

Fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e scegliere Aggiorna.

Passaggi successivi

Migrazione manuale