Windows 应用 SDK 的最新稳定通道发行说明

稳定通道提供支持在生产环境中供应用使用的 Windows App SDK 版本。使用 Windows App SDK 稳定版本的应用还可以发布到 Microsoft Store。

重要链接：

如果要将现有应用从较旧版本的 Windows 应用 SDK 升级到较新版本，请参阅将现有项目更新到 Windows 应用 SDK 的最新版本。

下载 Windows App SDK

注意

Windows App SDK Visual Studio 扩展 (VSIX) 已不再作为单独的下载进行分发。它们可在 Visual Studio 内的 Visual Studio Marketplace 中使用。

版本 1.8

在现有的 Windows 应用 SDK 应用中，可以将 Nuget 包更新为 1.8.250907003（请参阅使用 NuGet 包管理器在 Visual Studio 中安装和管理包的“更新包”部分）。

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

版本 1.8.3 （1.8.251106002）

这是 Windows 应用 SDK 版本 1.8 的最新服务版本。

故障修复

修复了 OrientedVirtualizingPanel 在计算范围时遇到溢出时引发的潜在崩溃。（RuntimeCompatibilityChange： OrientedVirtualizingPanel_FixBoundsOverflow）。

Windows ML 更新

扩展的 OS 支持

Windows ML 现在支持 Windows 10（版本 1809 及更高版本）和 Windows Server 2019 及更高版本，用于具有选择的执行提供程序的 CPU 和 GPU 工作负载。了解详细信息：支持的执行提供程序

AMD MiGraphX 执行引擎

添加了对 AMD MiGraphX 执行提供程序的支持，为最新的 Ryzen AI 300 系列处理器启用 AMD GPU 上的 ML 工作负载。此提供商目前正在 Windows 预览体验计划频道中试运行，并计划在本月底之前实现零售可用性。了解详细信息：支持的执行提供程序

Windows ML 模型目录 API

这些 API 使应用或库能够从自己的联机模型目录动态发现和下载大型 AI 模型文件，并在电脑上的应用之间共享这些文件，而无需将这些大型文件直接与应用或库捆绑在一起。请参阅文档，了解如何使用这些 API！

1.8.3 的新 API：

Microsoft.Windows.AI.MachineLearning

    CatalogModelInfo
    CatalogModelInstance
    CatalogModelInstanceResult
    CatalogModelInstanceStatus
    CatalogModelStatus
    ModelCatalog
    ModelCatalogSource

版本 1.8.2 （1.8.251003001）

更新了 ONNX 运行时

onnxruntime.dll已更新到 1.23.1，引入了 ONNX Runtime Python 和 C++ API 的多项增强功能，重点介绍了改进的设备和内存信息处理、同步流支持和张量复制功能。它为设备/内存类型添加新的 Python 绑定，公开更详细的会话输入/输出元数据，并提供 Python 可访问的张量复制 API。这些更改还会重构和扩展C++ API，以便更好地管理流和内存信息。

关键增强功能包括：

Python 绑定用于OrtMemoryInfoDeviceType、OrtDeviceMemoryType，并扩展OrtDevice，以便通过新mem_type方法公开内存类型。 OrtMemoryInfo Python 类现在支持旧 V2 构造函数和新 V2 构造函数，并公开其他属性，例如设备内存类型和供应商 ID。
扩展了 Python InferenceSession 对象，通过新的属性和方法提供对 imput/output OrtMemoryInfo 和 OrtEpDevice 对象的访问
引入了 Python 绑定 OrtSyncStream，包括通过 OrtEpDevice.create_sync_stream() 创建和通过 OrtMemoryInfo 检索特定于设备 OrtEpDevice.memory_info() 的内容。
重构了 C++ API，以更通用地处理 SyncStream，从而支持非所有权流并改进类型安全性。
添加了一个新的 Python 级别 copy_tensors 函数和相应的C++绑定，从而在 OrtValue 对象之间高效复制张量数据，可以选择使用同步流。
在 Python 绑定中，将OrtValue.data_ptr方法的返回类型从int64_t更改为uintptr_t，以提高跨平台兼容性。
对 Python API 中的错误消息和设备类型处理的细微改进（例如，对于 OrtDevice）。
已解决内存信息处理中出现的边缘情况
解决了改善稳定性和可靠性的次要问题

故障修复

修复了部署处理程序代码，以报告实际故障 HRESULT，以提高故障排除时的清晰度。

版本 1.8.1 （1.8.250916003）

LanguageModel 文本生成

LanguageModel 现已使用 Phi 二氧化硅 生成文本响应，并且内置内容审查功能，以此响应广泛的用户提示。 Phi Silica 是微软最强大的 NPU 优化本地语言模型，它针对 Windows Copilot+ PC 设备的效率和性能进行了优化，同时仍提供大型语言模型（LLM）中的许多功能。

