Windows App SDK 1.0 的试验通道发行说明
重要
不支持在生产环境中使用试验通道,并且无法将使用试验版本的应用发布到 Microsoft Store。
试验通道提供 Windows App SDK 的版本,其中包括开发早期阶段的试验通道功能。 用于试验功能的 API 具有试验特性。 如果在代码中调用试验 API,会收到生成时警告。 试验通道中的所有 API 在将来的版本中可能会有重大更改,但试验 API 特别容易更改。 试验功能可能会从下一版本中删除,也可能永远不会发布。
重要链接:
- 如果要将现有应用从较旧版本的 Windows App SDK 升级到较新版本,请参阅将现有项目更新到 Windows App SDK 的最新版本。
- 有关试验版本的文档,请参阅安装 Windows App SDK 的预览和试验通道工具。
最新试验通道版本:
最新稳定通道版本:
试验版本 1.0 (1.0.0-experimental1)
此版本支持所有试验通道功能。
以下部分介绍此版本的新功能、更新功能、限制和已知问题。
WinUI 3
此版本的 WinUI 3 侧重于为 1.0 稳定版构建新功能以及修复 bug。
- 新功能:支持每个窗口显示 ContentDialog,而不是按线程显示。
- Bug:有关此版本中解决的 bug 的完整列表,请参阅我们的 GitHub 存储库。
- 示例:要查看 WinUI 3 控件和功能的运行情况,可从 GitHub 克隆并生成 WinUI 3 控件库应用,或从 Microsoft Store 下载应用。
有关详细信息,或开始使用 WinUI 进行开发,请参阅:
推送通知(试验功能)
此版本引入了推送通知 API,可供打包的桌面应用与基于 Azure 应用注册的标识一起使用。 要使用此功能,必须注册获取专用预览版。
重要限制:
- 只有在 Windows 10 版本 2004(内部版本 19041)或更高版本上运行的 MSIX 打包的应用才支持推送通知。
- Microsoft 保留在使用个人预览版期间从推送通知禁用或撤销应用的权利。
- Microsoft 不保证推送通知的可靠性或延迟。
- 在使用个人预览版期间,推送通知数量限制为每月 100 万条。
有关详细信息,请参阅推送通知概述。
窗口化
此版本包括对窗口化 API 的更新。 这些是一组基础的窗口化 API,它们以 AppWindow 类为中心,能够实现易于使用的窗口化方案,这些方案与 Windows 用户体验和其他应用能够很好地集成在一起。 这类似于 UWP AppWindow,但两者并不相同。
重要限制:
- 此版本的
AppWindow
目前仅适用于(打包和未打包的)Win32 应用。 - Windows App SDK 当前不提供将 UI 框架内容附加到
AppWindow
的方法,只能使用HWND
互操作访问方法。 - 在适用于 AMD64 的 Windows 版本 1809 和 1903 中,窗口化 API 目前无法正常使用。
有关详细信息,请参阅管理应用窗口(Windows App SDK)。
适用于未打包应用的部署
此版本引入了对动态依赖项功能(包括引导程序 API)的更新。
重要限制:
- 仅对未打包的应用支持动态依赖项功能。
- 不支持提升权限的调用方。
有关详细信息,请参阅以下文章:
其他限制和已知问题
- 不支持任何 CPU 生成配置:Windows App SDK 是用本机代码编写的,因此不支持任何 CPU 生成配置。 Visual Studio 中的 WinUI 3 模板只允许特定于体系结构的生成。 添加 Windows App SDK 到支持任何 CPU 的现有 .NET 应用程序或组件时,必须指定所需的体系结构:
x86
、x64
或arm64
。 - .NET 应用必须面向内部版本 18362 或更高版本:TFM 必须设置为
net6.0-windows10.0.18362
或更高版本,并且打包项目的<TargetPlatformVersion>
必须设置为 18362 或更高版本。 有关详细信息,请参阅 GitHub 上的已知问题。 - 使用试验版本 1.0 的 C# 应用必须使用以下 .NET SDK 之一:
- .NET 6 SDK 或更高版本(请参阅下载 .NET 和 .NET 5 将于 2022 年 5 月 10 日终止支持)。