Sagatavojieties attīstībai ar WinUI 3

Lapa atjaunota :
Lapas izveides datums :

Darbības vide

Windows
  • Operētājsistēmā Windows 11
Visual Studio
  • Visual Studio 2022 versija 17.9.3
.NETO
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
Windows lietojumprogrammu SDK
  • 1.4.230913002

Priekšnoteikumi

Dažos gadījumos var darboties arī zemākas versijas.

Windows
  • Operētājsistēmā Windows 10
  • Operētājsistēmā Windows 11
Visual Studio
  • Visual Studio 2022 versija 17.9.3 vai jaunāka
.NETO
  • .NET 6
  • (.NET 8)
Windows lietojumprogrammu SDK
  • 1.4.230913002 vai jaunāka versija

Instalējiet Visual Studio un iestatiet WinUI

WinUI 3 izstrādes projektus var pievienot ar Visual Studio instalāciju. Šajā sadaļā ir sniegts vienkāršots Visual Studio instalēšanas procesa apraksts. Lai iegūtu detalizētus norādījumus, lūdzu, skatiet šos padomus.

Palaidiet Visual Studio 2022 instalētāju no interneta vai multivides. Tas atbalsta kopienas, profesionālos vai augstākus izdevumus.

Darba slodzes atlasē atlasiet . NET darbvirsmas izstrāde.

「. NET Desktop izstrāde un pārbaudiet Windows App SDK C# veidnes no instalācijas informācijas labajā pusē.

Tagad vienkārši sāciet instalēšanu. Ir arī citi ekrāni, bet es tos nepaskaidrošu, kamēr tie neizveidos projektu.

Kad instalēšana ir pabeigta, izveidojiet jaunu projektu.

Augšējā labajā stūrī ir meklēšanas vienums winui , tāpēc, izvēloties to, tiks parādīta WinUI 3 projekta veidne, tāpēc atlasiet jebkuru veidni un izveidojiet projektu.

Tagad varat izstrādāt lietojumprogrammas, izmantojot WinUI 3.

Ja redzat "Mērķauditorijas atlase pēc .NET versijas, kas nav instalēta"

Sākot ar Visual Studio 2022 versiju 17.9.1 , .NET for WinUI 3 mērķis ir .NET 6. Ja programmā Visual Studio 2022 neatlasāt papildu izpildlaikus, tiks instalēts tikai .NET 8 izpildlaiks, un, iespējams, tiks parādīts brīdinājums, kas līdzīgs tālāk redzamajam.

Ja uztraucaties, varat instalēt .NET 6 izpildlaiku vai vienkārši noraidīt brīdinājumu. Lai atkļūdotu, nav jāinstalē .NET 6 izpildlaiks.

Ja vēlaties vēlāk pievienot WinUI 3 izstrādes vidi

Ja vispirms instalējat Visual Studio, vēlāk varat pievienot WinUI 3 izstrādes vidi.

Startējiet programmu Visual Studio un izvēlnē atlasiet Rīki > iegūstiet rīkus un līdzekļus.

Tiks parādīts tāds pats ekrāns kā tad, kad instalējāt Visual Studio, lai jūs varētu izmantot . Pārliecinieties, vai ir atzīmēta izvēles rūtiņa ".NET Desktop Development", un labajā pusē sadaļā "Instalācijas detaļas" atzīmējiet "Windows App SDK C# Template".

Iespējot izstrādātāja režīmu

WinUI lietojumprogrammas darbojas paaugstinātas drošības vidē atšķirībā no citām darbvirsmas lietojumprogrammām. Tāpēc to nevar palaist tā, kā tas ir. Mēģinot to palaist, jūs redzēsiet tādu dialogu kā zemāk esošais, un jums tiks piedāvāts iespējot "Izstrādātāja režīms". Noklikšķinot uz saites, tiks parādīts iestatījumu ekrāns, tāpēc, lūdzu, iespējojiet "Izstrādātāja režīms".

Pat ja neizmantojat Visual Studio, iestatījumu ekrānā varat arī iespējot vai atspējot "Izstrādātāja režīmu". Izvēlnē Sākt atlasiet "Iestatījumi".

Izvēlnē Sistēma atlasiet For Developers (Izstrādātājiem).

"Izstrādātājiem" ir slēdzis, tāpēc iestatiet to uz "Ieslēgts". Tiks parādīta piezīme, tāpēc atlasiet "Jā", lai to iespējotu.

Ja vēlaties pāriet uz .NET 8

Ja izveidojat projektu, izmantojot šo veidni, tā noklusējuma vērtība ir .NET 6. Pat ja es mainu mērķa struktūru uz .NET 8 no projekta rekvizītiem, būvējumā joprojām tiek rādītas kļūdas un brīdinājumi. Tomēr ap 13.03.2024. Windows App SDK tiks atjaunināts, lai oficiāli atbalstītu .NET 8.

Tomēr veidne joprojām ir .NET 6, tāpēc pēc projekta izveides jums būs jāstrādā ar .NET 8. Pastāv iespēja, ka tas tiks atbalstīts turpmākajos versiju jauninājumos.

Vispirms izveidojiet projektu un pēc tam izmantojiet NuGet, lai atjauninātu ar Windows programmu SDK saistītās versijas.

Ja vien nav citādi, viss ir aktuāls. Microsoft.WindowsAppSDK jābūt vismaz 1.5.XXXX.

Mainiet mērķa struktūru uz .NET 8 no projekta rekvizītiem.

Pat ja veidojat šādā stāvoklī, tiks parādīta kļūda, jo projekta iestatījumi ir novecojuši.

Atveriet projekta failu kā kodu.

RuntimeIdentifiersTā kā ir parametrs, noņemiet šādu raksturu 10 Win10 .

Pirms modificēšanas

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

Pēc labojuma

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

Tas arī pārraksta programmas publicēšanas iestatījumus. Atveriet katru .pubxml failu mapē Rekvizīti > PublishProfiles.

RuntimeIdentifier Līdzīgi , noņemiet rakstzīmi 10 parametrā Win10 .

Pēc tam pārbūvējiet un pārbaudiet, vai nav kļūdu vai brīdinājumu. .pubxml (Failā būs brīdinājums, bet jums par to nav jāuztraucas, jo tā ir no šīs problēmas atšķirīga sintakse.) )

Tomēr kāda iemesla dēļ WinUI klases bibliotēka turpina brīdināt, pat ja jūs darāt to pašu, ko iepriekš. Pagaidām jūs varat to palaist, tāpēc pagaidīsim, līdz tas tiks novērsts.