Aracılığıyla paylaş

UWP için WinUI 2 ile çalışmaya başlama

WinUI 2.8 , üretim UWP uygulamaları (ve XAML Adaları kullanan masaüstü uygulamaları) oluşturmak için kullanılabilecek en son kararlı WinUI sürümüdür.

Kitaplık, herhangi bir yeni veya mevcut Visual Studio projesine eklenebilen bir NuGet paketi olarak kullanılabilir.

Uyarı

WinUI 3'ün en son sürümüyle Windows masaüstü uygulamaları oluşturma hakkında daha fazla bilgi için bkz. WinUI 3.

UWP geliştirmesi için Visual Studio'yu ayarlama

Visual Studio 2022'yi indirin ve UWP geliştirme araçlarını yükleyin. Daha ayrıntılı yönergeler için bkz. Visual Studio belgelerinde UWP uygulaması oluşturma .

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

  • WinUI uygulama geliştirme iş yükünü seçin. Ardından, Yükleme ayrıntıları bölmesinde, WinUI uygulama geliştirme düğümü altında, ihtiyacınız olan UWP seçeneğini belirleyin (bu işlem gerekli ek bileşenleri de seçer.):

    • C# için Evrensel Windows Platformu araçları'nı seçin.
    • C++ için C++ (v14x) Evrensel Windows Platformu araçlarını seçin (önceki bir sürümü kullanmak için belirli bir nedeniniz yoksa en son sürümü seçin).

Uyarı

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

WinUI'yi indirme ve yükleme

  1. Var olan bir projeyi açın veya Visual C# > Windows > Evrensel altındaki Boş Uygulama şablonunu veya dil projeksiyonunuz için uygun şablonu kullanarak yeni bir proje oluşturun.

    Önemli

    WinUI 2.8'i kullanmak için, proje özelliklerinde TargetPlatformVersion >= 10.0.18362.0 ve TargetPlatformMinVersion >= 10.0.17763.0 değerini ayarlamanız gerekir.

  2. Çözüm Gezgini panelinde projenizin adına sağ tıklayın ve NuGet Paketlerini Yönetseçin.

    Proje sağ tıklanmış ve NuGet Paketlerini Yönet seçeneğinin vurgulandığı Çözüm Gezgini panelinin ekran görüntüsü.
    Projenin sağ tıklandığı ve NuGet Paketlerini Yönet seçeneğinin vurgulandığı Çözüm Gezgini paneli.

  3. NuGet Paket Yöneticisi'nde Gözat sekmesini seçin ve Microsoft.UI.Xaml veya WinUIarayın. Kullanmak istediğiniz WinUI NuGet Paketlerini seçin ( Microsoft.UI.Xaml paketi tüm uygulamalar için uygun Fluent denetimleri ve özellikleri içerir). Yükle'ye tıklayın.

    Deneysel yeni özellikler içeren en son yayın öncesi sürümleri görmek için "Ön sürümü dahil et" onay kutusunu işaretleyin.

    Arama alanında win u i ve Ön sürümü ekle seçeneğinin işaretli olduğu Gözat sekmesini gösteren NuGet Paket Yöneticisi iletişim kutusunun ekran görüntüsü.
    NuGet Paket Yöneticisi iletişim kutusunda, arama alanında "winui" yazılı Gezin sekmesi ve ön sürümü ekle seçeneği işaretli.

  4. WinUI Tema Kaynaklarını App.xaml dosyanıza ekleyin.

    Ek uygulama kaynaklarınız olup olmadığına bağlı olarak bunu yapmanın iki yolu vardır.

    a. Başka uygulama kaynaklarına ihtiyacınız yoksa, aşağıdaki örnekte gösterildiği gibi WinUI kaynakları öğesini XamlControlsResources ekleyin:

    <Application
    x:Class="ExampleApp.App"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    RequestedTheme="Light">

    <Application.Resources>
        <XamlControlsResources xmlns="using:Microsoft.UI.Xaml.Controls" />
    </Application.Resources>

</Application>

    b. Başka kaynaklarınız varsa, bunları XamlControlsResources.MergedDictionarieseklemenizi tavsiye ederiz. Bu, kaynakların geçersiz kılınmasına izin vermek için platformun XamlControlsResources kaynak sistemiyle birlikte çalışır.

    <Application
    x:Class="ExampleApp.App"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:controls="using:Microsoft.UI.Xaml.Controls"
    RequestedTheme="Light">

    <Application.Resources>
        <controls:XamlControlsResources>
            <controls:XamlControlsResources.MergedDictionaries>
                <ResourceDictionary Source="/Styles/Styles.xaml"/>
                <!-- Other app resources here -->
            </controls:XamlControlsResources.MergedDictionaries>
        </controls:XamlControlsResources>
    </Application.Resources>

</Application>

  5. WinUI paketine hem XAML sayfalarına hem de arka planda kod içeren sayfalara başvuru ekleyin.

    • XAML sayfanızda, sayfanızın en üstüne bir referans ekleyin.

      xmlns:muxc="using:Microsoft.UI.Xaml.Controls"

    • Kodunuzda (tür adlarını nitelemeden kullanmak istiyorsanız), using yönergesi ekleyebilirsiniz.

      using MUXC = Microsoft.UI.Xaml.Controls;

C++/WinRT projesi için ek adımlar

Bir C++/WinRT projesine NuGet paketi eklediğinizde, araç projenizin \Generated Files\winrt klasöründe bir projeksiyon üst bilgileri kümesi oluşturur. Bu başlık dosyalarını projenize eklemek ve böylece bu yeni türlere yapılan referansların çözülmesi için, genellikle ( pch.h) olan önceden derlenmiş başlık dosyanıza gidip bunları ekleyebilirsiniz. Aşağıda Microsoft.UI.Xaml paketi için oluşturulan üst bilgi dosyalarını içeren bir örnek verilmiştir.

// pch.h
...
#include <winrt/Microsoft.UI.Xaml.Automation.Peers.h>
#include <winrt/Microsoft.UI.Xaml.Controls.Primitives.h>
#include <winrt/Microsoft.UI.Xaml.Media.h>
#include <winrt/Microsoft.UI.Xaml.XamlTypeInfo.h>
...

Bir C++/WinRT projesine WinUI için basit destek eklemeye yönelik tam, adım adım izlenecek yol için bkz. Basit bir C++/WinRT WinUI örneği.

GitHub'da WinUI

GitHub'daki microsoft-ui-xaml deposunda hata raporlarını bekliyoruz.

  • Last updated on