Windows 应用 SDK 的最新预览通道发行说明

  • 项目

重要

预览通道不支持在生产环境中使用，并且无法将使用预览版本的应用发布到 Microsoft Store。

此预览通道包括 Windows App SDK 的多个版本，其中附带处于开发后期阶段的预览通道功能。 预览版本不含实验功能和 API，但在下一稳定版本之前仍可能会出现重大更改。

重要链接：

预览通道发行说明存档：

版本 1.6 预览版 2 （1.6.0-preview2）

这是版本 1.6 的预览频道的最新版本。

在现有的 Windows 应用 SDK 1.5（从稳定通道）应用中，可以将 Nuget 包更新为 1.6.0-preview2（请参阅使用 NuGet 程序包管理器 在 Visual Studio 中安装和管理包的“更新包”部分）。

有关已更新的运行时和 MSIX，请参阅 Windows 应用 SDK 下载。

新功能

1.6-preview2 所需的 C# 项目更改

此版本还需要 1.6-preview1 中的 C# 项目指南。

本机 AOT 支持

1.6-preview2 包括更新已发布 的 Microsoft.Windows.CsWinRT 版本 2.1.1 的重大更改，并使生成更可靠的本机预编译。

更新了 Edge WebView2 SDK 集成

此版本现在引用包的已发布 1.0.2651.64 版本，该版本 Microsoft.Web.WebView2 应修复 1.6-preview1 中引用的预发行版问题。 如 1.6-preview1 中所述，应用现在可以根据需要选择较新版本的 Microsoft.Web.WebView2 包。

缺陷修复

1.6-preview2 包含自 1.6-preview1 版本以来的以下新修补程序：

  • 修复了在 .xaml 中设置 InfoBar.IsOpen 时的崩溃。 有关详细信息，请参阅 GitHub 问题 #8391。
  • 修复了当鼠标在边界外 WebView2 移动时 HTML 元素会丢失指针捕获的问题。 有关详细信息，请参阅 GitHub 问题 #8677。
  • 修复了无法拖放到浮出控件 ShouldConstrainToRootBounds=false 的问题。 有关详细信息，请参阅 GitHub 问题 #9276。
  • 修复了启用引用时PublishSingleFile不起作用的问题ms-appx://。 有关详细信息，请参阅 GitHub 问题 #9468。
  • 修复了某些二进制文件调试器符号无法正常工作的问题。 有关详细信息，请参阅 GitHub 问题 #4633。
  • 修复了使用 /permissive-时的生成中断。 有关详细信息，请参阅 GitHub 问题 #4643。
  • 修复了 1.6-preview1 中由重命名参数引起的几个 API 中断性变更。 有关详细信息，请参阅 GitHub 问题 #4645。
  • 修复了 1.6-preview1 中某些项目（尤其是类型 Windows.UI.Text ）中某些项目的类型冲突生成中断。 有关详细信息，请参阅 GitHub 问题 #4646。
  • 修复了 1.6-preview1 中控件库的资源查找问题。 有关详细信息，请参阅 GitHub 问题 #4649。
  • 修复了子类分析时可能出现的 NavigationView崩溃。
  • 修复了滚动或减小表格大小时表格边框 RichEditBox 无法正确擦除的问题。
  • 修复了浮出控件具有 MediaTransportControls 完全透明背景的问题。
  • 修复了以下问题：在显示比例系数超过 100% 或启用系统文本缩放时，拖入 WebView2 会失败或下降到错误的位置。
  • 修复了当输入因限制而阻止输入时，无法向辅助功能工具报出的问题TextBoxRichEditBox/。MaxLength

版本 1.6 预览版 1 （1.6.0-preview1）

这是版本 1.6 的预览频道的最新版本。

在现有的 Windows 应用 SDK 1.5（从稳定通道）应用中，可以将 Nuget 包更新为 1.6.0-preview1（请参阅使用 NuGet 程序包管理器 在 Visual Studio 中安装和管理包的“更新包”部分）。

有关已更新的运行时和 MSIX，请参阅 Windows 应用 SDK 下载。

新功能

注意

我们在 1.6-experimental1 中发布的新 TitleBar 控件在 1.6 的非实验版本中尚不可用，以允许更多时间来评估和响应社区反馈。 我们在这里收到了很多伟大的意见，并希望确保我们花点时间解决它。

1.6-preview1 所需的 C# 项目更改

