Eseguire la migrazione da UWP a Windows App SDK

Se si è soddisfatti delle funzionalità attuali della piattaforma UWP (Universal Windows Platform), non è necessario eseguire la migrazione del tipo di progetto. WinUI 2.x e Windows SDK supportano i tipi di progetto UWP.

Tuttavia, se si è deciso di eseguire la migrazione dell'applicazione dalla piattaforma UWP al Windows App SDK, nella maggior parte dei casi il codice dell'interfaccia utente necessita solo di alcune modifiche allo spazio dei nomi. Gran parte del codice della piattaforma può rimanere invariato. Sarà necessario modificare alcuni codici a causa delle differenze tra le app UWP e le app desktop. Ma ci si aspetta che per la maggior parte delle app, naturalmente a seconda delle dimensioni della base di codice, la migrazione richieda giorni e non settimane.

A livello generale, questi sono i passaggi della migrazione manuale (vedere però la prossima sezione per informazioni sull'utilizzo dello strumento .NET Upgrade):

1. Creare un nuovo progetto desktop in pacchetto WinUI3 (vedere Creare il primo progetto WinUI 3). che potrebbe entrare nella soluzione esistente.
2. Copiare il codice XAML/UI. In molti casi è sufficiente modificare gli spazi dei nomi, ad esempio, Windows.UI .* in Microsoft.UI.*.
3. Copiare il codice della logica dell'app. Alcune API richiedono modifiche, ad esempio Popup, Picker e SecondaryTile.

Per tutti i dettagli, vedere gli argomenti nella tabella seguente. Descrivono e dimostrano come eseguire la migrazione manuale dell'app Universal Windows Platform (UWP) a Windows App SDK.

Osservare con particolare attenzione Cosa è supportato durante la migrazione dalla piattaforma UWP a WinUI 3. Questo argomento illustra tutte le funzionalità non ancora supportate in WinUI 3 e Windows App SDK. Se l'app necessita di una di queste funzionalità/librerie, è opportuno attendere prima di eseguire la migrazione.

Migrazione con lo strumento .NET Upgrade Assistant

Come ulteriore passaggio per la migrazione delle app UWP a Windows App SKD e a WinUI3, abbiamo sfruttato .NET Upgrade Assistant, aggiungendo il supporto per la migrazione delle app UWP C#. Il supporto per UWP automatizza gran parte del processo di migrazione. Per altre informazioni, vedere l'argomento Migrazione da UWP a Windows App SDK con .NET Upgrade Assistant.

Argomenti in questa sezione

Argomento	Descrizione
Strategia di migrazione globale	Considerazioni e strategie per l'approccio al processo di migrazione e come configurare l'ambiente di sviluppo per la migrazione.
Mapping delle funzionalità UWP a Windows App SDK	Questo argomento confronta le principali aree di funzionalità nei diversi moduli in cui vengono visualizzati nella piattaforma UWP e nella SDK per app di Windows.
Che cosa viene supportato?	Informazioni sulle funzionalità attualmente disponibili in WinUI 3 Desktop per decidere se si deve tentare la migrazione dell'app UWP oggi stesso.
Mapping delle API e delle librerie UWP a Windows App SDK	Questo argomento fornisce un mapping di API e librerie UWP ai relativi equivalenti Windows App SDK.
Guide alle aree di funzionalità	Raccolta di argomenti relativi alle linee guida per la migrazione, ognuno incentrato su un'area di funzionalità specifica.
Case study 1 - PhotoLab (C#)	Questo argomento è un case study sull'acquisizione dell' app di esempio PhotoLab UWP di C# e sulla sua migrazione a Windows App SDK.
Case study 2 - Photo Editor (C++/WinRT)	Questo argomento è un case study dell'acquisizione dell'app di esempio Photo Editor UWP di C++/WinRT e della sua migrazione a Windows App SDK.
Altre indicazioni per la migrazione	Questo argomento contiene ulteriori indicazioni sulla migrazione non categorizzate in un'area di funzionalità nelle guide alle aree di funzionalità.
Migrazione da UWP a Windows App SDK con .NET Upgrade Assistant	Il .NET Upgrade Assistant è uno strumento a riga di comando che può aiutare nella migrazione di un'app UWP C# UWP a un'app Windows UI Library (WinUI) 3 che utilizza Windows App SDK.