Felkészülés a WinUI 3-mal való fejlesztésre
Működési környezet
- Windows
-
- Windows 11 esetén
- Visual Studio
-
- Visual Studio 2022 17.9.3-as verzió
- .HÁLÓ
-
- .NET 6
- (.NET 8)
- WinUI
-
- WinUI 3
- Windows App SDK
-
- 1.4.230913002
Előfeltételek
Bizonyos esetekben az alacsonyabb verziók is működhetnek.
- Windows
-
- Windows 10 esetén
- Windows 11 esetén
- Visual Studio
-
- Visual Studio 2022 17.9.3-as vagy újabb verzió
- .HÁLÓ
-
- .NET 6
- (.NET 8)
- Windows App SDK
-
- 1.4.230913002 vagy újabb
A Visual Studio telepítése és a WinUI beállítása
A WinUI 3 fejlesztési projektek hozzáadhatók a Visual Studio telepítésével. Ez a szakasz a Visual Studio telepítési folyamatának egyszerűsített leírását tartalmazza. Részletes útmutatásért kérjük, olvassa el az alábbi tippeket.
Indítsa el a Visual Studio 2022 telepítőjét az internetről vagy a médiából. Támogatja a közösségi, professzionális vagy magasabb kiadásokat.
A számítási feladat kiválasztásában válassza a lehetőséget. NET asztali fejlesztés.
「. NET Desktop Development (Asztali fejlesztés) elemet, és ellenőrizze a Windows App SDK C#-sablonokat a jobb oldali Telepítés részletei között.
Most csak indítsa el a telepítést. Vannak más képernyők is, de nem magyarázom el őket, amíg nem hoznak létre egy projektet.
A telepítés befejezése után hozzon létre egy új projektet.
A jobb felső sarokban winui található keresési elemben van egy elem, így amikor kiválasztja, megjelenik a WinUI 3 projektsablon, ezért válasszon ki egy sablont, és hozzon létre egy projektet.
Most már fejleszthet alkalmazásokat a WinUI 3 használatával.
Ha a "Nem telepített .NET-verzió megcélzása" üzenet jelenik meg
A Visual Studio 2022-es verziójától 17.9.1 kezdve a .NET for WinUI 3 a .NET 6-ot célozza meg.
Ha nem választ további futtatókörnyezeteket a Visual Studio 2022-ben, csak a .NET 8-futtatókörnyezet lesz telepítve, és az alábbihoz hasonló figyelmeztetés jelenhet meg.
Ha aggódik, telepítheti a .NET 6-futtatókörnyezetet, vagy egyszerűen elvetheti a figyelmeztetést. A hibakereséshez nem kell telepítenie a .NET 6-futtatókörnyezetet.
Ha később WinUI 3 fejlesztői környezetet szeretne hozzáadni
Ha először telepíti a Visual Studiót, később hozzáadhat egy WinUI 3 fejlesztési környezetet.
Indítsa Visual Studio, és válassza az Eszközök > az Eszközök és szolgáltatások beszerzése lehetőséget a menüből.
Ugyanaz a képernyő jelenik meg, mint a Visual Studio telepítésekor, így használhatja a . Győződjön meg arról, hogy a ".NET Desktop Development" be van jelölve, és jelölje be a "Windows App SDK C# Template" (Windows App SDK C#-sablon) lehetőséget a jobb oldali "Installation Details" (Telepítés részletei) részben.
Fejlesztői mód engedélyezése
A WinUI alkalmazások más asztali alkalmazásokkal ellentétben fokozott biztonsági környezetben futnak. Ezért nem futtatható úgy, ahogy van. Amikor megpróbálja futtatni, az alábbihoz hasonló párbeszédpanel jelenik meg, és a rendszer kéri, hogy engedélyezze a "Fejlesztői módot". Ha rákattint a linkre, megjelenik a beállítási képernyő, ezért engedélyezze a "Fejlesztői módot".
Még akkor is, ha nem használja a Visual Studio-t, engedélyezheti vagy letilthatja a "Fejlesztői módot" a beállítások képernyőn. Válassza a "Beállítások" lehetőséget a Start menüből.
A System (Rendszer) menüben válassza a For Developers (Fejlesztőknek) lehetőséget.
Van egy kapcsoló a "Fejlesztőknek" számára, ezért állítsa "Be" állásba. Megjelenik egy jegyzet, ezért válassza az "Igen" lehetőséget az engedélyezéséhez.
Ha .NET 8-ra szeretne váltani
Ha ezzel a sablonnal hoz létre projektet, az alapértelmezés szerint a .NET 6 lesz. Még akkor is, ha a célkeretrendszert .NET 8-ra módosítom a projekt tulajdonságaiból, a build továbbra is hibákat és figyelmeztetéseket jelenít meg. 2024. 03. 13. körül azonban a Windows App SDK frissül, hogy hivatalosan támogassa a .NET 8-at.
A sablon azonban továbbra is a .NET 6-ban van, ezért a projekt létrehozása után a .NET 8-on kell dolgoznia. Előfordulhat, hogy a jövőbeli verziófrissítések támogatni fogják.
Először hozzon létre egy projektet, majd a NuGet használatával frissítse a Windows App SDK-hoz kapcsolódó verziókat.
Hacsak másképp nem működik, minden naprakész. Microsoft.WindowsAppSDK legalább 1.5.XXXX-nek kell lennie.
Módosítsa a célkeretrendszert .NET 8-ra a projekt tulajdonságaiból.
Még akkor is, ha ebben az állapotban épít, hibaüzenet jelenik meg, mert a projektbeállítások elavultak.
Nyissa meg a projektfájlt kódként.
RuntimeIdentifiersMivel van paraméter, távolítsa el az karakterét 10 az alábbiak szerint Win10 .
Módosítás előtt
<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>
↓
A javítás után
<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
Újraírja a program közzétételi beállításait is.
Nyissa meg az egyes .pubxml fájlokat a Tulajdonságok > a PublishProfiles mappában.
RuntimeIdentifier Hasonlóképpen távolítsa el az karakterét 10 a Win10 paraméterében.
Ezután építse újra és ellenőrizze, hogy nincsenek-e hibák vagy figyelmeztetések.
.pubxml (A fájlban figyelmeztetés jelenik meg, de nem kell aggódnia, mert ez a szintaxis eltér ettől a problémától.) )
Valamilyen oknál fogva azonban a WinUI osztálykönyvtár továbbra is figyelmeztet, még akkor is, ha ugyanazt csinálja, mint fent. Egyelőre futtathatja, ezért várjuk meg, amíg ez kijavításra kerül.