WinUI

Připravte se na vývoj s WinUI 3

Stránky aktualizovány :
Datum vytvoření stránky :

Provozní prostředí

Windows
  • Systém Windows 11
Visual Studio
  • Visual Studio 2022 Verze 17.9.3
.SÍŤ
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
Windows App SDK
  • 1.4.230913002

Požadavky

V některých případech mohou fungovat i nižší verze.

Windows
  • Systém Windows 10
  • Systém Windows 11
Visual Studio
  • Visual Studio 2022 verze 17.9.3 nebo novější
.SÍŤ
  • .NET 6
  • (.NET 8)
Windows App SDK
  • 1.4.230913002 nebo novější

Instalace sady Visual Studio a nastavení uživatelského rozhraní WinUI

Vývojové projekty WinUI 3 lze přidat pomocí instalace sady Visual Studio. Tato část obsahuje zjednodušený popis procesu instalace sady Visual Studio. Podrobné pokyny naleznete v následujících tipech.

Spusťte instalační program sady Visual Studio 2022 z internetu nebo média. Podporuje edice Community, Professional nebo vyšší.

Ve výběru úloh vyberte . NET pro desktopové aplikace.

「. NET Desktop Development a zkontrolujte Šablony C# sady Windows App SDK z Podrobnosti o instalaci vpravo.

Nyní stačí spustit instalaci. Existují i jiné obrazovky, ale nebudu je vysvětlovat, dokud nevytvoří projekt.

Po dokončení instalace vytvořte nový projekt.

V pravé horní části vyhledávací položky winui je a, takže když ji vyberete, zobrazí se šablona projektu WinUI 3, takže vyberte libovolnou šablonu a vytvořte projekt.

Nyní můžete vyvíjet aplikace pomocí WinUI 3.

Pokud se zobrazí "Cílení na verzi .NET, která není nainstalovaná"

Od verze 17.9.1 Visual Studio 2022 cílí .NET pro WinUI 3 na .NET 6. Pokud v sadě Visual Studio 2022 nevyberete žádné další moduly runtime, nainstaluje se jenom modul runtime .NET 8 a může se zobrazit upozornění podobné následujícímu.

Pokud máte obavy, můžete nainstalovat modul runtime .NET 6 nebo upozornění zavřít. K ladění nemusíte instalovat modul runtime .NET 6.

Pokud chcete později přidat vývojové prostředí WinUI 3

Pokud nejprve nainstalujete Visual Studio, můžete později přidat vývojové prostředí WinUI 3.

Spusťte Visual Studio a v nabídce vyberte Nástroje > Získat nástroje a funkce.

Zobrazí se stejná obrazovka jako při instalaci sady Visual Studio, takže můžete použít rozhraní . Ujistěte se, že je zaškrtnuté políčko ".NET Desktop Development" a v části "Podrobnosti o instalaci" na pravé straně zaškrtněte políčko "Šablona C# sady Windows App SDK".

Povolit vývojářský režim

Aplikace WinUI běží na rozdíl od jiných desktopových aplikací v prostředí s vylepšeným zabezpečením. Proto jej nelze spustit tak, jak je. Když se jej pokusíte spustit, zobrazí se dialogové okno podobné tomu níže a budete vyzváni k povolení "Vývojářského režimu". Pokud kliknete na odkaz, zobrazí se obrazovka nastavení, proto prosím povolte "Režim vývojáře".

I v případě, že nepoužíváte Visual Studio, můžete také povolit nebo zakázat "Vývojářský režim" na obrazovce nastavení. Vyberte "Nastavení" z nabídky Start.

V nabídce Systém vyberte Pro vývojáře.

K dispozici je přepínač pro "Pro vývojáře", takže jej nastavte na "Zapnuto". Zobrazí se poznámka, takže vyberte "Ano" a povolte ji.

Pokud chcete přejít na .NET 8

Pokud vytvoříte projekt s touto šablonou, bude ve výchozím nastavení .NET 6. I když změním cílovou architekturu na .NET 8 z vlastností projektu, sestavení stále zobrazuje chyby a upozornění. Kolem 13. 3. 2024 se ale sada Windows App SDK aktualizuje tak, aby oficiálně podporovala .NET 8.

Šablona je ale stále v .NET 6, takže po vytvoření projektu budete muset pracovat na .NET 8. Je možné, že bude podporován v budoucích upgradech verzí.

Nejprve vytvořte projekt a pak pomocí NuGetu aktualizujte verze související se sadou Windows App SDK.

Pokud není uvedeno jinak, je vše aktuální. Microsoft.WindowsAppSDK musí být alespoň 1.5.XXXX.

Změňte cílovou architekturu na .NET 8 z vlastností projektu.

I v případě, že sestavíte v tomto stavu, zobrazí se chyba, protože nastavení projektu je zastaralé.

Otevřete soubor projektu jako kód.

RuntimeIdentifiersVzhledem k tomu, že existuje parametr, odstraňte znak 10 následujícím Win10 způsobem.

Před úpravou

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

↓

Po opravě

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

Přepíše také nastavení publikování programu. Otevřete každý .pubxml soubor ve složce Vlastnosti > PublishProfiles.

Podobně RuntimeIdentifier odstraňte znak of 10 v Win10 parametru .

Poté znovu sestavte a ověřte, zda nedošlo k žádným chybám nebo upozorněním. .pubxml (V souboru se zobrazí upozornění, ale nemusíte si s ním dělat starosti, protože se jedná o jinou syntaxi než tento problém.) )

Z nějakého důvodu však knihovna tříd WinUI nadále varuje, i když uděláte to samé, co je uvedeno výše. Prozatím jej můžete spustit, takže počkejme, až to bude opraveno.