microsoft/WindowsAppSDK v2.1.4-exp8

2.1 Experimental 8 (2.1.4-experimental8) 🧪

Repository: microsoft/WindowsAppSDK

Tag: v2.1.4-exp8

Published: 2026-05-21T23:31:32Z

Prerelease: yes

Release notes:

Windows App SDK 2.1.4-Experimental8 (2.1.4-experimental8) 🧪

Windows App SDK 2.1 Experimental 8 ships alongside Windows App SDK 2.1.3 stable. It generally brings forward the changes in 2.1.3 (TitleBar custom drag-region APIs, the Phi Silica LoRA API on the stable surface, AICapabilities.HasAICapability, expanded Windows ML execution-provider support, ONNX Runtime 1.24.6, and the 2.1.3 bug fix batch) and adds one experimental-only refinement to the Phi Silica structured JSON output API.

What's new in WinAppSDK 2.1 Experimental 8:

• Strongly typed result and status for structured JSON responses [Experimental]. LanguageModelExperimental.GenerateStructuredJsonResponseAsync (introduced in 2.0 Experimental 7) now returns a dedicated GenerateStructuredJsonResponseResult type with a GenerateStructuredJsonResponseStatus property, instead of the generic LanguageModelResponseResult / LanguageModelResponseStatus pair. The new status enum is specific to schema-constrained generation: it includes a ResponseInvalidJson value for cases where the model output did not satisfy the requested JSON schema, separate from generic language-model response failures.
• As part of that split, the ResponseInvalidJson value has been removed from the stable LanguageModelResponseStatus enum. Apps that handled ResponseInvalidJson from LanguageModelResponseStatus should move that handling onto the new GenerateStructuredJsonResponseStatus returned by GenerateStructuredJsonResponseAsync.

Brought forward from 2.1.3 stable

This experimental release also rolls forward the 2.1.3 stable changes, including the new TitleBar custom drag-region APIs, the Phi Silica LoRA API on the stable surface, AICapabilities.HasAICapability, the Windows ML execution-provider improvements, the ONNX Runtime 1.24.6 bump, and the full 2.1.3 bug fix batch. See the Windows App SDK 2.1.3 release notes for details.

To see everything that's new and changed, see the full [Windows App SDK 2.1 Experimental 8 release notes](https://learn.microsoft.com/en-us/windows/apps/windows-app-sdk/release-notes/windows-app-sdk-2-0?pivots=experimental#version-21-experimental-8-214-experimental8).

Try it out

• Download the 2.1.4-experimental8 NuGet package to use WinAppSDK 2.1 Experimental 8 in your app.

Getting Started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

• Install developer tools.
• Create a WinUI 3 app.
• Continue your development journey.