WinUI

Príprava na vývoj s rozhraním WinUI 3

Stránka aktualizovaná :
Dátum vytvorenia strany :

Prevádzkové prostredie

Windows
  • Okná 11
Visual Studio
  • Visual Studio 2022 verzia 17.9.3
.SIEŤ
  • .NET 6
  • (.NET 8)
Používateľské rozhranie WinUI
  • WinUI 3
Windows App SDK
  • 1.4.230913002

Predpoklady

V niektorých prípadoch môžu fungovať aj nižšie verzie.

Windows
  • Windows 10
  • Okná 11
Visual Studio
  • Visual Studio 2022 verzie 17.9.3 alebo novšej
.SIEŤ
  • .NET 6
  • (.NET 8)
Windows App SDK
  • 1.4.230913002 alebo novší

Inštalácia Visual Studia a nastavenie WinUI

Vývojové projekty WinUI 3 je možné pridať pomocou inštalácie Visual Studio. Táto časť obsahuje zjednodušený popis procesu inštalácie Visual Studia. Podrobné pokyny nájdete v nasledujúcich tipoch.

Spustite inštalátor Visual Studio 2022 z internetu alebo médií. Podporuje komunitné, profesionálne alebo vyššie vydania.

Vo výbere vyťaženia vyberte položku . NET Vývoj desktopov.

「. NET a skontrolujte šablóny C# súpravy Windows App SDK v časti Podrobnosti o inštalácii vpravo.

Teraz už len spustite inštaláciu. Existujú aj iné obrazovky, ale nebudem ich vysvetľovať, kým nevytvoria projekt.

Po dokončení inštalácie vytvorte nový projekt.

V pravom hornom rohu winui je položka vyhľadávania, takže keď ju vyberiete, zobrazí sa šablóna projektu WinUI 3, takže vyberte ľubovoľnú šablónu a vytvorte projekt.

Teraz môžete vyvíjať aplikácie pomocou WinUI 3.

Ak sa zobrazí "Zacielenie na verziu .NET, ktorá nie je nainštalovaná"

Od verzie 17.9.1 Visual Studio 2022 sa .NET for WinUI 3 zameriava na .NET 6. Ak v aplikácii Visual Studio 2022 nevyberiete žiadne ďalšie moduly runtime, nainštaluje sa iba modul runtime .NET 8 a môže sa zobraziť upozornenie, ako je uvedené nižšie.

Ak máte obavy, môžete nainštalovať modul runtime .NET 6 alebo upozornenie jednoducho zrušiť. Na ladenie nie je potrebné inštalovať modul runtime .NET 6.

Ak chcete neskôr pridať vývojové prostredie WinUI 3

Ak najskôr nainštalujete Visual Studio, môžete neskôr pridať vývojové prostredie WinUI 3.

Spustite Visual Studio a v ponuke vyberte položku Nástroje > Získať nástroje a funkcie.

Zobrazí sa rovnaká obrazovka ako pri inštalácii Visual Studia, takže môžete použiť . Uistite sa, že je začiarknutá možnosť ".NET Desktop Development" a začiarknite políčko "Windows App SDK C# Template" v časti "Podrobnosti o inštalácii" na pravej strane.

Povoliť režim vývojára

Aplikácie WinUI bežia v prostredí s vylepšeným zabezpečením na rozdiel od iných desktopových aplikácií. Preto ho nemožno spustiť tak, ako je. Keď sa ho pokúsite spustiť, zobrazí sa dialógové okno podobné nižšie a zobrazí sa výzva na povolenie "Režim vývojára". Ak kliknete na odkaz, zobrazí sa obrazovka nastavenia, preto povoľte "Režim vývojára".

Aj keď nepoužívate Visual Studio, môžete tiež povoliť alebo zakázať "Režim vývojára" na obrazovke nastavení. V ponuke Štart vyberte "Nastavenia".

V ponuke Systém vyberte položku Pre vývojárov.

K dispozícii je prepínač pre "Pre vývojárov", takže ho nastavte na "Zapnuté". Zobrazí sa poznámka, takže ju povolíte výberom možnosti "Áno".

Ak chcete prejsť na .NET 8

Ak vytvoríte projekt s touto šablónou, predvolene sa použije .NET 6. Aj keď zmením cieľovú architektúru na .NET 8 z vlastností projektu, zostava stále zobrazuje chyby a upozornenia. Približne 13. 3. 2024 sa však súprava Windows App SDK aktualizuje tak, aby oficiálne podporovala .NET 8.

Šablóna je však stále v .NET 6, takže po vytvorení projektu budete musieť pracovať na .NET 8. Môže existovať možnosť, že bude podporovaný v budúcich aktualizáciách verzií.

Najprv vytvorte projekt a potom pomocou NuGet aktualizujte verzie súvisiace so súpravou Windows App SDK.

Ak nie je inak, všetko je aktuálne. Microsoft.WindowsAppSDK musí byť aspoň 1.5.XXXX.

Zmeňte cieľovú architektúru na .NET 8 z vlastností projektu.

Aj keď zostavíte v tomto stave, zobrazí sa chyba, pretože nastavenia projektu sú zastarané.

Otvorte súbor projektu ako kód.

RuntimeIdentifiersKeďže existuje parameter, odstráňte znak 10 nasledovne Win10 .

Pred úpravou

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

↓

Po oprave

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

Prepíše tiež nastavenia publikovania programu. Otvorte každý .pubxml súbor v priečinku Vlastnosti > PublishProfiles.

Podobne RuntimeIdentifier odstráňte znak v 10 Win10 parametri .

Potom znova zostavte a overte, či neexistujú žiadne chyby alebo upozornenia. .pubxml (V súbore sa zobrazí upozornenie, ale nemusíte sa ho obávať, pretože ide o inú syntax ako tento problém.) )

Z nejakého dôvodu však knižnica tried WinUI naďalej varuje, aj keď urobíte to isté ako vyššie. Zatiaľ ho môžete spustiť, takže počkajme, kým sa to nevyrieši.