Заметки о выпуске стабильного канала для пакета SDK для приложений Windows 1.3

  • Статья

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

Важные ссылки:

Последний выпуск стабильного канала:

Скачиваемые файлы пакета SDK для приложений для Windows

Примечание.

Расширения Visual Studio для пакета SDK для приложений Windows (VSIX) больше не распределяются в виде отдельной загрузки. Они доступны в Visual Studio Marketplace в Visual Studio.

Версия 1.3.3 (1.3.230724000)

Это выпуск пакета SDK для приложений Windows, содержащий критические исправления ошибок для выпуска 1.3.

  • Исправлена проблема, из-за которой мышь иногда перестала работать при закрытии диалогового окна.
  • Исправлена проблема развертывания, из-за которой не удалось установить приложения из-за несоответствия версий пакетов в системе. Дополнительные сведения см. в статье о проблеме GitHub #3740.
  • Исправлена проблема, влияющая на положение контекстного меню в пакете SDK для приложений Windows 1.3.
  • Исправлена проблема, из-за которой некоторые приложения WinUI3 в некоторых ситуациях завершались сбоем при закрытии приложения, так как XAML завершает работу слишком рано.
  • Исправлена проблема, из-за которой значки шрифтов не отображались должным образом на языках справа налево. Дополнительные сведения см. в статье о проблеме GitHub #7661.
  • Исправлена проблема, из-за которой приложение завершалось сбоем при завершении работы, когда ресурсы были отключены в неправильном порядке. Дополнительные сведения см. в статье о проблеме GitHub #7924.

Версия 1.3.2 (1.3.23060202)

Это выпуск пакета SDK для приложений Windows, содержащий критические исправления ошибок для выпуска 1.3.

  • Исправлен сбой при установке защищенного курсора.
  • Исправлена проблема с производительностью в XamlMetadataProvider во время запуска приложения. Дополнительные сведения см. в статье о проблеме GitHub #8281.
  • Исправлена проблема с гиперссылками и касанием в RichTextBlock. Дополнительные сведения см. в статье о проблеме GitHub #6513.
  • Исправлена проблема с прокруткой и сенсорной панелью в WebView2. Дополнительные сведения см. в статье о проблеме GitHub #7772.
  • Исправлена проблема, из-за которой обновление пакета SDK для приложений Windows иногда требовало перезапуска Visual Studio. Дополнительные сведения см. в статье о проблеме GitHub #3554.
  • Исправлено шумное исключение при завершении работы при запуске в отладчике.

Версия 1.3.1 (1.3.230502000)

Это выпуск пакета SDK для приложений Windows, содержащий критические исправления ошибок для выпуска 1.3.

  • Исправлена проблема, из-за которой приложения завершались сбоем при настройке SystemBackdrop, если содержимое было null. Дополнительные сведения см. в статье о проблеме GitHub #8416.
  • Исправлена проблема, из-за которой приложения завершали сбой при настройке заголовка окна в XAML, добавлена новая возможность 1.3.0. Дополнительные сведения см. в статье о проблеме GitHub #3689.
  • Исправлена проблема, из-за которой окно неправильно сфокусироваться при изменении его содержимого.
  • Исправлена проблема при создании проектов C++ с шаблонами проектов WinAppSDK 1.3.
  • Обновленные шаблоны в Visual Studio Marketplace

Новые и обновленные функции и известные проблемы для версии 1.3

В следующих разделах описываются новые и обновленные функции и известные проблемы для версии 1.3.

В существующем приложении пакета SDK для приложений Windows 1.2 можно обновить пакет Nuget до версии 1.3.23031000 (см. раздел "Обновление пакета" в Visual Studio и управление ими с помощью диспетчер пакетов NuGet).

Сведения об обновленной среде выполнения и MSIX см. в разделе "Последние загрузки пакета SDK для приложений Windows".

API фона XAML

Благодаря свойствам, встроенным в окно XAML, mica и фоновые акриловые фоны теперь проще использовать в приложении WinUI 3. Дополнительные сведения о свойствах фона Xaml см. в документации по API фона системы и Mica Graph .

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

Заменив несколько строк стандартного кода, теперь вы можете использовать API AppWindow непосредственно из окна через Window.AppWindow.

Новые возможности из WinAppSDK

  • ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId заменяет устаревший mddGetGenerationId.
  • Environment Manager: EnvironmentManager.AreChangesTracked чтобы сообщить, могут ли изменения в диспетчере среды отслеживаться в приложении.
  • Новое событие, DebugSettings.XamlResourceReferenceFailed теперь возникает, когда не удается разрешить поиск по ссылке Static/ThemeResource. Это событие предоставляет доступ к трассировке, в которой платформа ищет этот ключ, чтобы лучше разрешить отладку сбоев статических и подстановок ThemeResource. Дополнительные сведения см. в спецификации 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:

> C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.3.230331000**\buildTransitive\Microsoft.UI.Xaml.Markup.Compiler.interop.targets(537,17): error MSB4064: The "PrecompiledHeaderFile" parameter is not supported by the "CompileXaml" task loaded from assembly: Microsoft.UI.Xaml.Markup.Compiler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=de31ebe4ad15742b from the path: C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.2.230118.102**\tools\net472\Microsoft.UI.Xaml.Markup.Compiler.dll. Verify that the parameter exists on the task, the <UsingTask> points to the correct assembly, and it is a settable public instance property.

Это вызвано тем, что Visual Studio использует библиотеку dll задач компилятора xaml с версии 1.2, но вождения ее несовместимой логикой MSBuild с версии 1.3, как показано в приведенном выше тексте ошибки. Обходной путь — завершить работу Visual Studio, перезапустить его и перезагрузить решение.