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.
Creare, compilare ed eseguire la prima app WinUI 3. Scegliere Visual Studio per un'esperienza IDE completa con il supporto della finestra di progettazione visiva o dotnet new per funzionare dalla riga di comando in qualsiasi editor. Usare le schede seguenti per passare tra i due approcci.
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
Creare la prima app WinUI
Sei pronto per continuare? Segui il tutorial passo-passo per creare un'app WinUI completa.
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.
