Začínáme s WinUI

WinUI 3 je nativní architektura uživatelského rozhraní pro vytváření Windows desktopových aplikací. Je součástí Windows App SDK – sada rozhraní API a nástrojů, které jsou oddělené od samotného operačního systému Windows a musí být nainstalované na cílovém počítači nebo zabalené společně s vaší aplikací. WinUI 3 podporuje C# i C++ a nejedná se o multiplatformní ani webovou architekturu.

Important

WinUI 3 se liší od UPW. WinUI 3 používá obor názvů Microsoft.UI.Xaml a běží jako proces desktopové aplikace; UWP používá Windows.UI.Xaml a spouští se v kontejneru aplikace. WinUI 3 podporuje distribuci v balíčku (MSIX), distribuci v balíčku s externím umístěním a distribuci bez balíčku – správná možnost závisí na vašem scénáři nasazení. Pokyny najdete v tématu Volba metody distribuce .

Volba cesty

Existují dvě podporované cesty pro vytvoření projektu WinUI 3.

	Visual Studio	Příkazový řádek
Nejvhodnější pro	Vývojáři, kteří s vývojem pro Windows teprve začínají, návrháři vizuálních uživatelských rozhraní nebo kdokoli, kdo chce plnohodnotné prostředí IDE	Vývojáři obeznámení s terminálem, kanály CI/CD nebo skriptovaným nastavením prostředí
Nářadí	Visual Studio 2026 s nainstalovanými úlohami Windows App SDK a WinUI	SDK .NET 10 se dotnet new šablonami WinUI
Vytvoření projektu	Průvodce Nový projekt — vyberte šablonu Prázdná aplikace v balíčku (WinUI 3 pro desktopové aplikace)	dotnet new winui -n MyApp
Sestavení a spuštění	Stiskněte F5 – Visual Studio sestaví, podepíše, nasadí balíček MSIX a spustí aplikaci.	dotnet run – sestaví a spustí aplikaci s identitou balíčku (vyžaduje vývojářský režim).
Debugging	Plnohodnotný ladicí program Visual Studia se živým náhledem XAML	Ručně připojte ladicí program nebo otevřete vygenerovaný .sln v aplikaci Visual Studio

Obě cesty vytvářejí ekvivalentní projekty WinUI 3. Postup ve Visual Studiu automaticky zajišťuje podepisování a nasazení MSIX. Varianta pro příkazový řádek používá dotnet run pro lokální vývoj (přiložený balíček Microsoft.Windows.SDK.BuildTools.WinApp automaticky zajišťuje identitu pro ladění); zabalení pro distribuci vyžaduje další kroky.

Předpoklady

Obě cesty sdílejí stejné minimální požadavky.

• Windows 10 verze 1809 (build 17763) nebo novější – Windows 11 se doporučuje
• Režim vývojáře povolený na vašem zařízení (ms-settings:developers)
• Visual Studio 2026 (cesta Visual Studio) nebo .NET 10 SDK (cesta příkazového řádku)

Windows App SDK je samostatná instalace od Windows. Visual Studio ji nainstaluje jako součást nastavení úloh. Pro postup pomocí příkazového řádku šablony dotnet new winui automaticky přidají požadované balíčky NuGet.

Další kroky

Rychlý úvod: Visual Studio

Rychlý start: Příkazový řádek