Eseguire la migrazione da UWP a Windows App SDK

  • Articolo

Per eseguire la migrazione dell'app dalla piattaforma UWP (Universal Windows Platform) (UWP) alla SDK per app di Windows, il codice dell'interfaccia utente richiede probabilmente solo alcune modifiche allo spazio dei nomi, mentre gran parte del codice della piattaforma può rimanere invariata. 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.

Nota

Se sei soddisfatto delle funzionalità correnti della piattaforma UWP e della tua app UWP, non è necessario eseguire la migrazione del progetto. WinUI 2 e Windows SDK continuano a supportare i tipi di progetto UWP.

Di seguito sono riportati i passaggi, a livello generale, per la migrazione manuale. Per informazioni sull'uso dello strumento Assistente aggiornamento .NET, vedere la sezione seguente.

  1. Creare un nuovo progetto desktop in pacchetto WinUI3 (vedere Creare il primo progetto WinUI 3). Ciò potrebbe entrare nella soluzione esistente del progetto.
  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.

Prendere nota di Cosa è supportato durante la migrazione da UWP a WinUI 3, che descrive tutte le funzionalità non ancora supportate in WinUI 3 e Windows App SDK. Se l'app necessita di una di queste funzionalità/librerie, è consigliabile posticipare la migrazione.

Nota

Se il codice sorgente dell'app UWP è scritto in C++/CX, vedi anche Sposta in C++/WinRT da C++/CX.

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.

Vantaggi della containerizzazione

Quando si passa alla SDK per app di Windows, le applicazioni UWP potrebbero perdere i vantaggi intrinseci di containerizzazione della piattaforma originale. Tuttavia, questi vantaggi possono essere ripristinati usando l'isolamento app Win32, una nuova funzionalità di sicurezza che migliora la protezione isolando le applicazioni all'interno di un ambiente sandbox. Questo approccio offre maggiore sicurezza contro potenziali minacce con modifiche minime al codice esistente. Per altre info e per iniziare a usare l'isolamento dell'app Win32, visitare il repository di isolamento delle app Win32 in GitHub.

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 WinUI 3 che utilizza Windows App SDK.

Vedi anche