WinUI için kurulum ve araçlar

Windows uygulama geliştirmeye hoş geldiniz. Bu kılavuz, WinUI ile ilk uygulamanızı oluşturmaya başlamak için gereken adımlarda size yol gösterir. Ayrıca Windows geliştirme hakkında daha fazla bilgi edinmenize yardımcı olacak kaynaklara da işaret eder.

1. Geliştirici Modunu Etkinleştirme

Windows, üzerinde çalıştığınız uygulamaları çalıştırabilmeniz için güvenlik ayarlarını yapan geliştiriciler için özel bir moda sahiptir. Visual Studio kullanarak uygulamanızı derlemeden, dağıtmadan ve test etmeden önce Geliştirici Modu'nu etkinleştirmeniz gerekir.

Tavsiye

Geliştirici Modu'nu şimdi etkinleştirmezseniz, uygulamanızı derlemeye çalıştığınızda Visual Studio bunu etkinleştirmenizi ister.

Geliştirici Modunu etkinleştirmek için:

• Windows Ayarları'nı açın ve Sistem > Gelişmiş sayfasına gidin.
• Geliştirici Modu anahtarını Açık duruma getirin ve onay iletişim kutusunda seçiminizi onaylayın.

Geliştirici Modu hakkında daha fazla bilgi için bkz. Geliştiriciler için ayarlar.

2. Visual Studio'yu ve gerekli iş yüklerini yükleme

WinUI uygulamanızı derlemek, hatalarını ayıklamak ve dağıtmak için Microsoft'un güçlü IDE'si Visual Studio'yu kullanın. Hızlı bir şekilde başlamanıza yardımcı olmak için Windows ve diğer platformlar için kullanıma hazır proje şablonları sunar.

Ücretsiz Visual Studio Community Edition , uygulama geliştirmek için ihtiyacınız olan her şeyi içerir. Daha büyük ekipler veya kuruluşlar Professional veya Enterprise sürümleri gerektirebilir. Daha fazla bilgi için bkz. Visual Studio nedir? ve Windows uygulama geliştirme için sistem gereksinimleri.

WinGet

Konsolda aşağıdaki komutlardan birini çalıştırarak gerekli araçları ve iş yüklerini yükleyin.
Komut, eksik iş yükleri önceden seçilmiş olan Visual Studio Yükleyicisi'ni açar; bunları yüklemek için Değiştir'i seçmeniz gerekir.

İsterseniz, bu sürümleri yüklemek için Community'yiProfessional veya Enterprise ile değiştirebilirsiniz.

C# uygulaması geliştirme için

winget install "Visual Studio Community 2022"  --override "--add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.ComponentGroup.WindowsAppSDK.Cs" -s msstore

C++ uygulama geliştirme için

winget install "Visual Studio Community 2022"  --override "--add Microsoft.VisualStudio.Workload.NativeDesktop  Microsoft.VisualStudio.ComponentGroup.WindowsAppSDK.Cpp"  -s msstore

El ile yükleme

En son Visual Studio'yu indirip yüklemek için aşağıdaki bağlantıyı kullanın. Yükleyici adımlarda size yol gösterir, ancak ayrıntılı yönergelere ihtiyacınız varsa bkz. Visual Studio'yu Yükleme.

Visual Studio'yu indirin

Gerekli iş yükleri ve bileşenler

Visual Studio'yu yüklerken, WinUI ve Windows Uygulama SDK'sı ile geliştirmek için gereken iş yüklerini ve bileşenleri yükleyin. Yüklemeden sonra Visual Studio Installer uygulamasını açıp Değiştir'i seçerek iş yüklerini ve bileşenleri ekleyebilirsiniz.

Visual Studio Yükleyicisi uygulamasının İş Yükleri sekmesinde aşağıdaki iş yüklerini ve bileşenleri seçin:

• Windows Uygulama SDK'sını kullanarak C# uygulama geliştirme için WinUI uygulama geliştirme'yi seçin.

• C++ uygulama geliştirme için, Yükleme ayrıntıları bölmesindeki WinUI uygulama geliştirme düğümü altındaki C++ WinUI uygulama geliştirme araçlarını seçin (Bu, gerekli ek bileşenleri de seçer.)

Uyarı

Visual Studio 17.10 - 17.12'de bu iş yükü Windows uygulama geliştirme olarak adlandırılır.

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

Visual Studio proje şablonları, uygulamanızı hızla oluşturmak için ihtiyacınız olan tüm dosyaları içerir. Aslında, projenizi bir WinUI uygulama şablonundan oluşturduktan sonra çalıştırabileceğiniz ve ardından kodunuzu ekleyebileceğiniz bir uygulamanız vardır.

WinUI C# Boş Uygulama proje şablonunu kullanarak yeni bir proje oluşturmak için:

1. Visual Studio'yu açın ve başlatma sayfasından Yeni proje oluştur'u seçin. (Visual Studio düzenleyicide zaten açıksa Dosya'yı> seçinYeni>Proje:

2. C# proje şablonunu arayıp WinUI seçinWinUI Blank App (Packaged), ardından İleri: seçin

3. Bir proje adı belirtin ve oluştur'u seçin. İsteğe bağlı olarak bir çözüm adı ve dizini belirtebilir veya varsayılan değerleri bırakabilirsiniz. Bu görüntüde Hello World proje, içinde Hello Worldbulunan bir C:\Projects\ çözüme aittir:

   Uyarı

   Sonraki adımlar bölümünde uygulamanın tamamını oluşturmak için bu projeyi kullanmak istiyorsanız, projeyi WinUINotesolarak adlandırın.

4. Projenizi derlemek ve çalıştırmak için Hata Ayıklama "Başlat" düğmesini seçin:
   
   Projeniz derlenir, yerel makinenize dağıtılır ve hata ayıklama modunda çalışır:
   

5. Hata ayıklamayı durdurmak için uygulama penceresini kapatın veya Visual Studio'da hata ayıklama "Durdur" düğmesini seçin.

Tebrikler, ilk WinUI uygulamanızı oluşturdunuz! Daha fazlasını keşfetmek için aşağıdaki adımlarla devam edin.

Sonraki adımlar

WinUI ile ilk not alma uygulamanızı oluşturma

• WinUI'nin neler sunduğu hakkında fikir edinmek için WinUI Galeri uygulamasına göz atın.

  WinUI 3 Galeri uygulaması çoğu WinUI 3 denetimi, özelliği ve işlevselliğine ilişkin etkileşimli örnekler içerir. Uygulamayı Microsoft Store'dan alın veya GitHub'dan kaynak kodunu alın

• WinUI ile ilgili temel bilgiler hakkında daha fazla bilgi edinin.
• Fluent Design ilkelerini keşfedin.
• Uygulamaları daha verimli bir şekilde geliştirmenize yardımcı olacak örnekler ve araçlar bulun.