Rychlý start: Vytvoření první aplikace WinUI 3

Vytvořte, sestavte a spusťte svou první aplikaci WinUI 3. Zvolte Visual Studio pro úplné prostředí IDE s podporou vizuálního návrháře nebo dotnet new pro práci z příkazového řádku v libovolném editoru. Mezi těmito dvěma přístupy můžete přepínat pomocí karet níže.

Visual Studio

Nastavení vývojového prostředí

Pokud chcete vyvíjet aplikace WinUI 3 s Visual Studio, potřebujete Visual Studio 2026 s povolenými požadovanými úlohami a režimem vývojáře.

Nastavení pomocí WinGetu (doporučeno)

Otevřete Terminál Windows a spuštěním následujícího příkazu v PowerShellu automaticky nainstalujte Visual Studio 2026 s požadovanými úlohami a povolte vývojářský režim pomocí konfiguračního souboru WinGet:

winget configure -f https://aka.ms/winui-config

Další informace o konfiguračním souboru najdete v souboru README na GitHub.

Note

Pokud winGet není ve vašem prostředí k dispozici, nainstalujte ho nejprve:

Install-Module -Name Microsoft.WinGet.Client -Force
Repair-WinGetPackageManager -AllUsers

Další informace najdete v tématu Použití winGetu .

Ruční nastavení

Pokud dáváte přednost ruční instalaci nástrojů:

1. Povolte Režim vývojáře: otevřete Nastavení systému Windows, přejděte na Systém > Upřesnit a přepněte Režim vývojáře na Zapnuto.

2. Stáhněte a nainstalujte Visual Studio 2026. Podrobnosti najdete v tématu Install Visual Studio.

3. V instalačním programu Visual Studio vyberte úlohu vývoje aplikací WinUI na kartě Úlohy. Pro vývoj v jazyce C++ také v podokně podrobností instalace vyberte nástroje pro vývoj aplikací C++ WinUI v této úloze.

   

Návod

Pokud po instalaci Visual Studio nevidíte šablony WinUI, otevřete instalační program Visual Studio, vyberte Modify a potvrďte, že je zaškrtnuté Vývoj aplikací WinUI pracovní zatížení. Po úpravě instalace restartujte Visual Studio.

Vytvoření a spuštění první aplikace WinUI 3

1. Otevřete Visual Studio 2026 a vyberte Vytvořit nový projekt.

2. Vyhledejte WinUI, vyberte šablonu projektu WinUI Prázdná aplikace (zabalená) C# a vyberte Další.

   

3. Zadejte název projektu a vyberte Vytvořit.

   

4. Stisknutím klávesy Start (F5) sestavte a spusťte aplikaci.

   

   Vaše aplikace sestavuje, nasazuje a spouští v režimu ladění:

   

   Vytvořili jste a spustili svou první aplikaci WinUI 3! 🎉

Příkazový řádek

Předpoklady

• Windows 10 verze 1809 (build 17763) nebo novější
• Povolený režim vývojáře (ms-settings:developers)
• .NET 10 SDK nebo novější (ověřte pomocídotnet --version)

Vytvoření a spuštění první aplikace WinUI 3

1. Nainstalujte šablony projektu WinUI 3 pro dotnet new (spusťte jednou):

   dotnet new install Microsoft.WindowsAppSDK.WinUI.CSharp.Templates
   

2. Vytvořte nový projekt a přejděte do něj:

   dotnet new winui -n MyWinUIApp
   cd MyWinUIApp
   

3. Sestavení projektu:

   dotnet build
   

4. Spuštění aplikace:

   dotnet run
   

   Šablona obsahuje Microsoft.Windows.SDK.BuildTools.WinApp, který se napojuje na cíl rozhraní příkazového řádku .NET run a zaregistruje identitu pro ladění a spustí aplikaci s identitou balíčku MSIX – není vyžadován žádný ruční krok nasazení.

   Otevře se prázdné okno aplikace. Vytvořili jste a spustili svou první aplikaci WinUI 3! 🎉

Řešení problémů

Pokud narazíte na problémy při sestavování nebo spouštění první aplikace, vyzkoušejte tyto běžné opravy:

Problém	Řešení
Šablony WinUI se nezobrazují v Visual Studio	Otevřete instalační program Visual Studio, vyberte Upravit a potvrďte, že je zaškrtnutá úloha vývoje aplikací WinUI. Po úpravě instalace restartujte Visual Studio. Podrobnosti najdete v tipu nastavení vývojového prostředí .
Sestavení selže s chybami verze sady SDK	Otevřete instalační program Visual Studio a vyberte jednotlivé komponenty. Ověřte, že je nainstalovaná verze sady Windows SDK, na kterou cíl projektu cílí. V souboru projektu ověřte, že TargetFramework odpovídá nainstalované sadě SDK (například net10.0-windows10.0.26100.0).
Selhání obnovení NuGet	Vymažte místní mezipaměť NuGet a obnovte ji znovu. V terminálu spusťte: dotnet nuget locals all --clear a pak dotnet restore.
Chyba Režim vývojáře není povolený	Otevřete Windows Nastavení >systému > Upřesnit a přepněte Režim vývojáře na Zapnuto. Další informace najdete v tématu Povolení vývojářského režimu .
Změny se nerozpoznaly po první instalaci sady SDK	Když poprvé nainstalujete nebo aktualizujete Windows App SDK nebo úlohy sady Visual Studio, restartujte Visual Studio, aby rozpoznalo nové komponenty.

Návod

Pokud váš problém nevyřeší žádná z výše uvedených možností, vyhledejte Windows App SDK GitHub problémy nebo se zeptejte na microsoft Q& A.

Další kroky

Vytvoření první aplikace WinUI
Jste připravení pokračovat? Podle podrobného kurzu sestavte úplnou aplikaci WinUI.

Galerie WinUI 3
Prozkoumejte interaktivní příklady ovládacích prvků, vlastností a funkčnosti WinUI.

Ukázky a zdroje informací
Projděte si ukázky kódu, počáteční projekty a nástroje, které urychlují vývoj.