Posted on 26. March 2019

Начало работы с Windows UI Library

Инструментарий доступен в качестве NuGet пакетов, которые можно добавить в любой существующий или новый проект, используя Visual Studio.

Загрузите и установите Windows UI Library

1. Загрузите Visual Studio 2017 и убедитесь, что Вы выбрали рабочую нагрузку разработки под универсальную Windows платформу в установщике Visual Studio.

Примечание

Visual Studio 2015 не поддерживает Windows UI Library.

2. Откройте существующий проект или создайте новый проект, используя пустой шаблон приложения в Visual C# -> Windows -> Universal, или соответствующий шаблон для языковой проекции.

Обратите внимание: для использования Windows UI Library минимальная версия Вашего проекта должна быть 14393 и выше, а целевая версия должна быть 17134 и выше.

3. На панели Solution Explorer щелкните правой кнопкой мыши на имя Вашего проекта и выберите «Управление NuGet пакетами». Выберите вкладку «Обзор» и найдите Microsoft.UI.Xaml. Затем выберите, какие NuGet пакеты Windows UI Library Вы хотите использовать.

Пакет Microsoft.UI.Xaml содержит Fluent элементы управления и функции, которые подходят для всех приложений.

При желании Вы можете выбрать опцию «Include prerelease», чтобы быть в курсе последних предварительных версий и новых функций.

4. Добавьте Windows UI (WinUI) Theme Resources в Ваши App.xaml ресурсы. Существует два способа, в зависимости от того, есть ли у Вас дополнительные ресурсы приложения.

а. Если у Вас нет других ресурсов приложения, добавьте

в Ваши Application.Resources:

 

    

    
        
    

 

б. В противном случае, если у Вас несколько наборов ресурсов приложения, добавьте в Application.Resources.MergedDictionaries:

 

 
   
    
        
            
                
             
        
    
   

 

5. Добавьте ссылку на инструментарий на XAML страницы и на страницы с фоновым кодом.

На Вашей XAML странице добавьте ссылку в самом верху.

XAML: xmlns:controls="using:Microsoft.UI.Xaml.Controls"

В коде (если Вы хотите использовать имена типов без их определения), Вы можете добавить директиву using.

C#: using MUXC = Microsoft.UI.Xaml.Controls;

Дополнительные шаги для C++/WinRT проектов

Когда Вы добавляете NuGet пакет в C++/WinRT проект, этот инструмент генерирует набор заголовков проекции в папке \Generated Files\winrt Вашего проекта. Чтобы добавить эти заголовки в Ваш проект, так чтобы ссылки на эти новые типы разрешались, Вы можете зайти в Ваш pch.h файл и добавить их. Ниже приведен пример, включающий сгенерированные файлы заголовков для 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"

 

Вклад в Windows UI Library

WinUI - это проект с открытым исходным кодом, размещенный на GitHub. 

Вы можете делиться Вашими сообщениями об ошибках, запросами функций и делать вклад в код сообщества в репозитории Windows UI Library.

Другие источники

Если Вы новичок в UWP разработке, посетите страницы «Начало работы с UWP разработкой» на портале для разработчиков.