Поделиться через

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

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

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

Последняя версия стабильного канала:

Загрузки для Windows App SDK

Замечание

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

Версия 1.3.3 (1.3.230724000)

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

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

Версия 1.3.2 (1.3.23060202)

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

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

Версия 1.3.1 (1.3.230502000)

Это обслуживающий выпуск Windows App SDK, содержащий критические исправления ошибок для версии 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.230331000 (см. раздел Обновление пакета в разделе Установка пакетов и управление ими в Visual Studio с помощью диспетчера пакетов NuGet).

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

API заднего фона XAML

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

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

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

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

  • ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId, заменяющий устаревший MddGetGenerationId.
  • Диспетчер среды: EnvironmentManager.AreChangesTracked предназначен для того, чтобы сообщить вам, могут ли изменения в диспетчере среды отслеживаться в вашем приложении.
  • Новое событие DebugSettings.XamlResourceReferenceFailed теперь возникает, когда поиск по ссылке на Static/ThemeResource не может быть разрешен. Это событие предоставляет доступ к трассировке, которая показывает, где фреймворк искал этот ключ, чтобы лучше помочь вам отлаживать сбои при поиске Static и ThemeResource. Для получения более подробной информации см. спецификацию API Сбои поиска ссылок на ресурсы XAML на GitHub.

Другие обновления

  • Ознакомьтесь с нашим вехой WinAppSDK 1.3 вехой на WinAppSDK GitHub для получения дополнительных проблем, связанных с этим выпуском.
  • Дополнительные проблемы, связанные с этим выпуском, см. в 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, перезапустить его и перезагрузить решение.