WinUI

Pregătiți-vă să dezvoltați cu WinUI 3

Pagina actualizată :
Data creării paginii :

Mediu de operare

Windows
  • Ferestre 11
Visual Studio
  • Visual Studio 2022 versiunea 17.9.3
.NET
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
SDK pentru aplicații Windows
  • 1.4.230913002

Cerințe preliminare

În unele cazuri, pot funcționa și versiuni inferioare.

Windows
  • Ferestre 10
  • Ferestre 11
Visual Studio
  • Visual Studio 2022 versiunea 17.9.3 sau o versiune ulterioară
.NET
  • .NET 6
  • (.NET 8)
SDK pentru aplicații Windows
  • 1.4.230913002 sau o versiune ulterioară

Instalați Visual Studio și configurați WinUI

Proiectele de dezvoltare WinUI 3 pot fi adăugate cu instalarea Visual Studio. Această secțiune oferă o descriere simplificată a procesului de instalare Visual Studio. Pentru instrucțiuni detaliate, vă rugăm să consultați următoarele sfaturi.

Lansați programul de instalare Visual Studio 2022 de pe internet sau media. Acceptă ediții comunitare, profesionale sau superioare.

În selecția volumului de lucru, selectați . Dezvoltare desktop NET.

「. NET Desktop Development și verificați Windows App SDK C# Templates din Detalii de instalare din dreapta.

Acum începeți instalarea. Există și alte ecrane, dar nu le voi explica până când nu vor crea un proiect.

După finalizarea instalării, creați un proiect nou.

Există un element de căutare în winui dreapta sus, astfel încât atunci când îl selectați, șablonul de proiect WinUI 3 va fi afișat, deci selectați orice șablon și creați un proiect.

Acum puteți dezvolta aplicații folosind WinUI 3.

Dacă vedeți "Direcționarea unei versiuni de .NET care nu este instalată"

Începând cu versiunea 17.9.1 Visual Studio 2022 , .NET pentru WinUI 3 vizează .NET 6. Dacă nu selectați runtime suplimentare în Visual Studio 2022, va fi instalat numai componenta runtime .NET 8 și este posibil să vedeți un avertisment ca cel de mai jos.

Dacă sunteți îngrijorat, puteți instala componenta runtime .NET 6 sau pur și simplu respingeți avertismentul. Nu trebuie să instalați componenta runtime .NET 6 pentru depanare.

Dacă doriți să adăugați un mediu de dezvoltare WinUI 3 mai târziu

Dacă instalați mai întâi Visual Studio, puteți adăuga un mediu de dezvoltare WinUI 3 mai târziu.

Porniți Visual Studio și selectați Instrumente > Obțineți instrumente și caracteristici din meniu.

Se va afișa același ecran ca atunci când ați instalat Visual Studio, astfel încât să puteți utiliza fișierul . Asigurați-vă că este bifată opțiunea ".NET Desktop Development" și bifați "Windows App SDK C# Template" din "Installation Details" din dreapta.

Activați modul dezvoltator

Aplicațiile WinUI rulează într-un mediu cu securitate îmbunătățită, spre deosebire de alte aplicații desktop. Prin urmare, nu poate fi rulat așa cum este. Când încercați să îl rulați, veți vedea un dialog ca cel de mai jos și vi se va solicita să activați "Modul dezvoltator". Dacă faceți clic pe link, va fi afișat ecranul de setare, deci vă rugăm să activați "Modul dezvoltator".

Chiar dacă nu utilizați Visual Studio, puteți, de asemenea, să activați sau să dezactivați "Modul dezvoltator" din ecranul de setări. Selectați "Setări" din meniul Start.

Din meniul Sistem, selectați Pentru dezvoltatori.

Există un comutator pentru "Pentru dezvoltatori", deci setați-l la "Activat". Va fi afișată o notă, deci selectați "Da" pentru a o activa.

Dacă doriți să treceți la .NET 8

Dacă creați un proiect cu acest șablon, acesta va fi implicit .NET 6. Chiar dacă modific cadrul țintă la .NET 8 din proprietățile proiectului, compilarea afișează în continuare erori și avertismente. Cu toate acestea, în jurul datei de 13.03.2024, SDK-ul pentru aplicații Windows va fi actualizat pentru a suporta oficial .NET 8.

Cu toate acestea, șablonul este încă în .NET 6, deci va trebui să lucrați la .NET 8 după ce ați creat proiectul. Este posibil să existe posibilitatea ca acesta să fie acceptat în actualizările viitoare ale versiunilor.

Mai întâi, creați un proiect, apoi utilizați NuGet pentru a actualiza versiunile legate de Windows App SDK.

Cu excepția cazului în care altfel, totul este actualizat. Microsoft.WindowsAppSDK trebuie să aibă cel puțin 1.5.XXXX.

Modificați cadrul țintă la .NET 8 din proprietățile proiectului.

Chiar dacă construiți în această stare, se va afișa o eroare, deoarece setările proiectului sunt depășite.

Deschideți fișierul proiectului ca cod.

RuntimeIdentifiersDeoarece există un parametru, eliminați caracterul după 10 cum urmează Win10 .

Înainte de modificare

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

↓

După remediere

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

De asemenea, rescrie setările de publicare ale programului. Deschideți fiecare .pubxml fișier în folderul Proprietăți > PublishProfiles.

RuntimeIdentifier În mod similar, eliminați caracterul din 10 parametrul Win10 .

După aceea, reconstruiți și verificați dacă nu există erori sau avertismente. .pubxml (Va exista un avertisment în fișier, dar nu trebuie să vă faceți griji, deoarece este o sintaxă diferită de această problemă.) )

Cu toate acestea, din anumite motive, biblioteca de clase WinUI continuă să avertizeze chiar dacă faceți același lucru ca mai sus. Pentru moment, îl puteți rula, așa că să așteptăm până când acest lucru este remediat.