Hızlı başlangıç: İlk WinUI 3 uygulamanızı oluşturma

İlk WinUI 3 uygulamanızı oluşturun, derleyin ve çalıştırın. Görsel tasarımcı desteğiyle tam IDE deneyimi için Visual Studio veya herhangi bir düzenleyicideki komut satırından çalışmak için yeni dotnet'i seçin. İki yaklaşım arasında geçiş yapmak için aşağıdaki sekmeleri kullanın.

Visual Studio

Geliştirme ortamınızı ayarlama

Visual Studio ile WinUI 3 uygulamaları geliştirmek için gerekli iş yükleri ve Geliştirici Modu etkinleştirilmiş Visual Studio 2026 gerekir.

WinGet ile ayarlama (önerilir)

gerekli iş yükleriyle Visual Studio 2026'yı otomatik olarak yüklemek ve WinGet Yapılandırma dosyası kullanarak Geliştirici Modu'nu etkinleştirmek için Windows Terminal açın ve PowerShell'de aşağıdaki komutu çalıştırın:

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

Yapılandırma dosyasını gözden geçirmek ve daha fazla bilgi edinmek için GitHub'da README bölümüne bakın.

Note

WinGet ortamınızda kullanılamıyorsa önce yükleyin:

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

Daha fazla bilgi için bkz. WinGet kullanma .

El ile ayarlama

Araçları el ile yüklemeyi tercih ediyorsanız:

1. Geliştirici Modunu Etkinleştir: Windows Ayarları'nı açın, Sistem > Gelişmiş'e gidin ve Geliştirici Modu'nuAçık konumuna getirin.

2. Visual Studio 2026'yi indirin ve yükleyin. Ayrıntılar için bkz. Visual Studio yükleme.

3. Visual Studio Yükleyicisi'nde İş Yükleri sekmesinde WinUI uygulama geliştirme iş yükünü seçin. C++ geliştirmesi için, Yükleme ayrıntıları bölmesinde bu iş yükünün altında C++ WinUI uygulama geliştirme araçları'nı da seçin.

   

Tip

Visual Studio yükledikten sonra WinUI şablonlarını görmüyorsanız Visual Studio Yükleyicisi'ni açın, Modify öğesini seçin ve WinUI uygulama geliştirme iş yükünün denetlendiğini onaylayın. Yüklemeyi değiştirdikten sonra Visual Studio yeniden başlatın.

İlk WinUI 3 uygulamanızı oluşturma ve başlatma

1. Visual Studio 2026'yi açın ve Yeni proje oluştur'u seçin.

2. WinUI'yi arayın, WinUI Boş Uygulaması (Paketlenmiş) C# proje şablonunu seçin ve İleri'yi seçin.

   

3. Bir proje adı girin ve Oluştur'u seçin.

   

4. Uygulamanızı derlemek ve çalıştırmak için Başlat (F5) tuşuna basın.

   

   Uygulamanız hata ayıklama modunda derlenir, dağıtılır ve başlatılır:

   

   İlk WinUI 3 uygulamanızı oluşturdunuz ve başlattınız! 🎉

Komut satırı

Prerequisites

• Windows 10 sürüm 1809 (derleme 17763) veya üzeri
• Geliştirici Modu etkin (ms-settings:developers)
• .NET 10 SDK veya üzeri (dotnet --version ile doğrulayın)

İlk WinUI 3 uygulamanızı oluşturma ve çalıştırma

1. için dotnet new WinUI 3 proje şablonlarını yükleyin (bir kez çalıştırın):

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

2. Yeni bir proje oluşturun ve bu projeye gidin:

   dotnet new winui -n MyWinUIApp
   cd MyWinUIApp
   

3. Projeyi oluşturun:

   dotnet build
   

4. Uygulamayı çalıştırın:

   dotnet run
   

   Şablon, .NET CLI Microsoft.Windows.SDK.BuildTools.WinApp hedefine bağlanan run öğesini içerir; bu öğe, bir hata ayıklama kimliği kaydetmeyi ve uygulamayı MSIX paket kimliğiyle başlatmayı sağlar; manuel dağıtım adımı gerekmez.

   Boş bir uygulama penceresi açılır. İlk WinUI 3 uygulamanızı oluşturdunuz ve başlattınız! 🎉

Sorun giderme

İlk uygulamanızı oluştururken veya çalıştırırken sorunlarla karşılaşırsanız şu yaygın düzeltmeleri deneyin:

Sorun	Çözüm
WinUI şablonları Visual Studio'da görünmüyor	Visual Studio Yükleyicisi'ni açın, Değiştir'i seçin ve WinUI uygulama geliştirme iş yükünün işaretli olduğunu onaylayın. Yüklemeyi değiştirdikten sonra Visual Studio yeniden başlatın. Ayrıntılar için Geliştirme ortamınızı ayarlama makalesindeki ipucuna bakın.
Derleme SDK sürümü hatalarıyla başarısız oluyor	Visual Studio Yükleyicisi'ni açın ve Tek tek bileşenler'i seçin. Proje hedeflerinizin Windows SDK sürümünün yüklü olduğunu doğrulayın. Proje dosyanızda, yüklü SDK ile eşleşdiğini TargetFramework onaylayın (örneğin, net10.0-windows10.0.26100.0).
NuGet geri yükleme hataları	Yerel NuGet önbelleğini temizleyin ve yeniden geri yükleyin. Terminalde şunu çalıştırın: dotnet nuget locals all --clear then dotnet restore.
"Geliştirici Modu etkinleştirilmedi" hatası	Windows Ayarlar >Sistem > Gelişmiş'i açın ve Geliştirici Modu'nuAçık konuma getirin. Daha fazla bilgi için bkz. Geliştirici Modunu Etkinleştirme .
İlk SDK yüklendikten sonra değişiklikler tanınmıyor	Windows Uygulama SDK'sı veya Visual Studio iş yüklerini ilk kez yükledikten veya güncelleştirdikten sonra yeni bileşenleri alması için Visual Studio yeniden başlatın.

Tip

Yukarıdakilerden hiçbiri sorununuzu çözmezse, Windows Uygulama SDK'sı GitHub sorunlarını arayın veya Microsoft Soru-Cevap'ta sorun A.

Sonraki adımlar

İlk WinUI uygulamanızı oluşturma
Daha ileri gitmeye hazır mısınız? Tam bir WinUI uygulaması oluşturmak için adım adım öğreticiyi izleyin.

WinUI 3 Galerisi
WinUI denetimlerinin, özelliklerinin ve işlevselliğinin etkileşimli örneklerini keşfedin.

Örnekler ve kaynaklar
Geliştirmenizi hızlandırmak için kod örneklerine, başlangıç projelerine ve araçlara göz atın.