WinUI

Valmistuge arenema WinUI 3-ga

Lehekülg uuendatud :
Lehe loomise kuupäev :

Töökeskkond

Windows
  • Windows 11
Visuaalne stuudio
  • Visual Studio 2022 versioon 17.9.3
.NET
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
Windowsi rakenduse SDK
  • 1.4.230913002

Eeltingimused

Mõnel juhul võivad töötada ka madalamad versioonid.

Windows
  • Windows 10
  • Windows 11
Visuaalne stuudio
  • Visual Studio 2022 versioon 17.9.3 või uuem
.NET
  • .NET 6
  • (.NET 8)
Windowsi rakenduse SDK
  • 1.4.230913002 või uuem

Installige Visual Studio ja seadistage WinUI

WinUI 3 arendusprojekte saab lisada Visual Studio installatsiooniga. Selles jaotises kirjeldatakse Visual Studio installiprotsessi lihtsustatud viisil. Üksikasjalikud juhised leiate järgmistest näpunäidetest.

Käivitage Visual Studio 2022 installer Internetist või meediumist. See toetab kogukonna, professionaali või kõrgemaid väljaandeid.

Valige töökoormuse valikul . NET töölaua arendamine.

「. NET töölaua arendamine ja kontrollige Windowsi rakenduse SDK C# malle paremal asuvast installi üksikasjadest.

Nüüd alustage lihtsalt installimist. On ka teisi ekraane, kuid ma ei selgita neid enne, kui nad loovad projekti.

Kui installimine on lõpule jõudnud, looge uus projekt.

Paremas ülanurgas winui on otsinguelemendis, nii et kui valite selle, kuvatakse WinUI 3 projekti mall, nii et valige ükskõik milline mall ja looge projekt.

Nüüd saate WinUI 3 abil rakendusi arendada.

Kui näete teadet "Installimata .NET-i versiooni sihtimine"

Alates Visual Studio 2022 versioonist 17.9.1 on .NET WinUI 3 jaoks suunatud .NET 6. Kui te ei vali rakenduses Visual Studio 2022 täiendavaid käitusaegu, installitakse ainult .NET 8 käitusaeg ja võite näha sellist hoiatust nagu allpool.

Kui olete mures, võite installida .NET 6 käitusaja või lihtsalt hoiatusest loobuda. Silumiseks ei pea te .NET 6 käitusaega installima.

Kui soovite WinUI 3 arenduskeskkonda hiljem lisada

Kui installite kõigepealt Visual Studio, saate hiljem lisada WinUI 3 arenduskeskkonna.

Käivitage Visual Studio ja valige menüüst Tööriistad > Hangi tööriistad ja funktsioonid.

Kuvatakse sama ekraan, mis Visual Studio installimisel, nii et saate kasutada . Veenduge, et ruut oleks märgitud ".NET Desktop Development" ja kontrollige paremal asuvast jaotisest "Installimise üksikasjad" "Windows App SDK C# Template".

Luba arendaja režiim

WinUI rakendused töötavad erinevalt teistest töölauarakendustest turvalisusega täiustatud keskkonnas. Seetõttu ei saa seda käivitada nii, nagu see on. Kui proovite seda käivitada, näete sellist dialoogi nagu allpool ja teil palutakse lubada "Arendaja režiim". Kui klõpsate lingil, kuvatakse seadistusekraan, nii et palun lubage "Arendaja režiim".

Isegi kui te ei kasuta Visual Studio'i, saate seadete ekraanilt lubada või keelata ka "Arendaja režiimi". Valige menüüst Start menüü "Seaded".

Tehke menüüst Süsteem valik Arendajatele.

"Arendajatele" jaoks on lüliti, nii et seadke see asendisse "Sees". Kuvatakse märkus, seega valige selle lubamiseks "Jah".

Kui soovite vahetada .NET 8 vastu

Kui loote selle malliga projekti, on selle vaikeväärtuseks .NET 6. Isegi kui ma muudan projekti atribuutidest sihtraamistiku .NET 8-ks, näitab järk ikkagi vigu ja hoiatusi. Kuid umbes 13.03.2024 värskendatakse Windowsi rakenduse SDK-d, et see toetaks ametlikult .NET 8.

Kuid mall on endiselt .NET 6-s, nii et peate pärast projekti loomist töötama .NET 8-ga. Võib olla võimalik, et seda toetatakse tulevastes versiooniuuendustes.

Esmalt looge projekt ja seejärel kasutage NuGetit Windowsi rakenduse SDK-ga seotud versioonide värskendamiseks.

Kui pole teisiti, on kõik ajakohane. Microsoft.WindowsAppSDK peab olema vähemalt 1.5.XXXX.

Muutke sihtraamistik projekti atribuutidest .NET 8-ks.

Isegi kui ehitate selles olekus, kuvatakse viga, kuna projekti seaded on aegunud.

Avage projektifail koodina.

RuntimeIdentifiersKuna parameeter on olemas, eemaldage järgmine märk 10 Win10 .

Enne muutmist

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

↓

Pärast parandust

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

Samuti kirjutab see ümber programmi avaldamisseaded. Avage iga .pubxml fail kaustas Properties > PublishProfiles.

Samamoodi RuntimeIdentifier , eemaldage parameetris Win10 märk 10 .

Pärast seda taastage ja kontrollige, et vigu ega hoiatusi pole. .pubxml (Failis on hoiatus, kuid te ei pea selle pärast muretsema, kuna see on sellest probleemist erinev süntaks.) )

Kuid mingil põhjusel hoiatab WinUI klassi raamatukogu jätkuvalt isegi siis, kui teete sama, mis eespool. Praegu saate seda käivitada, nii et ootame, kuni see on fikseeritud.