有关详细信息，请参阅 Windows 应用 SDK 中的 Phi 硅入门和适用于 Windows 应用 SDK 中的 Phi 硅的 API ref 。

Microsoft Windows ML

借助 Windows ML ，开发人员可以使用动态安装的硬件特定执行提供程序在 ONNX 运行时的共享系统范围内副本上的 Windows 电脑上本地运行 ONNX AI 模型。

主要优势：

动态获取最新 IP - 自动下载和管理最新的硬件特定执行提供程序
共享 ONNX 运行时 - 使用系统范围的运行时，而不是捆绑自己的运行时，从而减少应用大小
较小的下载/安装 - 无需在应用中携带大型 EP 和 ONNX 运行时
广泛的硬件支持 - 在所有 Windows 11 电脑（x64 和 ARM64）上运行，并具有任何硬件配置

1.8.1 的新 API

此版本包括与以前的 1.8 版本相比的以下新 API：

Microsoft.Windows.AI.MachineLearning

    ExecutionProvider
    ExecutionProviderCatalog
    ExecutionProviderCertification
    ExecutionProviderReadyResult
    ExecutionProviderReadyResultState
    ExecutionProviderReadyState
    MachineLearningContract

Microsoft.Windows.AI.Text

    LanguageModel
        CreateContext
        GenerateEmbeddingVectors
        GenerateResponseAsync
        GenerateResponseFromEmbeddingsAsync
        GetUsablePromptLength
        GetVectorSpaceId

已知问题

C# 开发人员必须手动引用 System.Numerics.Tensors 版本 9.0.0 或更高版本的 NuGet 包才能使用 Microsoft.ML.OnnxRuntime.Tensors。如果没有引用此 NuGet 包，在调用Microsoft.ML.OnnxRuntime.TensorsAPI 时将遇到以下运行时错误：Could not load file or assembly 'System.Numerics.Tensors, Version=9.0.0.0

版本 1.8.0 （1.8.250907003）

Windows AI API

Windows 应用 SDK 现在包含一套人工智能（AI）API，可用于本地语言模型，以在 Copilot+ 电脑上执行各种任务。你的应用现在可以智能地响应提示、识别图像中的文本、描述图像的内容、从图像中删除对象等。

有关在创建 Windows AI API 期间利用的负责任的开发实践的信息，在创建 AI 辅助功能时也可以应用这些做法，请参阅在 Windows 上开发负责任的生成 AI 应用程序和功能指南。

Windows AI 提示大小限制报告

允许应用程序确定输入是否超过文本摘要生成器调用的允许大小。如果输入太大，API 将返回指示当前限制的索引，使开发人员能够相应地调整输入。此限制基于令牌数量而不是字节或字符长度，并且可能由于多种因素而有所变化。因此，应用程序应将限制视为动态且可能会更改。

Windows AI 文本重写器音调

启用具有特定音调的文本重写。休闲选项将内容改写，使其显得更加非正式，并且更具对话性，使用自然流畅的表达，同时保留含义和格式。 “正式”选项将文本转换为经过磨练的专业版本，维护原始结构和细节，以及适合正式上下文的精确语言。 “常规”选项保留原始语气和意图，确保含义保持不变。

文本智能 - 对话摘要

Phi Silica 现在有一个对话总结功能，允许你总结人们通过电子邮件、聊天或会话中所说的话。有关更多详细信息，请参阅 Phi 硅。

对话摘要选项

使开发人员能够指定会话摘要所需的输出语言。这样，应用程序就可以使用目标语言生成摘要、增强本地化和用户体验。

Windows AI 对象擦除

对象擦除可用于从图像中删除对象。该模型采用图像和灰度掩码，指示要删除的对象、清除图像中的屏蔽区域，并将擦除的区域替换为图像背景。

十进制数据类型

新的 Decimal 支持提供了一种高精度的 base-10 数值数据类型，对于财务和科学计算而言是无价的，避免浮点数据类型固有的不精确和舍入错误。它的结构为 96 位（12 字节）无符号整数，按可变幂 10 进行缩放，从而精确表示小数值。这使对缺少十进制数据类型的编程语言提供十进制支持，并提供与支持十进制的语言（例如 C#、Python）的互作性。

NuGet 元包

Windows 应用 SDK NuGet 包已转换为 NuGet 元包。参与 Windows 应用 SDK 的每个组件现在都是一个组件 NuGet 包，由元包列为依赖项。这样，开发人员就可以选择元包或为其应用程序选择特定的组件包。使用单个组件包可让开发人员仅包含其应用所需的 API 和功能。默认体验的行为就像 WindowsAppSDKSelfContained 已设置为 True 一样，但可以引用 Microsoft.WindowsAppSDK.Runtime 包以使用框架包部署。

