Udostępnij za pośrednictwem

Wprowadzenie do interfejsu WinUI 2

  • Artykuł

WinUI 2.8 to najnowsza stabilna wersja systemu WinUI, która może być używana do tworzenia produkcyjnych aplikacji platformy UWP (i aplikacji desktopowych przy użyciu wysp XAML).

Biblioteka jest dostępna jako pakiet NuGet, który można dodać do dowolnego nowego lub istniejącego projektu programu Visual Studio.

Notatka

Aby uzyskać więcej informacji na temat tworzenia aplikacji klasycznych systemu Windows przy użyciu najnowszej wersji WinUI 3, zobacz WinUI 3.

Pobieranie i instalowanie interfejsu WinUI

  1. Pobierz Visual Studio 2022 i upewnij się, że w instalatorze programu Visual Studio wybrano pakiet roboczy programowania dla platformy uniwersalnej systemu Windows.

  2. Otwórz istniejący projekt lub utwórz nowy projekt za pomocą szablonu pusta aplikacja w obszarze Visual C# —> Windows —> Universal lub odpowiedniego szablonu dla projekcji językowej.

    Ważny

    Aby użyć interfejsu WinUI 2.8, należy ustawić wartość TargetPlatformVersion >= 10.0.18362.0 i TargetPlatformMinVersion >= 10.0.17763.0 we właściwościach projektu.

  3. W panelu Eksplorator rozwiązań kliknij prawym przyciskiem myszy nazwę projektu i wybierz pozycję Zarządzaj pakietami NuGet.

    Zrzut ekranu przedstawiający panel Eksploratora rozwiązań z projektem klikniętym prawym przyciskiem myszy i wyróżnioną opcją Zarządzaj pakietami NuGet.
    Panel Eksplorator rozwiązań z projektem, na którym wykonano kliknięcie prawym przyciskiem myszy i zaznaczoną opcją Zarządzaj pakietami NuGet.

  4. W menedżera pakietów NuGetwybierz kartę Przeglądaj i wyszukaj Microsoft.UI.Xaml lub WinUI. Wybierz pakiety NuGet WinUI, których chcesz użyć (pakiet Microsoft.UI.Xaml zawiera kontrolki Fluent i funkcje odpowiednie dla wszystkich aplikacji). Kliknij przycisk Zainstaluj.

    Zaznacz pole wyboru "Uwzględnij wersję wstępną", aby wyświetlić najnowsze wersje wstępne zawierające eksperymentalne nowe funkcje.

    Zrzut ekranu przedstawiający okno dialogowe Menedżera pakietów NuGet z kartą Przeglądaj z winui w polu wyszukiwania i zaznaczoną opcją
    Okno dialogowe Menedżera pakietów NuGet z kartą Przeglądaj, polem wyszukiwania wypełnionym "winui" oraz zaznaczoną opcją "Uwzględnij wersję wstępną".

  5. Dodaj zasoby motywu WinUI do pliku App.xaml.

    Istnieją dwa sposoby, aby to zrobić, w zależności od tego, czy masz dodatkowe zasoby aplikacji.

    a. Jeśli nie potrzebujesz innych zasobów aplikacji, dodaj element resources WinUI <XamlControlsResources, jak pokazano w poniższym przykładzie:

    <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. Jeśli masz inne zasoby, zalecamy dodanie ich do XamlControlsResources.MergedDictionaries. To współpracuje z systemem zasobów platformy, aby umożliwić przesłonięcie zasobów XamlControlsResources.

    <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>

  6. Dodaj odwołanie do pakietu WinUI zarówno na stronach XAML, jak i/lub w kodzie stron.

    • Na stronie XAML dodaj odwołanie w górnej części strony

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

    • W kodzie (jeśli chcesz używać nazw typów bez ich kwalifikowania), możesz dodać dyrektywę using.

      using MUXC = Microsoft.UI.Xaml.Controls;

Dodatkowe kroki dla projektu C++/WinRT

Po dodaniu pakietu NuGet do projektu C++/WinRT narzędzie generuje zestaw nagłówków projekcji w folderze \Generated Files\winrt projektu. Aby przenieść te pliki nagłówków do projektu, aby odwołania do tych nowych typów zostały rozwiązane, możesz przejść do wstępnie skompilowanego pliku nagłówka (zazwyczaj pch.h) i dołączyć je. Poniżej znajduje się przykład zawierający wygenerowane pliki nagłówków dla pakietu Microsoft.UI.Xaml.

// 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>
...

Aby uzyskać pełny przewodnik krok po kroku dotyczący dodawania prostej obsługi interfejsu WinUI do projektu C++/WinRT, zobacz A simple C++/WinRT WinUI example.

Wkład w rozwój WinUI

Witamy raporty o błędach, wnioski o funkcje i wkład społeczności w kod w repozytorium microsoft-ui-xaml na GitHubie.

Inne zasoby

Jeśli dopiero zaczynasz korzystać z platformy UWP, zalecamy zapoznanie się ze stronami Getting Started with UWP Development (Wprowadzenie do programowania na platformie UWP) w portalu dla deweloperów.