Начало работы с WinUI

WinUI 3 — это собственная платформа пользовательского интерфейса для создания классических приложений Windows. Это часть Windows App SDK — набор API и средств, которые отделены от самой операционной системы Windows и должны быть установлены на целевом компьютере или упаковываются вместе с приложением. WinUI 3 поддерживает как C#, так и C++ и не является кроссплатформенной или веб-платформой.

Important

WinUI 3 отличается от UWP. WinUI 3 использует пространство имен Microsoft.UI.Xaml и выполняется как настольный процесс; UWP использует пространство имен Windows.UI.Xaml и выполняется в контейнере приложения. WinUI 3 поддерживает упакованное распространение (MSIX), упакованное распространение с внешним расположением и неупакованное распространение — правильный выбор зависит от вашего сценария развертывания. Дополнительные сведения см. в разделе "Выбор метода распространения ".

Выбор пути

Для создания проекта WinUI 3 существуют два поддерживаемых пути.

	Visual Studio	Командная строка
лучше всего подходит для	Разработчики, начинающие разработку под Windows, дизайнеры визуального пользовательского интерфейса или все, кто хочет получить полноценную среду разработки	Разработчики, уверенно работающие с терминалом, конвейерами CI/CD или настройкой окружения с помощью скриптов
Инструменты	Visual Studio 2026 г. с установленными рабочими нагрузками Windows App SDK и WinUI	Пакет SDK .NET 10 с шаблонами WinUI dotnet new
Создание проекта	Мастер создания проекта — выберите шаблон «Пустое приложение, упакованное (WinUI 3 для классических приложений)»	dotnet new winui -n MyApp
Сборка и запуск	Нажмите F5 — Visual Studio выполняет сборку, подписывает, развертывает пакет MSIX и запускает приложение.	dotnet run — создает и запускает приложение с идентификатором пакета (требуется режим разработчика)
Debugging	Полнофункциональный отладчик Visual Studio с предварительным просмотром XAML в реальном времени	Присоединение отладчика вручную или открытие созданного .sln в Visual Studio

Оба пути создают эквивалентные проекты WinUI 3. При использовании Visual Studio подписание и развертывание MSIX выполняются автоматически. Вариант с командной строкой использует dotnet run для локальной разработки (входящий в комплект пакет Microsoft.Windows.SDK.BuildTools.WinApp автоматически обрабатывает идентификатор отладки); для упаковки с целью распространения требуются дополнительные шаги.

Разрабатывайте с ИИ-помощником для программирования

С помощью помощника по написанию кода ИИ можно использовать любой путь разработки. Помощник может генерировать код проекта и объяснять незнакомые понятия, но вам всё равно нужно ограничить его рамками WinUI 3, собрать внесённые им изменения, проверить результат и сверить API Windows с актуальной документацией.

В руководстве по WinUI с применением ИИ описывается повторяемый рабочий процесс Запрос → Генерация → Сборка → Анализ → Проверка → Доработка. В нем также показано, как обнаружить созданный код, который смешивает WinUI 3 с UWP, WPF или другими платформами пользовательского интерфейса Windows.

Необходимые условия

Оба пути имеют одинаковые минимальные требования.

• Windows 10 версии 1809 (сборка 17763) или более поздней версии — рекомендуется Windows 11
• Режим разработчика включен на устройстве (ms-settings:developers)
• Visual Studio 2026 (путь Visual Studio) или .NET 10 SDK (путь к командной строке)

Windows App SDK является отдельной установкой от Windows. Visual Studio устанавливает его в рамках установки рабочей нагрузки. Для пути dotnet new winui командной строки шаблоны автоматически добавляют необходимые пакеты NuGet.

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

Быстрый запуск: Visual Studio

Быстрый старт: командная строка

Руководство. Создание приложения WinUI с помощью помощника по написанию кода ИИ