Краткое руководство: Настройка окружения и создание проекта WinUI 3

В этом кратком руководстве описано, как настроить среду разработки WinUI и Windows App SDK и создать свое первое приложение. Дополнительные сведения о том, как Visual Studio и его шаблоны поддерживают разработку WinUI, см. обзор Visual Studio. Для разработки приложений WinUI необходимо:

• Visual Studio 2026 с необходимыми рабочими нагрузками для WinUI и Windows App SDK
• Режим разработчика включен на устройстве

Настройка среды разработки

Конфигурация WinGet

Откройте Windows Terminal и выполните следующую команду в PowerShell, чтобы автоматически настроить среду с помощью файла конфигурации WinGet. Это приведет к следующему:

• Установите Visual Studio 2026 с необходимыми рабочими нагрузками
• Включение режима разработчика

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

Чтобы просмотреть файл конфигурации и узнать больше, ознакомьтесь с README на GitHub.

Установка вручную

Включение режима разработчика

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

Чтобы включить режим разработчика, выполните приведенные действия.

• Откройте параметры Windows и перейдите на страницу System > Advanced.
• Переключите режим разработчика на включено и подтвердите выбор в диалоговом окне подтверждения.

Установка Visual Studio и необходимых рабочих нагрузок WinUI и Windows App SDK

Скачайте и установите последнюю Visual Studio, используя приведенную ниже ссылку. Дополнительные сведения см. в разделе Install Visual Studio.

Download Visual Studio

Необходимые рабочие нагрузки и компоненты

В установщике Visual Studio выберите следующие рабочие нагрузки на вкладке Workloads. Если Visual Studio уже установлен, откройте установщик и выберите Modify, чтобы добавить их.

• Для разработки приложений C# с помощью Windows App SDK выберите Разработка приложенийWinUI.

• Для разработки приложений C++ выберите средства разработки приложений WinUI C++ в узле разработки приложений WinUI в области сведений об установке (это также будет выбирать все дополнительные необходимые компоненты.)

Создание и запуск первого приложения WinUI

1. Откройте Visual Studio и выберите Create новый проект.

2. Найдите WinUI, выберите шаблон проекта C# " Пустое приложение WinUI" (Упаковано) и нажмите кнопку "Далее".

   

3. Введите имя проекта и нажмите кнопку "Создать".

   

4. Нажмите клавишу START (F5), чтобы создать и запустить приложение.

   

   Ваше приложение собирается, разворачивается и запускается в режиме отладки:

   

   Вы создали и запустили свое первое приложение WinUI! 🎉

Дальнейшие действия

Создание первого приложения WinUI
Готовы идти дальше? Выполните пошаговые инструкции по созданию полного приложения WinUI.

Коллекция WinUI 3
Ознакомьтесь с интерактивными примерами элементов управления, функций и функций WinUI.

Примеры и ресурсы
Просмотрите примеры кода, начальные проекты и средства для ускорения разработки.