УинУИ

Подгответе се за разработване с 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 от интернет или мултимедия. Поддържа издания на общността, професионалните или по-високите.

В избора на работно натоварване изберете . Разработка на настолни компютри на NET.

「. NET Desktop Development и проверете Windows App SDK C# Templates от подробностите за инсталиране вдясно.

Сега просто започнете инсталацията. Има и други екрани, но няма да ги обяснявам, докато не създадат проект.

След като инсталацията приключи, създайте нов проект.

В елемента за търсене в winui горния десен ъгъл има елемент, така че когато го изберете, ще се покаже шаблонът за проект WinUI 3, така че изберете произволен шаблон и създайте проект.

Вече можете да разработвате приложения с помощта на WinUI 3.

Ако виждате "Насочване към версия на .NET, която не е инсталирана"

От версията 17.9.1 на Visual Studio 2022 .NET for WinUI 3 е насочен към .NET 6. Ако не изберете допълнителни среди за изпълнение във Visual Studio 2022, ще бъде инсталирана само средата за изпълнение на .NET 8 и може да видите предупреждение като това по-долу.

Ако се притеснявате, можете да инсталирате .NET 6 runtime или просто да отхвърлите предупреждението. Не е необходимо да инсталирате .NET 6 runtime, за да отстранявате грешки.

Ако искате да добавите среда за разработка на 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, за да актуализирате версиите, свързани с Windows App SDK.

Освен ако не е друго, всичко е актуално. 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 продължава да предупреждава, дори ако правите същото като по-горе. Засега можете да го стартирате, така че нека изчакаме, докато това се поправи.