在 1.6-preview1 中，Windows 应用 SDK托管应用需要 Microsoft.Windows.SDK.NET.Ref*.*.*.38，可通过文件中的 csproj WindowsSdkPackageVersion 指定。 例如：

<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
       <OutputType>WinExe</OutputType>
       <TargetFramework>net8.0-windows10.0.22621.0</TargetFramework>
       <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
       <WindowsSdkPackageVersion>10.0.22621.38</WindowsSdkPackageVersion>
   <PropertyGroup>
   ...

此外，Windows 应用 SDK托管应用应更新为 Microsoft.Windows.CsWinRT 2.1.1 （或更高版本）。

本机 AOT 支持

本机预编译现在支持 .NET PublishAot 项目属性。 有关本机 AOT 的详细信息，请参阅 本机 AOT 部署。 由于 AOT 基于剪裁支持而构建，因此以前在 1.6-experimental1 版本中介绍的大部分与剪裁相关的指南也适用。 有关详细信息，请参阅 本机 AOT 支持 。

如上所述，C# 项目应具有对 Microsoft.Windows.CsWinRT 2.1.1（或更高版本）的包引用。此版本包括 AOT 安全 ICustomPropertyProvider 实现。 与此支持一起使用的类型应与 WinRT.GeneratedBindableCustomProperty 属性 partial一起进行标记。

更改了 Edge WebView2 SDK 集成

Windows 应用 SDK现在使用 Edge WebView2 SDK 作为 NuGet 引用，而不是嵌入边缘 WebView2 SDK 的硬编码版本。 新模型允许应用选择较新版本的Microsoft.Web.WebView2包，而不是仅限于生成Windows 应用 SDK的版本。 新模型还允许应用引用也引用 Edge WebView2 SDK 的 NuGet 包。 有关详细信息，请参阅 GitHub 问题 #5689。

新建包部署 API

包管理 API 已收到多项增强功能，包括 Is*ReadyOrNewerAvailable*（）、EnsureReadyOptions.RegisterNewerIfAvailable、Is*Provisioned*（）、IsPackageRegistrationPending（）和多个 bug 修复。 有关更多详细信息，请参阅 PackageManagement.md 和 拉取请求 #4453 。

改进了 TabView 选项卡拆解

TabView 支持新的 CanTearOutTabs 模式，该模式为拖动选项卡和拖出新窗口提供了增强的体验。 启用此新选项后，选项卡拖动非常类似于 Edge 和 Chrome 中的选项卡拖动体验，在拖动过程中会立即创建新窗口，允许用户将其拖动到屏幕边缘，以最大化或将窗口贴靠在一个平滑动作中。 此实现也不使用拖放 API，因此不受这些 API 中的任何限制的影响。 值得注意的是，在以管理员身份提升的进程中，支持选项卡拆解。

其他值得注意的更改

  • 我们添加了一个新的 ColorHelper.ToDisplayName() API，填补了 UWP 的空白。
  • 添加了一个新 Microsoft.Windows.Globalization.ApplicationLanguages 类，其中特别包括新功能 PrimaryLanguageOverride 。 有关详细信息，请参阅 GitHub 问题 #4523。
  • 未 ItemsWrapGrid密封。 这应该是向后兼容的更改。
  • PipsPager 支持可在第一个项和列表项之间换行的新模式。
  • RatingControl 现在，通过将一些硬编码样式属性移动到主题资源，可以更自定义。 这样，应用就可以重写这些值，以便更好地自定义 RatingControl 的外观。

已知问题

  • 如果调试器设置为在所有C++异常上中断，它将在 BCP47（Windows 全球化）代码中启动时中断一对干扰异常。

