WinUI

Preparati allo sviluppo con WinUI 3

Pagina aggiornata :
Data di creazione della pagina :

Ambiente operativo

Finestre
  • finestre 11
Studio visivo
  • Visual Studio 2022 versione 17.9.3
.RETE
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
Windows App SDK
  • 1.4.230913002

Prerequisiti

In alcuni casi, possono funzionare anche versioni precedenti.

Finestre
  • finestre 10
  • finestre 11
Studio visivo
  • Visual Studio 2022 versione 17.9.3 o successiva
.RETE
  • .NET 6
  • (.NET 8)
Windows App SDK
  • 1.4.230913002 o versioni successive

Installare Visual Studio e configurare WinUI

I progetti di sviluppo WinUI 3 possono essere aggiunti con l'installazione di Visual Studio. In questa sezione viene fornita una descrizione semplificata del processo di installazione di Visual Studio. Per istruzioni dettagliate, fare riferimento ai seguenti suggerimenti.

Avvia il programma di installazione di Visual Studio 2022 da Internet o dai media. Supporta le edizioni Community, Professional o superiori.

Nella selezione del carico di lavoro, selezionare . NET Desktop Development.

「. NET Desktop Development e controllare i modelli C# di SDK per app di Windows dai dettagli dell'installazione a destra.

Ora avvia l'installazione. Ci sono altre schermate, ma non le spiegherò fino a quando non creeranno un progetto.

Una volta completata l'installazione, crea un nuovo progetto.

C'è un nell'elemento di ricerca in winui alto a destra, quindi quando lo selezioni, verrà visualizzato il modello di progetto WinUI 3, quindi seleziona qualsiasi modello e crea un progetto.

È ora possibile sviluppare applicazioni usando WinUI 3.

Se viene visualizzato il messaggio "Destinazione di una versione di .NET non installata"

A partire dalla versione 17.9.1 di Visual Studio 2022, .NET per WinUI 3 è destinato a .NET 6. Se non si selezionano runtime aggiuntivi in Visual Studio 2022, verrà installato solo il runtime .NET 8 e potrebbe essere visualizzato un avviso simile a quello seguente.

Se sei preoccupato, puoi installare il runtime .NET 6 o semplicemente ignorare l'avviso. Non è necessario installare il runtime .NET 6 per eseguire il debug.

Se si vuole aggiungere un ambiente di sviluppo WinUI 3 in un secondo momento

Se si installa prima Visual Studio, è possibile aggiungere un ambiente di sviluppo WinUI 3 in un secondo momento.

Avviare Visual Studio e selezionare Strumenti > Ottieni strumenti e funzionalità dal menu.

Verrà visualizzata la stessa schermata utilizzata per l'installazione di Visual Studio, in modo da poter utilizzare . Assicurarsi che l'opzione "Sviluppo desktop .NET" sia selezionata e selezionare "Modello C# SDK per app di Windows" da "Dettagli installazione" a destra.

Abilita la modalità sviluppatore

A differenza di altre applicazioni desktop, le applicazioni WinUI vengono eseguite in un ambiente con sicurezza avanzata. Pertanto, non può essere eseguito così com'è. Quando provi a eseguirlo, vedrai una finestra di dialogo come quella qui sotto e ti verrà chiesto di abilitare la "Modalità sviluppatore". Se fai clic sul collegamento, verrà visualizzata la schermata delle impostazioni, quindi abilita la "Modalità sviluppatore".

Anche se non si utilizza Visual Studio, è anche possibile abilitare o disabilitare la "Modalità sviluppatore" dalla schermata delle impostazioni. Seleziona "Impostazioni" dal menu Start.

Dal menu Sistema, seleziona Per sviluppatori.

C'è un interruttore per "Per sviluppatori", quindi impostalo su "On". Verrà visualizzata una nota, quindi seleziona "Sì" per abilitarla.

Se si vuole passare a .NET 8

Se si crea un progetto con questo modello, per impostazione predefinita verrà utilizzato .NET 6. Anche se modifico il framework di destinazione in .NET 8 dalle proprietà del progetto, la build mostra ancora errori e avvisi. Tuttavia, intorno al 03/13/2024, l'SDK per app di Windows verrà aggiornato per supportare ufficialmente .NET 8.

Tuttavia, il modello è ancora in .NET 6, quindi sarà necessario lavorare su .NET 8 dopo aver creato il progetto. Potrebbe esserci la possibilità che venga supportato nei futuri aggiornamenti della versione.

Prima di tutto, creare un progetto e quindi usare NuGet per aggiornare le versioni correlate a SDK per app di Windows.

Salvo diversamente, tutto è aggiornato. Microsoft.WindowsAppSDK deve essere almeno 1.5.XXXX.

Modificare il framework di destinazione in .NET 8 dalle proprietà del progetto.

Anche se si compila in questo stato, verrà visualizzato un errore perché le impostazioni del progetto sono obsolete.

Aprire il file di progetto come codice.

RuntimeIdentifiersPoiché esiste un parametro, rimuovere il carattere di 10 come segue Win10 .

Prima della modifica

<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>

↓

Dopo la correzione

<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>

Riscrive anche le impostazioni di pubblicazione del programma. Aprire ogni .pubxml file nella cartella Proprietà > PublishProfiles.

Allo stesso modo RuntimeIdentifier , rimuovere il carattere di 10 nel Win10 parametro di .

Successivamente, ricostruisci e verifica che non ci siano errori o avvisi. .pubxml (Ci sarà un avviso nel file, ma non devi preoccuparti perché è una sintassi diversa da questo problema.) )

Tuttavia, per qualche motivo, la libreria di classi WinUI continua ad avvisare anche se si esegue la stessa operazione di cui sopra. Per il momento, puoi eseguirlo, quindi aspettiamo fino a quando questo non viene risolto.