Windows App SDK

Windows App SDK是微软为支持现代Windows应用运行而推出的一套基础技术集合，中文名称Windows 应用 SDK，又称为WindowsAppRuntimeInstall，提供了一组统一的 API 和工具，可将最新的Windows平台功能引入 WinUI 3 和现有的桌面应用框架，例如WPF、Windows 窗体或 Win32。软件主要用来给电脑部署应用所需的运行环境包，负责把Windows App SDK Runtime的相关包安装到系统里，让依赖该框架的应用能正常运行，从而确保基于此开发的应用能在不同版本的 Windows 上获得一致的行为和体验，大幅提升应用的兼容性。实际上，Windows App Runtime 是Windows App SDK的一部分，它并非通用托管环境，而是提供Windows平台特定的能力，在实际开发中常需要与.NET Runtime 协作。用户在使用中常遇到的安装更新失败、DLL丢失导致的程序崩溃等问题，也多与此运行时的部署状态相关。

可以使用Windows App SDK完成哪些操作？

无论是使用 WinUI 构建新应用还是使用新式功能增强现有应用，Windows 应用 SDK都有助于利用最新的Windows API。下面是Windows 应用 SDK提供的主要功能的细分：

1、WinUI

适用于Windows应用的现代本机 UI（用户界面）框架，支持.NET（C#）和 C++ 项目。 WinUI 支持与 Fluent Design 系统保持一致、可访问且美观的用户体验。

2、Windows AI API

为应用提供强大的硬件加速人工智能（AI）功能，在 Copilot+ 电脑上无缝高效地运行本地模型。

3、Windows ML

在本地Windows上运行 ONNX AI 模型，自动优化可用硬件（例如 CPU、GPU 和 NPU）的性能，以便快速高效的推理。

4、新式文本呈现

使用设备无关的文本布局和渲染系统，结合ClearType子像素渲染、硬件加速和广泛的语言支持，以实现精确、高质量的文本。

5、资源管理

独立于应用逻辑管理应用资源，例如多语言字符串和图像、缩放以及对比度变体。

6、应用生命周期

管理应用的运行时行为的关键方面，包括 实例管理、 丰富激活 （文件、协议、重启等）和 电源管理。 控制应用启动、运行和节省系统资源的方式。

7、窗口管理

使用新式窗口 API 创建、定位和自定义应用窗口。

8、Notifications

发送本地通知或基于云的通知以吸引用户并使应用保持连接，包括 应用通知 和 推送通知。

9、小部件

将个性化且便于浏览的信息引入 Windows 微件板，使用户能够直接从桌面轻松访问应用程序的实时内容。

10、XAML 群岛

在现有桌面应用中嵌入新式Windows UI 控件，以刷新界面并添加新功能，而无需完全重写。

11、部署

将 Windows 应用 SDK 运行时与应用程序一起部署，无论是打包还是未打包，以确保跨设备运行一致且可靠的操作。

使用Windows 应用 SDK的好处：

Windows 应用 SDK为使用通过 NuGet 提供的一组统一 API 构建Windows应用提供了新式基础。 它与 Windows SDK 一起工作，并让开发人员在更快的发布周期中访问新的Windows功能。

1、Modern UI 开箱即用： Windows 应用 SDK 包括 WinUI，这是一个功能强大的本机 UI 框架，用于创建与 Fluent Design 系统一致的现代高性能接口。 可以使用它来生成新的桌面应用，或使用新式视觉对象和控件刷新现有体验。

2、使用现有应用和开发堆栈：可将Windows 应用 SDK添加到使用 WPF、Windows 窗体、Win32 或其他应用程序框架构建的现有应用。

3、模块化 SDK 设计： 采用元包结构，允许应用引用完整的 SDK 或仅特定组件，例如 WinUI、AI 或文本呈现。 这可实现增量采用并减少整体包大小。

4、在不同 Windows 版本之间保持一致性： Windows 应用 SDK API 可以在 Windows 11 和从 Windows 10 版本 1809 开始的早期版本上运行。 这样就可以在发布新功能后立即使用新功能，而无需依赖于作系统更新或编写版本自适应代码。

5、更快的发布节奏：由于 Windows 应用 SDK 独立于操作系统发布，因此新的 API 和改进将每年多次推出。 这种更快的节奏使开发人员能够更早地访问最新的Windows功能，而无需等待主要的 OS 更新。

支持的 Windows 版本：

Win11 25H2

Win11 24H2

Win11 23H2

Win11 22H2

Win11 21H2

Win10 23H2

Win10 22H2

Win10 21H2

Win10 1809

Server 2022

Server 2019

更新日志

v2.3.1稳定版本

1、结构化 JSON 输出 API

- 添加了结构化 JSON 输出 API（Microsoft.Windows.AI.Text.LanguageModel.GenerateStructuredJsonResponseAsync），该 API 生成受调用方提供的 JSON 架构约束的语言模型响应。

2、XamlOptionalChanges API

- 添加了 XamlOptionalChanges API，它允许应用在 XAML 初始化之前选择加入可选的中断性变更。

3、CompositionEngine API

- 添加了 CompositionEngine API 作为不稳定 的受限访问功能（LAF），它允许应用选择使用 OS 作为合成 API 的引擎。

4、视频超级分辨率改进

- 修复了 NPU 检测、添加了 CPU 支持，并改进了视频超分辨率的性能。

5、Windows ML

- 修复了在某些情况下执行提供程序枚举的问题。

- 添加了对 Windows ML 的ARM64EC支持。

6、AI 包文档

- 为 Microsoft.WindowsAppSDK.AI NuGet 包中的稳定 API 添加了 IntelliSense 文档。

7、性能改进

- 添加了新的优化 XamlControlsResources 样式，包括优化的 ScrollBar 模板。 使用 DefaultStyleOptimizations XamlChangeId 来选择启用这些样式。