缺陷修复

  • 修复了处理自定义标题栏方案时出现的几个问题。 有关详细信息，请参阅 GitHub 问题 #7629、 #9670、 #9709 和 #8431。
  • 修复了图标不可见的问题 InfoBadge 。 有关详细信息，请参阅 GitHub 问题 #8176。
  • 修复了图标有时在错误位置上 CommandBarFlyout显示的问题。 有关详细信息，请参阅 GitHub 问题 #9409。
  • 修复了打开或关闭子菜单时菜单中键盘焦点的问题。 有关详细信息，请参阅 GitHub 问题 #9519。
  • 修复了在回收项目时使用错误IsExpanded状态的问题TreeView。 有关详细信息，请参阅 GitHub 问题 #9549。
  • 修复了在 . ItemsRepeater.ItemTemplate. 中使用 ElementName 绑定时出现的问题。 有关详细信息，请参阅 GitHub 问题 #9715。
  • 修复了有时处于错误位置的第一个项目 ItemsRepeater 的问题。 有关详细信息，请参阅 GitHub 问题 #9743。
  • 修复了 InputNonClientPointerSource 有时中断最小/最大/关闭按钮输入的问题。 有关详细信息，请参阅 GitHub 问题 #9749。
  • 修复了将 Microsoft.UI.Interop.h 与 clang-cl 配合使用时的编译错误。 有关详细信息，请参阅 GitHub 问题 #9771。
  • 修复了事件 CharacterReceived 未正常工作 ComboBox/TextBox的问题。 有关详细信息，请参阅 GitHub 问题 #9786。
  • 修复了 1.6 实验版中的问题，其中指针输入行为 CanTearOutTabs 在比例系数不同于 100% 的监视器上不正确。 有关详细信息，请参阅 GitHub 问题 #9791。
  • 修复了 1.6-experimental2 版本中的问题，其中某些语言翻译存在 ColorHelper.ToDisplayName()字符编码问题。
  • 修复了 1.6-experimental1 中 NumberBox 未使用正确前景和背景色的问题。 有关详细信息，请参阅 GitHub 问题 #9714。
  • 修复了箭头键和选项卡键引发重复 KeyUp 事件的问题。 有关详细信息，请参阅 GitHub 问题 #9399。
  • 修复了无法获取SystemSuspendStatus事件的问题PowerManager.SystemSuspendStatusChanged。 有关详细信息，请参阅 GitHub 问题 #2833。
  • 修复了以下问题：初始键盘焦点未正确提供给窗口中唯一 WebView2 控件的时间。
  • 修复了在ExtendsContentIntoTitleBar=trueUI 自动化中未正确显示 Min/Max/Close 按钮的问题，这阻止了语音访问显示这些按钮的数字。
  • 修复了由于意外重新进入而导致应用在锁定检查中崩溃的问题。
  • 修复了切换为高对比度主题时颜色未正确更新的问题 Hyperlink 。
  • 修复了以下问题：更改后台窗口中的 ListView 集合可能会错误地将该窗口移动到前台并获取焦点。
  • 修复了 1.6 实验性 1 AcrylicBrush.TintLuminosityOpacity 的问题：类库项目中的 .xaml 设置会崩溃并出现类型转换错误。
  • 修复了调用 ItemsRepeater.StartBringIntoView 有时可能导致项目消失的问题。
  • 修复了触摸和拖动 Button 处于 ScrollViewer 按下状态的问题。
  • 更新了 IntelliSense，它缺少许多较新的类型和成员的信息。
  • 修复了以下问题：在空区域中 ScrollViewer 单击将焦点始终移动到该控件中的第一个可聚焦控件， ScrollViewer 并将该控件滚动到视图中。 有关详细信息，请参阅 GitHub 问题 #597。
  • 修复了事件有时多次触发的问题 Window.Activated 。 有关详细信息，请参阅 GitHub 问题 #7343。
  • 修复了设置 NavigationViewItem.IsSelected 属性以防止 true 其子级在展开时显示的问题。 有关详细信息，请参阅 GitHub 问题 #7930。
  • 修复了无法正确显示带有None或DropShadow边缘效果的标题的问题MediaPlayerElement。 有关详细信息，请参阅 GitHub 问题 #7981。
  • 修复了显示浮出控件时未使用该属性的问题 Flyout.ShowMode 。 有关详细信息，请参阅 GitHub 问题 #7987。
  • 修复了有时会出现舍入错误的问题 NumberBox 。 有关详细信息，请参阅 GitHub 问题 #8780。
  • 修复了以下问题：使用针对旧版 WinAppSDK 编译的库可能会遇到尝试查找类型或属性的错误。 有关详细信息，请参阅 GitHub 问题 #8810。
  • 修复了启动窗口时未设置初始键盘焦点的问题。 有关详细信息，请参阅 GitHub 问题 #8816。
  • 修复了首次显示后无法正常工作的问题 FlyoutShowMode.TransientWithDismissOnPointerMoveAway 。 有关详细信息，请参阅 GitHub 问题 #8896。
  • 修复了某些控件无法正确绑定模板 Foreground 和 Background 属性的问题。 有关详细信息，请参阅 GitHub 问题 #7070、 #9020、 #9029、 #9083 和 #9102。
  • 修复了在 setter 中使用的VisualStateManager主题更改不会更新的问题ThemeResource。 浮出控件中经常受影响的控件。 有关详细信息，请参阅 GitHub 问题 #9198。
  • 修复了失去关键焦点的问题 WebView ，导致额外的模糊/焦点事件和其他问题。 有关详细信息，请参阅 GitHub 问题 #9288。
  • 修复了在调试输出中显示绑定错误的问题 NavigationView 。 有关详细信息，请参阅 GitHub 问题 #9384。
  • 修复了定义负视图框的 SVG 文件不再呈现的问题。 有关详细信息，请参阅 GitHub 问题 #9415。
  • 修复了更改 ItemsView.Layout 方向导致项目被删除的问题。 有关详细信息，请参阅 GitHub 问题 #9422。
  • 修复了滚动 ScrollView 生成大量调试输出的问题。 有关详细信息，请参阅 GitHub 问题 #9434。
  • 修复了无法 MapContorl.InteractiveControlsVisible 正常工作的问题。 有关详细信息，请参阅 GitHub 问题 #9486。
  • 修复了未 MapControl.MapElementClick 正确触发事件的问题。 有关详细信息，请参阅 GitHub 问题 #9487。
  • 修复了在使用弱引用之前 x：Bind 未检查 null 的问题，这可能会导致崩溃。 有关详细信息，请参阅 GitHub 问题 #9551。
  • 修复了更改 TeachingTip.Target 属性未正确更新其位置的问题。 有关详细信息，请参阅 GitHub 问题 #9553。
  • 修复了下拉列表未在 WebView2 中响应的问题。 有关详细信息，请参阅 GitHub 问题 #9566。
  • 修复了使用 GeometryGroup时内存泄漏问题。 有关详细信息，请参阅 GitHub 问题 #9578。
  • 修复了从中ScrollView滚动大量项ItemRepeater可能会导致空白呈现帧的问题。 有关详细信息，请参阅 GitHub 问题 #9643。
  • 修复了无法正常工作的问题 SceneVisual 。

