Підготуйтеся до розробки з WinUI 3

Робоче середовище

Вікна

• Вікна 11

Візуальна студія

• Visual Studio 2022 Версія 17.9.3

.МЕРЕЖІ

• .NET 6
• (.NET 8)

Інтерфейс WinUI

• Інтерфейс WinUI 3

Пакет SDK для Windows

• 1.4.230913002

Передумови

У деяких випадках можуть працювати і більш низькі версії.

Вікна

• Вікна 10
• Вікна 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

Запустіть інсталятор Visual Studio 2022 з Інтернету або медіа. Він підтримує версії Community, Professional або вищі.

У виборі робочого навантаження виберіть . Розробка NET для настільних комп'ютерів.

「. NET Desktop Development і перевірте шаблони Windows App SDK C# у відомостях про встановлення праворуч.

Тепер просто запустіть установку. Є й інші екрани, але я не буду їх пояснювати, поки вони не створять проект.

Після завершення інсталяції створіть новий проект.

У правому верхньому куті є пункт 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» і встановіть прапорець «Шаблон SDK для Windows C#» у розділі «Відомості про встановлення» праворуч.

Увімкніть режим розробника

Програми WinUI працюють у середовищі з підвищеною безпекою, на відміну від інших настільних програм. Тому його не можна запускати в тому вигляді, в якому він є. Коли ви спробуєте запустити його, ви побачите діалогове вікно, подібне до наведеного нижче, і вам буде запропоновано ввімкнути «Режим розробника». Якщо ви натиснете на посилання, з'явиться екран налаштувань, тому, будь ласка, увімкніть "Режим розробника".

Навіть якщо ви не використовуєте Visual Studio, ви також можете увімкнути або вимкнути «Режим розробника» на екрані налаштувань. Виберіть «Налаштування» в меню «Пуск».

У меню «Система» виберіть «Для розробників».

Є перемикач для "Для розробників", тому встановіть його в положення "Увімкнено". З'явиться примітка, тому виберіть «Так», щоб увімкнути її.

Якщо ви хочете перейти на .NET 8

Якщо ви створюєте проект з цим шаблоном, за замовчуванням він буде використовувати .NET 6. Навіть якщо я зміню цільовий фреймворк на .NET 8 у властивостях проекту, збірка все одно показує помилки та попередження. Однак приблизно 13.03.2024 р. SDK для Windows App SDK буде оновлено для офіційної підтримки .NET 8.

Однак шаблон все ще знаходиться в .NET 6, тому вам потрібно буде працювати над .NET 8 після створення проекту. Можливо, це буде підтримуватися в майбутніх оновленнях версій.

Спочатку створіть проект, а потім використовуйте NuGet, щоб оновити версії, пов'язані з SDK програми Windows.

Якщо не інакше, все актуально. Microsoft.WindowsAppSDK має бути не менше 1.5.ХХХХ.

Змініть цільовий фреймворк на .NET 8 у властивостях проекту.

Навіть якщо ви зберете в такому стані, буде відображатися помилка через те, що налаштування проекту застаріли.

Відкрийте файл проекту у вигляді коду.

RuntimeIdentifiersТак як параметр є, то видаліть символ наступним 10 Win10 чином.

Перед модифікацією

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

↓

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

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

Він також переписує налаштування публікації програми. Відкрийте кожен .pubxml файл у папці «Властивості» > PublishProfiles.

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

Після цього перебудуйте та переконайтеся, що немає помилок або попереджень. .pubxml (У файлі з'явиться попередження, але вам не потрібно хвилюватися про це, оскільки цей синтаксис відрізняється від цього питання.) )

Однак з якоїсь причини бібліотека класів WinUI продовжує попереджати, навіть якщо ви зробите те ж саме, що і вище. Поки що ви можете його запустити, тому давайте почекаємо, поки це виправиться.