- FontIcon 和 BitmapIcon 会避免为选择启用 IconNoGridOptimization XamlChangeId 的应用在其可视化树中插入额外的 Grid。

- 停止加载 Style 不会应用值的属性设置器。 使用 OptimizeApplyStyles XamlChangeId 选择启用。

- 延迟应用 FrameworkElement 和 Control 样式，直到元素位于树中。 使用 OptimizeApplyStyles XamlChangeId 选择启用。

- 通过不再加载视觉状态管理器的完整状态，优化了 CommandBar 初始化。

- 改进了向 CommandBarFlyout 的 PrimaryCommands 和 SecondaryCommands 添加内容的性能。

- 为ResourceDictionary使用了性能更高的哈希表。

- 优化后，在加载延迟资源时省去了资源键字符串的复制和比较操作。

- 通过减少字符串比较，提高了 ThemeResource 查找的性能。

- 通过减少资源键哈希开销，改进了 XAML 主题资源查找期间的 CPU 性能。

- 提升了针对 UIElement 和 FrameworkElement 上常见内部 XAML 类型检查的 CPU 性能。

- 改进了内部激活工厂查找路径中的 CPU 性能。

- 改进了 XBF 文件中存储的解码整数的性能。

- 通过保留矢量内存和优化 RAII 帮助程序来减少启动路径和树遍历的堆分配。

- 通过在追加多个项之前在跟踪器集合中保留空间来提高性能。

- 对 XamlUICommand 属性绑定进行了优化。

- 改进了未定义键盘加速器的绑定 XamlUICommand时的性能。

- 在标记中而非在代码中初始化默认样式的 AcrylicBrush 对象的 TintLuminosityOpacity 属性，从而避免强制实例化。

- 避免了在进入或离开元素树时，对 TextBlock 和 RichTextBlock 进行不必要的默认 ContextFlyout 初始化。 使用 DeferContextFlyoutInit XamlChangeId 选择启用。

- 通过在后台创建设备期间注册 XAML 的 D3D 设备移除事件，而不是等到稍后在 UI 线程上再注册，减少了因 Direct3D 锁争用导致的启动等待时间。

- 从 RefreshRateInfo中删除冗余电源通知注册，从而减少了启动开销。

- 通过在编译时计算记录的运行时版本，从 WinUI 启动路径中删除了冗余 version.dll 依赖项。

8、Bug 修复

- 修复了在指针事件重放期间同步关闭弹出窗口时 CPopupRoot::ReplayPointerUpdate 中发生的释放后使用崩溃。

- 修复了在 XAML 岛拆除过程中，由重入的 UI 自动化 查询触发的 CXamlIslandRoot::GetScreenOffset 中的访问冲突。

- 修复了一个崩溃问题：当视口跟踪的容器或标头被同级布局传递回收时，可能会留下一个过期的锚点，从而在下一次测量时触发快速失败。

- 修复了 CPopup::RemoveChild 中的一个快速失败问题：当 ToolTip 关闭操作泵送消息并重新进入关闭路径时会触发该问题。

- 修复了 CXcpDispatcher 中的重入崩溃：当 Popup 的析构函数在存在活动的 UI 自动化 客户端时触发 UIADisconnectAllProviders。

- 修复了在拥有的岛屿或调度程序开始拆毁后触发的级联菜单或 AutoSuggestBox 延迟打开计时器时发生崩溃的问题。

- 修复了当自定义元数据类型中的 COM 指针未正确释放时 DLL 卸载期间可能的无用故障。

- 修复了在焦点更改期间，由于调度程序重入而导致从 CompositionTarget.Rendering 回调中打开 Popup 时发生的崩溃。

- 修复了 MediaPlayerPresenter 中在处理媒体播放事件期间 GPU 设备丢失时发生的崩溃问题。

- 修复了在构建字形序列纹理期间发生设备丢失恢复时，Direct2D 文本渲染中的潜在访问冲突。

- 修复了 CFocusRectManager::FindFocusRectHost 中的一个崩溃问题：当焦点落在通过 InlineUIContainer 在 RichTextBlock 或 TextBlock 中以内联方式托管的控件上时。

- 修复了在后台任务没有存储的 CLSID 时可能导致 backgroundTaskHost.exe 反复崩溃的问题，并在 CoCreateInstance 失败时增加了妥善处理。

- 修复了窗口化和非窗口化浮出菜单在侧边放置且于屏幕底部附近向上展开时出现错位的问题（位置比父项高约一个项的高度）。

- 修复了在 UniformGridLayout 和 FlowLayout 中可能发生的崩溃问题（空 LayoutState 解引用）：当对一个不再处于已加载状态的 ItemsRepeater 引发集合更改时，可能会出现此问题。

- 修复了 ApplicationData.GetForUnpackaged().LocalSettings() 在错误路径（HKCU\SOFTWARE\publisher\product 而不是 HKCU\SOFTWARE\Classes\Local Settings\Software\publisher\product）处打开注册表项的问题，该路径是漫游位置，而不是计算机本地位置。

- 修复了键盘修饰符状态处理中的争用条件，该条件可能会使应用在并发 UI 线程输入下崩溃。

- 修复了在包安装、更新或卸载期间可能发生的 AppxSvc 崩溃。

9、新的或更新的 API

- 此版本包括与 2.2.0 版本相比的以下新 API：

Microsoft.UI.Composition

CompositionEngine

CompositionEngineType

Microsoft.UI.Xaml.Settings

XamlChangeId

XamlOptionalChanges

Microsoft.Windows.AI.Text

GenerateStructuredJsonResponseResult

GenerateStructuredJsonResponseStatus

LanguageModel

GenerateStructuredJsonResponseAsync