Windows App SDK 1.0 的试验通道发行说明

重要

不支持在生产环境中使用试验通道,并且无法将使用试验版本的应用发布到 Microsoft Store

试验通道提供 Windows App SDK 的版本,其中包括开发早期阶段的试验通道功能。 用于试验功能的 API 具有试验特性。 如果在代码中调用试验 API,会收到生成时警告。 试验通道中的所有 API 在将来的版本中可能会有重大更改,但试验 API 特别容易更改。 试验功能可能会从下一版本中删除,也可能永远不会发布。

重要链接

最新试验通道版本:

最新稳定通道版本:

试验版本 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 应用程序或组件时,必须指定所需的体系结构:x86x64arm64
  • .NET 应用必须面向内部版本 18362 或更高版本:TFM 必须设置为 net6.0-windows10.0.18362 或更高版本,并且打包项目的 <TargetPlatformVersion> 必须设置为 18362 或更高版本。 有关详细信息,请参阅 GitHub 上的已知问题
  • 使用试验版本 1.0 的 C# 应用必须使用以下 .NET SDK 之一