WinUI kullanmaya başlama

WinUI 3, Windows masaüstü uygulamaları oluşturmaya yönelik yerel kullanıcı arabirimi çerçevesidir. Windows Uygulama SDK'sı bir parçasıdır; Windows işletim sisteminin kendisinden ayrı olan ve hedef makineye yüklenmesi veya uygulamanızla birlikte paketlenmiş olması gereken bir dizi API ve araç. WinUI 3 hem C# hem de C++ desteği sunar ve platformlar arası veya web tabanlı bir çerçeve değildir.

Important

WinUI 3, UWP'den farklıdır. WinUI 3, Microsoft.UI.Xaml ad alanını kullanır ve masaüstü işlemi olarak çalışır; UWP ise Windows.UI.Xaml ad alanını kullanır ve bir uygulama kapsayıcısında çalışır. WinUI 3, paketlenmiş (MSIX), dış konum ile paketlenmiş ve paketlenmemiş dağıtımı destekler; doğru seçim dağıtım senaryonuza bağlıdır. Kılavuz için bkz. Dağıtım yöntemi seçme .

Yolunuzu seçin

WinUI 3 projesi oluşturmak için desteklenen iki yol vardır.

	Visual Studio	Komut satırı
Şunun için en uygun	Windows geliştirmeye yeni başlayan geliştiriciler, görsel kullanıcı arabirimi tasarımcıları veya tam bir IDE deneyimi isteyen herkes	Geliştiriciler terminal, CI/CD işlem hatları veya betikli ortam kurulumu konusunda rahattır
Araçlar	Windows Uygulama SDK'sı ve WinUI iş yüklerinin yüklü olduğu Visual Studio 2026	.NET 10 SDK ile dotnet new WinUI şablonları
Project oluşturma	Yeni Proje sihirbazı — Boş Uygulama, Paketlenmiş (Masaüstünde WinUI 3) şablonunu seçin	dotnet new winui -n MyApp
Derle ve çalıştır	F5 tuşuna basın — Visual Studio, MSIX paketini derler, imzalar, dağıtır ve uygulamayı başlatır.	dotnet run — uygulamayı paket kimliğiyle derleyip başlatır (Geliştirici Modu gerektirir)
Debugging	XAML canlı önizlemesi ile tam Visual Studio hata ayıklayıcısı	Hata ayıklayıcıyı el ile bağlayın veya oluşturulan .sln dosyasını Visual Studio’da açın

Her iki yol da eşdeğer WinUI 3 projeleri üretir. Visual Studio yolu MSIX imzalama ve dağıtımı otomatik olarak işler. Komut satırı yolu yerel geliştirme için kullanır dotnet run (dahil edilen Microsoft.Windows.SDK.BuildTools.WinApp paket hata ayıklama kimliğini otomatik olarak işler); dağıtım için paketleme ek adımlar gerektirir.

Prerequisites

Her iki yol da aynı minimum gereksinimleri paylaşır.

• Windows 10 sürüm 1809 (derleme 17763) veya üzeri — Windows 11 önerilir
• Cihazınızda Geliştirici Modu etkinleştirildi (ms-settings:developers)
• Visual Studio 2026 (Visual Studio yolu) veya .NET 10 SDK (komut satırı yolu)

Windows Uygulama SDK'sı, Windows’tan ayrı yüklenir. Visual Studio iş yükü kurulumunun bir parçası olarak yükler. Komut satırı yolu için şablonlar dotnet new winui gerekli NuGet paketlerini otomatik olarak getirir.

Sonraki Adımlar

Hızlı başlangıç: Visual Studio

Hızlı başlangıç: Komut satırı