Windows 应用 SDK 的最新预览通道发行说明
重要
预览通道不支持在生产环境中使用,并且无法将使用预览版本的应用发布到 Microsoft Store。
此预览通道包括 Windows App SDK 的多个版本,其中附带处于开发后期阶段的预览通道功能。 预览版本不含实验功能和 API,但在下一稳定版本之前仍可能会出现重大更改。
重要链接:
- 如果要将现有应用从较旧版本的 Windows App SDK 升级到较新版本,请参阅将现有项目更新到 Windows App SDK 的最新版本。
- 有关预览版的文档,请参阅安装 Windows App SDK 的预览和试验通道工具。
预览通道发行说明存档:
- Windows 应用 SDK 1.5 的预览频道发行说明
- Windows 应用 SDK 1.4 的预览通道发行说明
- Windows 应用 SDK 1.3 的预览通道发行说明
- Windows 应用 SDK 1.2 的预览通道发行说明
- Windows 应用 SDK 1.1 的预览频道发行说明
- Windows 应用 SDK 1.0 的预览通道发行说明
版本 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 会失败或下降到错误的位置。
- 修复了当输入因限制而阻止输入时,无法向辅助功能工具报出的问题
TextBox
RichEditBox
/。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=true
UI 自动化中未正确显示 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