A WinUI használatának első lépései

A WinUI 3 egy natív felhasználói felületi keretrendszer Windows asztali alkalmazások létrehozásához. Ez a Windows App SDK része – olyan API-k és eszközök készlete, amelyek elkülönülnek a Windows operációs rendszertől, és telepíteni kell a célgépre, vagy az alkalmazás mellett csomagolva kell lenniük. A WinUI 3 támogatja a C# és a C++ verziót is, és nem platformfüggetlen vagy webalapú keretrendszer.

Important

A WinUI 3 eltér az UWP-től. A WinUI 3 a névteret Microsoft.UI.Xaml használja, és asztali folyamatként fut; Az UWP egy alkalmazástárolót használ Windows.UI.Xaml és futtat. A WinUI 3 támogatja a csomagolt (MSIX), a külső hellyel csomagolt és a csomagolatlan elosztást – a megfelelő választás az üzembe helyezési forgatókönyvtől függ. Útmutatásért tekintse meg a terjesztési módszer kiválasztása című témakört.

Az elérési út kiválasztása

WinUI 3-projekt létrehozásához két támogatott elérési út létezik.

	Visual Studio	parancssor
Legjobb	A Windows-fejlesztésben új fejlesztők, a vizuális felületet tervezők vagy bárki, aki teljes IDE-élményt szeretne	A fejlesztők kényelmesen használhatják a terminált, a CI-/CD-folyamatokat vagy a szkriptelt környezet beállítását
Eszközök	Visual Studio 2026-Windows App SDK és WinUI számítási feladatok telepítve	.NET 10 SDK-hez készült dotnet new WinUI-sablonok
Project létrehozása	Új Project varázsló – válassza a Blank App, Packaged (WinUI 3 in Desktop) sablont	dotnet new winui -n MyApp
Fordítás és futtatás	Nyomja meg az F5 billentyűt – a Visual Studio összeállítja, aláírja és telepíti az MSIX-csomagot, majd elindítja az alkalmazást	dotnet run – csomagidentitással hozza létre és indítja el az alkalmazást (fejlesztői módot igényel)
Debugging	Teljes körű Visual Studio-hibakeresés élő XAML-előnézettel	Csatoljon hibakeresőt manuálisan, vagy nyissa meg a létrehozott .sln fájlt a Visual Studióban

Mindkét útvonal egyenértékű WinUI 3-projekteket eredményez. A Visual Studio elérési út automatikusan kezeli az MSIX-aláírást és az üzembe helyezést. A parancssori útvonal a helyi fejlesztéshez használható dotnet run (a mellékelt Microsoft.Windows.SDK.BuildTools.WinApp csomag automatikusan kezeli a hibakeresési identitást); a terjesztéshez szükséges csomagolás további lépéseket igényel.

Prerequisites

Mindkét útvonalra ugyanazok a minimális követelmények vonatkoznak.

• Windows 10 1809-es (17763-es build) vagy újabb verzió – Windows 11 ajánlott
• A fejlesztői mód engedélyezve van az eszközön (ms-settings:developers)
• Visual Studio 2026 (Visual Studio elérési út) vagy .NET 10 SDK (parancssori útvonal)

A Windows App SDK a Windowstól külön telepíthető. Visual Studio telepíti a számítási feladat beállítása részeként. A parancssori útvonalhoz a dotnet new winui sablonok automatikusan beviszik a szükséges NuGet-csomagokat.

Következő lépések

Rövid útmutató: Visual Studio

Gyors kezdés: Parancssor