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

项目
02/22/2025

重要

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

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

重要链接：

如果要将现有应用从较旧版本的 Windows App SDK 升级到较新版本，请参阅将现有项目更新到 Windows App SDK 的最新版本。
有关预览版的文档，请参阅安装 Windows App SDK 的预览和试验通道工具。

预览通道发行说明存档：

版本 1.7 预览版 1 （1.7-preview1）

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

在现有的来自稳定通道的 Windows 应用 SDK 1.6 应用中，可以将 NuGet 包更新为 1.7.0-preview1（请参阅 更新包 部分，以及使用 NuGet 包管理器在 Visual Studio 中安装和管理包）。

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

新功能

新的徽章通知功能

新的徽章通知支持允许在任务栏中的应用上显示数字或符号徽章。有关详细信息，请参阅 GitHub #4926。

新版 CameraCaptureUI API

使用新的 CameraCaptureUI API，可以更轻松地在 Windows 应用 SDK 应用中捕获照片和视频。有关详细信息，请参阅 GitHub 问题 #4721。

新的身份验证 API

新的 OAuth2Manager API 为 Web 身份验证提供了简化的解决方案，实现了 OAuth 2.0 功能，并在 Windows 应用 SDK 支持的所有 Windows 平台上确保功能一致性。有关详细信息，请参阅 GitHub 问题 #4772。

新的后台任务支持

新的 BackgroundTaskBuilder API 为 Windows 应用 SDK 应用注册后台任务。有关详细信息，请参阅 GitHub #4831。

新建 TitleBar 控件

使用新的 TitleBar 控件，可以更轻松地为应用创建出色的可自定义标题栏。配置标题栏图标、标题和副标题等属性，包括集成的后退按钮，甚至添加自定义控件（如搜索框！该控件包括强大的标题栏功能，如空白的可拖动区域、主题响应能力、标题按钮和内置辅助功能支持，以便你可以专注于个性化设计，但仍获得与默认体验相同的可靠标题栏。有关详细信息，请参阅 GitHub #10056。

对 MathML 的支持

RichEditBox 现在通过 RichEditTextDocument.SetMathMode 和 RichEditTextDocument.SetMathML支持 MathML。有关详细信息，请参阅 GitHub #4196。

其他值得注意的更改

新的 RuntimeCompatibilityOptions 支持将允许更好地控制服务更改对应用的影响。有关详细信息，请参阅 GitHub #4966。
新的 ReleaseInfo API 提供对正在使用的 Windows 应用 SDK 运行时版本的轻松访问。有关详细信息，请参阅 GitHub #2893。
注意：此版本不包括 Windows Copilot 运行时 API。若要试验这些 API，请继续使用 1.7-experiment3 版本并共享你的反馈！
注意：此版本中不包括用于窗口化 AppWindow 的新 API。若要试验这些 API，请继续使用 1.7-experiment3 版本并共享你的反馈！

新 API

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

Microsoft.Security.Authentication.OAuth
 
    AuthFailure
    AuthRequestParams
    AuthRequestResult
    AuthResponse
    ClientAuthentication
    CodeChallengeMethodKind
    OAuth2Manager
    OAuthContract
    TokenFailure
    TokenFailureKind
    TokenRequestParams
    TokenRequestResult
    TokenResponse

Microsoft.UI.Text
 
    RichEditTextDocument
        GetMathML
        GetMathMode
        SetMathML
        SetMathMode
 
    TextApiContract

Microsoft.UI.Xaml
 
    XamlIsland
    XamlRoot
        ContentIsland

Microsoft.UI.Xaml.Controls
 
    TitleBar
    TitleBarAutomationPeer
    TitleBarTemplateSettings

Microsoft.Windows.ApplicationModel.Background
 
    BackgroundTaskBuilder
    BackgroundTaskContract

Microsoft.Windows.ApplicationModel.Background.UniversalBGTask
 
    Task
    UniversalBackgroundTaskContract

Microsoft.Windows.ApplicationModel.WindowsAppRuntime
 
    ReleaseInfo
    RuntimeCompatibilityChange
    RuntimeCompatibilityContract
    RuntimeCompatibilityOptions
    RuntimeInfo
    VersionInfoContract
    WindowsAppRuntimeVersion

Microsoft.Windows.BadgeNotifications
 
    BadgeNotificationGlyph
    BadgeNotificationManager
    BadgeNotificationsContract

Microsoft.Windows.Media.Capture
 
    CameraCaptureUI
    CameraCaptureUIContract
    CameraCaptureUIMaxPhotoResolution
    CameraCaptureUIMaxVideoResolution
    CameraCaptureUIMode
    CameraCaptureUIPhotoCaptureSettings
    CameraCaptureUIPhotoFormat
    CameraCaptureUIVideoCaptureSettings
    CameraCaptureUIVideoFormat

系统漏洞修复

此版本包括以下 bug 修复：

更改了 SplitButton，因此触摸输入现在与鼠标输入的行为匹配。有关详细信息，请参阅 GitHub 问题 #178。
更改了级联菜单，因此子菜单现在会立即打开（如果单击）。有关详细信息，请参阅 GitHub 问题 #939。
修复了打开位于浮出控件中的 ComboBox 会关闭所有浮出控件的问题。有关详细信息，请参阅 GitHub 问题 #1467。
修复了 SwipeControl 在 ListView中随机崩溃的问题。有关详细信息，请参阅 GitHub 问题 #2527。
修复了以下问题：仅拖放 ListViewItem 会使其处于错误的视觉状态。有关详细信息，请参阅 GitHub 问题 #3458。
修复了 StackLayout 中的问题，以便它遵循 ItemsRepeater.HorizontalAlignment 和 ItemsRepeater.VerticalAlignment 属性（当 StackLayout.Orientation 分别为垂直和水平时）。旧布局的行为就像 ItemsRepeater 的对齐方式为 Stretch。使用修补程序时，布局在使用右对齐时会使项目对齐到右侧，例如。有关详细信息，请参阅 GitHub 问题 #3842。
修复了以下问题：删除 ItemsRepeater源中的项不会生成移动到视图中的项。有关详细信息，请参阅 GitHub 问题 #6661。
修复了右 Alt 键不显示访问密钥的键提示的问题。有关详细信息，请参阅 GitHub 问题 #8447。 注意： 这可能会导致右侧 Alt 键的按键事件不再传送到应用程序或控件中的句柄。
向后滚动时，修复了由于UniformGridLayout有时会选取错误的布局定位点而导致的崩溃问题，并造成无限布局循环。有关详细信息，请参阅 GitHub 问题 #9199。
修复了将 NavigationFailedEventArgs.Handled 设置为 True 仍会引发异常的问题。有关详细信息，请参阅 GitHub 问题 #9632。
修复了 TabView 不应用任何指定的 CornerRadius的问题。有关详细信息，请参阅 GitHub 问题 #9846。
修复了 StackLayout中潜在的布局周期崩溃问题。有关详细信息，请参阅 GitHub 问题 #9852。
修复了删除项时 ItemsView 的潜在崩溃。有关详细信息，请参阅 GitHub 问题 #9868。

通过