Read this article in your language IT | EN | DE | ES
Стабільний канал надає випуски Windows App SDK, які підтримуються для використання програмами у виробничих середовищах. Програми, які використовують стабільний випуск Windows App SDK, також можна публікувати в Microsoft Store.
Завантаження для Windows App SDK
Windows App SDK VSIX і середовище виконання (пакунки інсталятора і MSIX) доступні на сторінці Завантаження для Windows App SDK. Завантаження SDK містять розширення Visual Studio для створення та збирання нових проектів за допомогою Windows App SDK. Серед завантажень для виконання є інсталятор і пакунки MSIX, які використовуються для розгортання програм. Якщо ви ще не зробили цього, встановіть інструменти для Windows App SDK.
Версія 1.3
Версія 1.3.1 (1.3.230502000)
Це сервісний випуск Windows App SDK, який містить виправлення критичних помилок у версії 1.3.
- Виправлено проблему, яка призводила до аварійного завершення роботи програм при встановленні SystemBackdrop, якщо значення параметра Content було нульовим. Докладні відомості наведено у випуску GitHub #8416.
- Виправлено помилку, що призводила до аварійного завершення роботи програм під час встановлення заголовка вікна у форматі XAML - нової можливості, доданої у версії 1.3.0. Докладнішу інформацію наведено у випускові GitHub #3689.
- Виправлено проблему, коли вікно некоректно приймало фокус при зміні його вмісту.
- Виправлено проблему зі створенням C++ проектів за допомогою шаблонів проектів WinAppSDK 1.3.
- Оновлені шаблони на Visual Studio Marketplace
Версія 1.3
У наступних розділах описано нові та оновлені функції та відомі проблеми у версії 1.3.
У наявному додатку Windows App SDK 1.2 ви можете оновити пакунок Nuget до версії 1.3.230331000 (див. розділ Оновлення пакунка у розділі Встановлення та керування пакунками у Visual Studio за допомогою Менеджера пакунків NuGet).
API-інтерфейси тла XAML
Завдяки властивостям, вбудованим у вікно XAML, слюдяні та акрилові фони тепер простіше використовувати у вашому додатку WinUI 3. Докладнішу інформацію про властивості фону XAML див. у документації до API системного фону та фону слюди.
Оновлену версію середовища виконання та MSIX див. у розділі Завантаження Windows App SDK.
Window.AppWindow
Замінивши кілька рядків шаблонного коду, ви тепер можете використовувати API AppWindow безпосередньо з вікна через Window.AppWindow.
Нові можливості з WinAppSDK
- ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId, який замінює застарілий MddGetGenerationId.
- Менеджер середовища: EnvironmentManager.AreChangesTracked для інформування про те, чи можна відстежувати зміни у менеджері середовища у вашій програмі.
- Нова подія, DebugSettings.XamlResourceReferenceFailed, тепер генерується, коли пошук за посиланням на статичний/тематичний ресурс не вдається вирішити. Ця подія надає доступ до трасування, яке детально показує, де фреймворк шукав цей ключ, щоб ви могли легше виправляти помилки пошуку статичних та тематичних ресурсів. Для отримання додаткової інформації дивіться специфікацію API трасування помилок пошуку посилань на ресурси XAML на GitHub.
Інші оновлення
- Додаткові проблеми, вирішені у цьому випуску, див. у WinAppSDK 1.3 на GitHub WinAppSDK.
- Дивіться наш WinUI 3 у WinAppSDK 1.3 на microsoft-ui-xaml GitHub для додаткових питань, вирішених у цьому випуску.
- З останньою експериментальною версією VSIX ви можете конвертувати ваш додаток між неупакованим та упакованим через меню Visual Studio, а не у файлі вашого проєкту.
Відома проблема
Через нещодавні зміни у компіляторі xaml, існуючий проект, який оновлюється до версії 1.3, може зіткнутися з помилкою збірки у Visual Studio, подібною до наведеної нижче:
Це спричинено тим, що Visual Studio використовує кешовану бібліотеку завдань компілятора xaml з версії 1.2, але керує ним за допомогою несумісної логіки MSBuild з версії 1.3, як показано у тексті помилки вище. Обхідний шлях - вимкнути Visual Studio, перезапустити її і перезавантажити рішення.
Exception: Stack empty.