Condividi tramite

Eseguire la migrazione dalla piattaforma UWP alla SDK per app di Windows

Per eseguire la migrazione dell'app dal 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

L'app UWP esistente continuerà a funzionare come previsto. Tuttavia, per sfruttare le funzionalità moderne in WinUI 3 e SDK per app di Windows consigliamo di eseguire la migrazione dell'app.

Di seguito sono riportati i passaggi, a livello generale, per la migrazione manuale. Vedere la sezione seguente per informazioni sull'uso dello strumento .NET Upgrade Assistant).

  1. Crea un nuovo progetto desktop con pacchetto WinUI (vedere Crea il tuo primo progetto WinUI). Questo potrebbe essere incorporato nella soluzione esistente del progetto.
  2. Copiare il codice XAML/UI. In molti casi è sufficiente modificare gli spazi dei nomi, ad esempio Windows. UI.* per 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 illustrano come eseguire manualmente la migrazione dell'applicazione Piattaforma UWP (Universal Windows Platform) al SDK per app di Windows.

Prendere nota particolare di Cosa è supportato durante la migrazione da UWP a WinUI, che descrive tutte le funzionalità non ancora supportate in WinUI e SDK per app di Windows. 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 tramite lo strumento .NET Upgrade Assistant

Come ulteriore passaggio per aiutarti a eseguire la migrazione delle tue app UWP alla SDK per app di Windows e a WinUI, 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 ulteriori informazioni, vedi l'argomento Migrate dalla piattaforma UWP alla SDK per app di Windows con l'Assistente di aggiornamento .NET.

Vantaggi della containerizzazione

Quando si passa alla SDK per app di Windows, le applicazioni UWP potrebbero perdere i vantaggi intrinseci della loro 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, vedi Panoramica dell'isolamento delle app Win32.

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 nel SDK per app di Windows 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? Scopri quali funzionalità sono attualmente disponibili in WinUI Desktop per valutare se dovresti provare subito a eseguire la migrazione dell'app UWP.
Mapping delle API e delle librerie UWP per SDK per app di Windows Questo argomento fornisce un mapping delle API e delle librerie UWP ai relativi equivalenti SDK per app di Windows.
Guide dell'area funzionale 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'uso dell'app di esempio PhotoLab di C# UWP e sulla migrazione alla SDK per app di Windows.
Case study 2 - Photo Editor (C++/WinRT) Questo argomento è uno studio di caso sulla migrazione dell'app di esempio dell'editor di foto C++/WinRT UWP verso la piattaforma SDK per app di Windows.
Altre indicazioni per la migrazione Questo argomento contiene indicazioni aggiuntive sulla migrazione che non sono classificate in un'area di funzionalità nei feature area guides.
Migrate dalla piattaforma UWP alla SDK per app di Windows con .NET Upgrade Assistant .NET Upgrade Assistant è uno strumento da riga di comando che consente di eseguire la migrazione di un'app UWP C# a un'app UWP WinUI che usa l'SDK per app di Windows.
Usare l'intelligenza artificiale per modernizzare l'app Come usare GitHub Copilot per accelerare la modernizzazione di un'app desktop esistente per SDK per app di Windows e WinUI 3.

Vedi anche

  • Last updated on