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.
Configurare gli strumenti, creare un progetto C# WinUI 3 vuoto e verificare che venga compilato e avviato. Scegliere Visual Studio per un editor integrato e un debugger oppure dotnet new per funzionare dalla riga di comando in qualsiasi editor. Usare le schede seguenti per passare tra i due approcci.
Questa guida introduttiva termina con un progetto in esecuzione. Per aggiungere un'interfaccia utente, l'archiviazione e la navigazione, prosegui quindi con Creare un'app per le note con WinUI 3.
Configurare l'ambiente di sviluppo
Per sviluppare app WinUI 3 con Visual Studio, è necessario Visual Studio 2026 con i carichi di lavoro necessari e la modalità sviluppatore abilitata.
Configurare con WinGet (scelta consigliata)
Aprire Terminale Windows ed eseguire il comando seguente in PowerShell per installare automaticamente Visual Studio 2026 con i carichi di lavoro necessari e abilitare la modalità sviluppatore usando un file di configurazione WinGet:
winget configure -f https://aka.ms/winui-config
Per esaminare il file di configurazione e altre informazioni, vedere README su GitHub.
Note
Se WinGet non è disponibile nell'ambiente, installarlo per primo:
Install-Module -Name Microsoft.WinGet.Client -Force
Repair-WinGetPackageManager -AllUsers
Per altre informazioni, vedere Uso di WinGet .
Configurare manualmente
Se si preferisce installare manualmente gli strumenti:
Abilita modalità sviluppatore: aprire Windows Impostazioni, passare a Sistema > avanzato e attivare la modalità sviluppatore su Sì.
Scaricare e installare Visual Studio 2026. Per informazioni dettagliate, vedere Installare Visual Studio.
Nel programma di installazione di Visual Studio selezionare il carico di lavoro Sviluppo di applicazioni WinUI nella scheda Carichi di lavoro. Per lo sviluppo in C++, selezionare anche strumenti di sviluppo di app WinUI C++ in tale carico di lavoro nel riquadro Dettagli installazione.
Suggerimento
Se non vengono visualizzati modelli WinUI dopo l'installazione di Visual Studio, aprire il programma di installazione di Visual Studio, selezionare Modify e verificare che il carico di lavoro WinUI sia selezionato. Riavviare Visual Studio dopo aver modificato l'installazione.
Creare e avviare la prima app WinUI 3
Aprire Visual Studio 2026 e selezionare Crea un nuovo progetto.
Cercare WinUI, selezionare il modello di progetto C# App vuota WinUI (in pacchetto) e selezionare Avanti.
Immettere un nome di progetto e selezionare Crea.
Premere Start (F5) per compilare ed eseguire l'app.
L'app compila, distribuisce e avvia in modalità di debug:
Hai creato e lanciato la tua prima app WinUI 3! 🎉
Troubleshooting
Se si verificano problemi durante la compilazione o l'esecuzione della prima app, provare queste correzioni comuni:
| Problema | Soluzione |
|---|---|
| I modelli WinUI non vengono visualizzati in Visual Studio | Aprire il programma di installazione Visual Studio, selezionare Modifica e verificare che sia selezionato il carico di lavoro Sviluppo di applicazioni WinUI. Riavviare Visual Studio dopo aver modificato l'installazione. Per informazioni dettagliate, vedere il suggerimento in Configurare l'ambiente di sviluppo . |
| La compilazione non riesce con errori di versione dell'SDK | Apri Visual Studio Installer e seleziona Componenti individuali. Verificare che sia installata la versione Windows SDK di destinazione del progetto. Nel file di progetto verificare che TargetFramework corrisponda all'SDK installato (ad esempio, net10.0-windows10.0.26100.0). |
| Errori di ripristino nuGet | Cancellare nuovamente la cache NuGet locale e ripristinare. In un terminale eseguire: dotnet nuget locals all --clear quindi dotnet restore. |
| Errore "Modalità sviluppatore non abilitato" | Aprire Windows Impostazioni >Sistema > avanzato e attivare la modalità sviluppatore su Sì. Per altre informazioni, vedere Abilitare la modalità sviluppatore . |
| Modifiche non riconosciute dopo la prima installazione dell'SDK | Dopo aver installato o aggiornato i carichi di lavoro SDK per app di Windows o Visual Studio per la prima volta, riavviare Visual Studio in modo che rilevi i nuovi componenti. |
Suggerimento
Se nessuno dei precedenti risolve il problema, cercare i problemi di SDK per app di Windows GitHub o chiedere su Domande e risposte Microsoft A.
Passaggi successivi
La configurazione di sviluppo è pronta. La fase successiva consigliata è il tutorial Note, che illustra i concetti fondamentali di XAML e C# in Visual Studio. Se si preferisce apprendere un flusso di lavoro assistito dall'intelligenza artificiale, scegliere invece l'esercitazione Task Tally; non è necessario completare entrambe le operazioni.
Per il percorso facoltativo assistito dall'intelligenza artificiale, vedere Creare un'app per le attività WinUI 3 con un assistente di intelligenza artificiale. Illustra come vincolare il codice generato a WinUI 3 e verificare il risultato.
Crea un'app WinUI 3 per prendere appunti
Informazioni su XAML, eventi, archiviazione file, data binding e navigazione in un'app C# a due pagine.
Raccolta WinUI 3
Esplora esempi interattivi di controlli, caratteristiche e funzionalità di WinUI.
Esempi e risorse
Esplorare esempi di codice, progetti iniziali e strumenti per accelerare lo sviluppo.
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.
