Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
WinUI 3 è il framework nativo dell'interfaccia utente per la creazione di app desktop Windows. Fa parte del SDK per app di Windows, ovvero un set di API e strumenti separati dal sistema operativo Windows stesso e deve essere installato nel computer di destinazione o incluso nel pacchetto insieme all'app. WinUI 3 supporta sia C# che C++ e non è un framework multipiattaforma o basato sul Web.
Importante
WinUI 3 è diverso da UWP. WinUI 3 usa lo spazio dei nomi Microsoft.UI.Xaml e viene eseguito come processo desktop; UWP usa Windows.UI.Xaml e viene eseguito in un contenitore di app. WinUI 3 supporta la distribuzione in pacchetto (MSIX), in pacchetto con percorso esterno e senza pacchetto: la scelta giusta dipende dallo scenario di distribuzione. Per indicazioni, vedere Scegliere un metodo di distribuzione .
Scegliere il percorso
Esistono due percorsi supportati per la creazione di un progetto WinUI 3.
| Visual Studio | Riga di comando | |
|---|---|---|
| Migliore per | Gli sviluppatori non hanno familiarità con lo sviluppo Windows, i progettisti dell'interfaccia utente visiva o chiunque voglia un'esperienza IDE completa | Gli sviluppatori hanno familiarità con il terminale, le pipeline CI/CD o la configurazione dell'ambiente con script |
| Utensili | Visual Studio 2026 con i carichi di lavoro SDK per app di Windows e WinUI installati | .NET 10 SDK con dotnet new Modelli WinUI |
| Creazione del progetto | Procedura guidata Nuovo progetto: selezionare il modello App vuota, pacchettizzata (WinUI 3 in Desktop) | dotnet new winui -n MyApp |
| Compilare ed eseguire | Premere F5 — Visual Studio compila, firma, distribuisce il pacchetto MSIX e avvia l'app |
dotnet run — compila e avvia l'app con l'identità del pacchetto (richiede la modalità sviluppatore) |
| Debugging | Debugger completo di Visual Studio con anteprima XAML in tempo reale | Collegare manualmente il debugger o aprire il file generato .sln in Visual Studio |
Entrambi i percorsi producono progetti WinUI 3 equivalenti. Il percorso Visual Studio gestisce automaticamente la firma e la distribuzione MSIX. Il percorso della riga di comando usa dotnet run per lo sviluppo locale (il pacchetto incluso Microsoft.Windows.SDK.BuildTools.WinApp gestisce automaticamente l'identità di debug). La creazione di pacchetti per la distribuzione richiede passaggi aggiuntivi.
Prerequisiti
Entrambi i percorsi condividono gli stessi requisiti minimi.
- Windows 10 versione 1809 (build 17763) o successiva: è consigliabile Windows 11
-
Modalità sviluppatore abilitata nel dispositivo (
ms-settings:developers) - Visual Studio 2026 (percorso Visual Studio) o .NET 10 SDK (percorso della riga di comando)
Il SDK per app di Windows è un'installazione separata da Windows. Visual Studio lo installa come parte della configurazione del carico di lavoro. Per il percorso della riga di comando, i dotnet new winui modelli inseriscono automaticamente i pacchetti NuGet necessari.
Passaggi successivi
Collabora con noi su GitHub
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