Microsoft.Windows.SDK.BuildTools.MSIX 重构

MSIX 发布支持已纳入独立的 nuget 包，该包可由 Windows 应用 SDK 和其他项目独立维护和使用。此外，我们还弥补了单项目解决方案中的一些功能缺失，包括生成 MSIX 捆绑包和 MSIX 上传包的功能。

存储选取器

Windows 应用 SDK 中的 Microsoft.Windows.Storage.Pickers API 为桌面应用程序提供现代化文件和文件夹选取器体验。此 API 基于现有的 Windows.Storage.Pickers API 设计，但桌面方案有关键改进。新的 Microsoft.Windows.Storage.Pickers API 解决了使用 Windows 应用 SDK/WinUI 开发的应用上的 UWP 文件和文件夹选取器的两个关键限制：

提升的进程支持：当应用程序以管理员身份运行时，现有 Windows.Storage.Pickers API 不起作用。新 API 在提升模式下启用文件和文件夹选择。
WinUI 3 中的简化用法：使用 WinUI 3 中的现有 UWP 选取器需要初始化窗口关联窗口句柄。新的选取器通过直接在构造函数中接受 WindowId 来消除此要求，使它们更易于使用。

其他值得注意的更改

在 Windows App SDK 1.8 之前，AppContainer 中运行的打包应用不需要 packageManagement 功能，因为 DeploymentManager 自动初始化问题。此问题现已解决，反过来，基于 AppContainer 的应用现在需要 packageManagement 功能。
实验性 WinML API 已从此版本中删除，并将包含在将来的版本中。

漏洞修复

修复了以下问题：当至少有一个窗口将 ExtendsContentIntoTitleBar 设置为 true 时，应用的其他窗口的悬停效果可能会闪烁。
NavigationView：修复了将 SelectedItem 设置为 null 的 bug 未在折叠模式下正确清除选择状态。
TabView：修复了关闭选项卡会将键盘焦点移动到“添加选项卡”按钮而不是新选择的选项卡的问题。
SplitButton：修复了 SplitButton 控件显示比标准按钮控件短的 UI 不一致问题
TabView：修复了 WinUI 中的 TabView 间距问题：将 TabView 的 TabWidthMode 属性设置为 SizeToContent 时，选项卡标题文本和左/右边缘之间的填充会变得不均匀

1.8.0 的新 API

Microsoft.Windows.AI.Foundation
 
    AIFoundationContract
    EmbeddingVector

Microsoft.Windows.AI.Imaging
 
    ImageObjectRemover
    ImageObjectRemoverContract

Microsoft.Windows.AI.Text
 
    ConversationItem
    ConversationSummaryOptions
    InputKind
    LanguageModelEmbeddingVectorResult
    TextRewriter
        RewriteAsync
 
    TextRewriteTone
    TextSummarizer
        IsPromptLargerThanContext
        SummarizeConversationAsync

Microsoft.Windows.Foundation
 
    DecimalContract
    DecimalHelper
    DecimalValue

Microsoft.Windows.Storage.Pickers
 
    FileOpenPicker
    FileSavePicker
    FolderPicker
    PickerLocationId
    PickerViewMode
    PickFileResult
    PickFolderResult
    StoragePickersContract

Microsoft.Windows.Widgets.Feeds.Providers
 
    FeedManager
        TryRemoveAnnouncementById
 
    IFeedManager3

与 1.8-Preview1 相比的新 API

Microsoft.Windows.AI.Text
 
    TextRewriteTone
        Concise

Microsoft.Windows.Foundation
 
    DecimalContract
    DecimalHelper
    DecimalValue

存档稳定频道发行说明

展开链接以查看存档稳定频道的发行说明

反馈

此页面是否有帮助？

Last updated on 2025-11-12

通过

Windows 应用 SDK 的最新稳定通道发行说明

下载 Windows App SDK

版本 1.8

版本 1.8.3 （1.8.251106002）

故障修复

Windows ML 更新

扩展的 OS 支持

AMD MiGraphX 执行引擎

Windows ML 模型目录 API

1.8.3 的新 API：

版本 1.8.2 （1.8.251003001）

更新了 ONNX 运行时

故障修复

版本 1.8.1 （1.8.250916003）

LanguageModel 文本生成

Microsoft Windows ML

1.8.1 的新 API

已知问题

版本 1.8.0 （1.8.250907003）

Windows AI API

Windows AI 提示大小限制报告

Windows AI 文本重写器音调

文本智能 - 对话摘要

对话摘要选项

Windows AI 对象擦除

十进制数据类型

NuGet 元包

Microsoft.Windows.SDK.BuildTools.MSIX 重构

存储选取器

其他值得注意的更改

漏洞修复

1.8.0 的新 API

与 1.8-Preview1 相比的新 API

存档稳定频道发行说明

相关主题

反馈

其他资源