1.6.0-preview1 中的新 API

版本 1.6-preview1 包括与稳定 1.5 版本相比的以下新 API：

Microsoft.UI

    ColorHelper
        ToDisplayName

Microsoft.UI.Input

    EnteredMoveSizeEventArgs
    EnteringMoveSizeEventArgs
    ExitedMoveSizeEventArgs
    InputNonClientPointerSource
        EnteredMoveSize
        EnteringMoveSize
        ExitedMoveSize
        WindowRectChanged
        WindowRectChanging

    MoveSizeOperation
    WindowRectChangedEventArgs
    WindowRectChangingEventArgs

Microsoft.UI.Xaml

    XamlRoot
        CoordinateConverter

Microsoft.UI.Xaml.Automation.Peers

    ScrollPresenterAutomationPeer

Microsoft.UI.Xaml.Controls

    PipsPager
        WrapMode
        WrapModeProperty

    PipsPagerWrapMode
    TabView
        CanTearOutTabs
        CanTearOutTabsProperty
        ExternalTornOutTabsDropped
        ExternalTornOutTabsDropping
        TabTearOutRequested
        TabTearOutWindowRequested

    TabViewExternalTornOutTabsDroppedEventArgs
    TabViewExternalTornOutTabsDroppingEventArgs
    TabViewTabTearOutRequestedEventArgs
    TabViewTabTearOutWindowRequestedEventArgs

Microsoft.Windows.Globalization

    ApplicationLanguages

Microsoft.Windows.Management.Deployment

    EnsureReadyOptions
        RegisterNewerIfAvailable

    PackageDeploymentFeature
    PackageDeploymentManager
        IsPackageDeploymentFeatureSupported
        IsPackageProvisioned
        IsPackageProvisionedByUri
        IsPackageReadyOrNewerAvailable
        IsPackageReadyOrNewerAvailableByUri
        IsPackageSetProvisioned
        IsPackageSetReadyOrNewerAvailable

    PackageReadyOrNewerAvailableStatus

Microsoft.Windows.Storage

    ApplicationData
    ApplicationDataContainer
    ApplicationDataContract
    ApplicationDataCreateDisposition
    ApplicationDataLocality