Rövid útmutató: Az első WinUI 3-alkalmazás létrehozása

Hozza létre, fordítsa le és futtassa az első WinUI 3-alkalmazást. A vizuális tervező támogatását is nyújtó, teljes körű IDE-élményért válassza a Visual Studio-t, vagy használja a dotnet new parancsot, ha bármely szerkesztőben a parancssorból szeretne dolgozni. Az alábbi fülekkel válthat a két megközelítés között.

Visual Studio

A fejlesztési környezet beállítása

A WinUI 3-alkalmazások Visual Studio való fejlesztéséhez engedélyezni kell a szükséges számítási feladatokat és a fejlesztői módot engedélyező Visual Studio 2026-ot.

Beállítás a WinGet használatával (ajánlott)

Nyissa meg a Windows terminál, és futtassa a következő parancsot a PowerShellben a Visual Studio 2026 automatikus telepítéséhez a szükséges számítási feladatokkal, és engedélyezze a fejlesztői módot WinGet-konfigurációs fájl használatával:

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

A konfigurációs fájl áttekintéséhez és további információkért tekintse meg a README GitHub.

Note

Ha a WinGet nem érhető el a környezetben, telepítse először:

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

További információt a WinGet használata című témakörben talál.

Manuális beállítás

Ha inkább manuálisan szeretné telepíteni az eszközöket:

1. Fejlesztői mód engedélyezése: nyissa meg a Windows beállításokat, lépjen a System > Advanced elemre, és állítsa be afejlesztői módot.

2. Töltse le és telepítse a 2026-os Visual Studio. Részletekért lásd: Install Visual Studio.

3. A Visual Studio Telepítőben válassza ki a WinUI-alkalmazásfejlesztési számítási feladatot a Számítási feladatok lapon. C++ fejlesztéshez válassza a C++ WinUI alkalmazásfejlesztési eszközöket is a számítási feladat alatt a Telepítés részletei panelen.

   

Jótanács

Ha nem látja a WinUI-sablonokat a Visual Studio telepítése után, nyissa meg a Visual Studio Telepítőt, válassza a Modify lehetőséget, és ellenőrizze a WinUI-alkalmazásfejlesztést számítási feladat be van jelölve. A telepítés módosítása után indítsa újra Visual Studio.

Az első WinUI 3-alkalmazás létrehozása és elindítása

1. Nyissa meg a Visual Studio 2026-ot, és válassza az Új projekt létrehozása lehetőséget.

2. Keresse meg a WinUI-t, válassza a WinUI Blank App (Csomagolt) C# projektsablont, és válassza a Tovább lehetőséget.

   

3. Adjon meg egy project nevet, és válassza a Create lehetőséget.

   

4. Az alkalmazás létrehozásához és futtatásához nyomja le a Start (F5) billentyűt.

   

   Az alkalmazás hibakeresési módban készít, telepít és indít el:

   

   Elkészítette és elindította első WinUI 3-alkalmazását! 🎉

parancssori sor

Prerequisites

• Windows 10 1809-es (17763-es build) vagy újabb verzió
• Fejlesztői mód engedélyezve (ms-settings:developers)
• .NET 10 SDK vagy újabb (ellenőrizhető a(z) dotnet --version paranccsal)

Az első WinUI 3-alkalmazás létrehozása és futtatása

1. Telepítse a(z) dotnet new WinUI 3 projektsablonjait (egyszer futtassa):

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

2. Hozzon létre egy új projektet, és navigáljon bele:

   dotnet new winui -n MyWinUIApp
   cd MyWinUIApp
   

3. A projekt létrehozása:

   dotnet build
   

4. Futtassa az alkalmazást:

   dotnet run
   

   A sablon tartalmazza a Microsoft.Windows.SDK.BuildTools.WinApp elemet, amely a hibakeresési identitás regisztrálásához és az alkalmazás MSIX-csomagidentitással történő elindításához a .NET CLI run célhoz kapcsolódik — nincs szükség kézi üzembe helyezési lépésre.

   Megnyílik egy üres alkalmazásablak. Elkészítette és elindította első WinUI 3-alkalmazását! 🎉

Hibaelhárítás

Ha problémákba ütközik az első alkalmazás létrehozásakor vagy futtatásakor, próbálkozzon az alábbi gyakori javításokkal:

Probléma	Solution
A WinUI-sablonok nem jelennek meg a Visual Studio	Nyissa meg a Visual Studio telepítőt, válassza a Módosítás lehetőséget, és ellenőrizze, hogy a WinUI-alkalmazásfejlesztési számítási feladat be van-e jelölve. A telepítés módosítása után indítsa újra Visual Studio. A részletekért tekintse meg a fejlesztési környezet beállítása című témakört.
A buildelés SDK-verzióhibákkal meghiúsul	Nyissa meg a Visual Studio Telepítőt, és válassza ki az egyes összetevőket. Ellenőrizze, hogy telepítve van-e a projektcélok Windows SDK-verziója. A projektfájlban ellenőrizze, hogy egyezik-e TargetFramework a telepített SDK-val (például net10.0-windows10.0.26100.0).
NuGet-visszaállítási hibák	Törölje a helyi NuGet-gyorsítótárat, és állítsa vissza újra. Egy terminálban futtassa a következőt: dotnet nuget locals all --clear .dotnet restore
"A fejlesztői mód nincs engedélyezve" hiba	Nyissa meg a Windows beállításaiban a Rendszer > Speciális menüt, és állítsa a Fejlesztői módotBe értékre. További információt a Fejlesztői mód engedélyezése című témakörben talál.
Az SDK első telepítése után nem felismert módosítások	A Windows App SDK vagy Visual Studio számítási feladatok első telepítése vagy frissítése után indítsa újra a Visual Studio, hogy felvegye az új összetevőket.

Jótanács

Ha a fentiek egyike sem oldja meg a problémáját, keressen rá a Windows App SDK GitHub issues között, vagy tegyen fel kérdést a Microsoft Q&A oldalon.

Következő lépések

Az első WinUI-alkalmazás létrehozása
Készen áll a továbblépésre? Kövesse a részletes oktatóanyagot egy teljes WinUI-alkalmazás létrehozásához.

WinUI 3 katalógus
Interaktív példák a WinUI-vezérlőkre, funkciókra és szolgáltatásokra.

Minták és erőforrások
A fejlesztés felgyorsításához böngészhet a kódmintákban, a kezdőprojektekben és az eszközökben.