WinUI

Подготовка к разработке с помощью WinUI 3

Страница обновлена :
Дата создания страницы :

Операционная среда

Виндоус
  • Windows 11
Визуальная студия
  • Visual Studio 2022 версии 17.9.3
.СЕТЬ
  • .NET 6
  • (.NET 8)
Интерфейс WinUI
  • Интерфейс WinUI 3
Пакет SDK для приложений для Windows
  • 1.4.230913002

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

В некоторых случаях могут подойти и более ранние версии.

Виндоус
  • Windows 10
  • Windows 11
Визуальная студия
  • Visual Studio 2022 версии 17.9.3 или более поздней
.СЕТЬ
  • .NET 6
  • (.NET 8)
Пакет SDK для приложений для Windows
  • 1.4.230913002 или более поздняя версия

Установка Visual Studio и настройка WinUI

Проекты разработки WinUI 3 можно добавить с помощью установки Visual Studio. В этом разделе представлено упрощенное описание процесса установки Visual Studio. Для получения подробных инструкций, пожалуйста, обратитесь к следующим советам.

Запустите установщик Visual Studio 2022 из Интернета или мультимедиа. Он поддерживает версии Community, Professional и выше.

В окне выбора рабочей нагрузки выберите . NET Настольная разработка.

「. NET и проверьте шаблоны C# пакета SDK для приложений для Windows в разделе Сведения об установке справа.

Теперь просто начните установку. Есть и другие экраны, но я не буду их объяснять, пока они не создадут проект.

После завершения установки создайте новый проект.

В правом верхнем углу есть пункт winui поиска, поэтому при его выборе будет отображаться шаблон проекта WinUI 3, поэтому выбирайте любой шаблон и создавайте проект.

Теперь вы можете разрабатывать приложения с помощью WinUI 3.

Если вы видите сообщение "Таргетинг на версию .NET, которая не установлена"

Начиная с версии 17.9.1 Visual Studio 2022, .NET для WinUI 3 предназначена для .NET 6. Если вы не выберете дополнительные среды выполнения в Visual Studio 2022, будет установлена только среда выполнения .NET 8, и вы можете увидеть предупреждение, подобное приведенному ниже.

Если вас это беспокоит, вы можете установить среду выполнения .NET 6 или просто закрыть предупреждение. Для отладки вам не нужно устанавливать среду выполнения .NET 6.

Если вы хотите добавить среду разработки WinUI 3 позже

Если вы сначала установите Visual Studio, вы сможете добавить среду разработки WinUI 3 позже.

Запустите Visual Studio и выберите в меню Средства > Получить инструменты и функции.

Будет отображаться тот же экран, что и при установке Visual Studio, поэтому вы можете использовать . Убедитесь, что установлен флажок ".NET Desktop Development", а затем проверьте "Windows App SDK C# Template" в разделе "Сведения об установке" справа.

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

Приложения WinUI работают в среде с повышенным уровнем безопасности, в отличие от других классических приложений. Следовательно, он не может быть запущен как есть. Когда вы попытаетесь запустить его, вы увидите диалоговое окно, подобное приведенному ниже, и вам будет предложено включить «Режим разработчика». Если вы нажмете на ссылку, отобразится экран настроек, поэтому, пожалуйста, включите «Режим разработчика».

Даже если вы не используете Visual Studio, вы также можете включить или отключить режим разработчика на экране настроек. Выберите «Настройки» в меню «Пуск».

В меню «Система» выберите пункт «Для разработчиков».

Есть переключатель "Для разработчиков", поэтому установите его в положение "Вкл". Отобразится примечание, поэтому выберите «Да», чтобы включить его.

Если вы хотите перейти на .NET 8

Если вы создадите проект с помощью этого шаблона, по умолчанию будет использоваться .NET 6. Даже если я изменю целевую платформу на .NET 8 в свойствах проекта, сборка все равно будет отображать ошибки и предупреждения. Однако примерно 13.03.2024 Windows App SDK будет обновлен для официальной поддержки .NET 8.

Тем не менее, шаблон все еще находится в .NET 6, поэтому после создания проекта вам потребуется работать над .NET 8. Существует вероятность того, что он будет поддерживаться в будущих обновлениях версий.

Сначала создайте проект, а затем используйте NuGet для обновления версий, связанных с пакетом SDK для приложений Windows.

Если только нет, все в курсе. Microsoft.WindowsAppSDK должен быть не ниже 1.5.XXXX.

Измените целевую платформу на .NET 8 в свойствах проекта.

Даже если вы будете строить в таком состоянии, будет отображаться ошибка, потому что настройки проекта устарели.

Откройте файл проекта в виде кода.

RuntimeIdentifiersТак как параметр существует, удалите символ следующим 10 образом Win10 .

До модификации

<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>

↓

После исправления

<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>

Он также переписывает настройки публикации программы. Откройте каждый .pubxml файл в папке Properties > PublishProfiles.

RuntimeIdentifier Аналогично удалите символ в 10 параметре Win10 .

После этого выполните повторную сборку и убедитесь в отсутствии ошибок или предупреждений. .pubxml (В файле будет предупреждение, но вам не нужно об этом беспокоиться, потому что синтаксис отличается от синтаксиса данной проблемы.) )

Однако по какой-то причине библиотека классов WinUI продолжает предупреждать, даже если вы делаете то же самое, что и выше. На данный момент вы можете запустить его, поэтому давайте подождем, пока это исправится.