Skip to content

Commit 463d101

Browse files
Merge pull request #6180 from MicrosoftDocs/main
Auto Publish – main to live - 2026-01-13 22:34 UTC
2 parents 298333b + c63b129 commit 463d101

4 files changed

Lines changed: 203 additions & 7 deletions

File tree

hub/apps/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ items:
2626
- name: Release notes
2727
items:
2828
- name: Windows App SDK 2.0
29-
href: windows-app-sdk/release-notes/windows-app-sdk-2-0.md
29+
href: windows-app-sdk/release-notes/windows-app-sdk-2-0.md?pivots=experimental
3030
- name: Windows App SDK 1.8
3131
href: windows-app-sdk/release-notes/windows-app-sdk-1-8.md
3232
- name: Windows App SDK 1.7

hub/apps/windows-app-sdk/downloads.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Latest Windows App SDK downloads
33
description: This page provides links to the latest downloads of the Windows App SDK for all three release channels (stable, preview, and experimental).
44
ms.topic: article
5-
ms.date: 10/28/2025
5+
ms.date: 01/13/2026
66
keywords: windows, winrt, win32, windows app development, Windows App SDK
77
ms.localizationpriority: medium
88
---
@@ -43,6 +43,7 @@ For older releases, see the [Archive of Windows App SDK downloads](downloads-arc
4343
### Windows App SDK 2.0 Experimental
4444
| Version | Runtime downloads |
4545
|--|--|
46+
| **2.0 Experimental 4 (2.0.0-experimental4)** <br/> 01/13/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=experimental#version-20-experimental-4-200-experimental4) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F2.0.0-experimental4) | [Installer (x64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental4/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental4/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental4/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable (ZIP)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental4/Microsoft.WindowsAppRuntime.Redist.2.0.zip) |
4647
| **2.0 Experimental 3 (2.0.0-experimental3)** <br/> 11/11/2025 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=experimental#version-20-experimental-3-200-experimental3) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F2.0.0-experimental3) | [Installer (x64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental3/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental3/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental3/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable (ZIP)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental3/Microsoft.WindowsAppRuntime.Redist.2.0.zip) |
4748
| **2.0 Experimental 2 (2.0.0-experimental2)** <br/> 11/05/2025 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=experimental#version-20-experimental-2-200-experimental2) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F2.0.0-experimental2) | [Installer (x64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental2/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental2/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental2/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable (ZIP)](https://aka.ms/windowsappsdk/2.0/2.0.0-experimental2/Microsoft.WindowsAppRuntime.Redist.2.0.zip) |
4849
| **2.0 Experimental 1 (2.0.250930001-experimental1)** <br/> 10/02/2025 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=experimental#version-20-experimental-1-200-experimental1) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F2.0-experimental1) | [Installer (x64)](https://aka.ms/windowsappsdk/2.0/2.0.250930001-experimental1/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/2.0/2.0.250930001-experimental1/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/2.0/2.0.250930001-experimental1/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable (ZIP)](https://aka.ms/windowsappsdk/2.0/2.0.250930001-experimental1/Microsoft.WindowsAppRuntime.Redist.2.0.zip) |

hub/apps/windows-app-sdk/release-channels.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Windows App SDK release channels
33
description: Learn about the Experimental, Preview, and Stable release channels used to ship the latest version of the Windows App SDK.
44
ms.topic: article
5-
ms.date: 09/22/2025
5+
ms.date: 01/13/2026
66
keywords: windows win32, windows app development, project reunion, windows app sdk, release channels
77
ms.localizationpriority: medium
88
---
@@ -15,7 +15,7 @@ The latest version of the Windows App SDK ships via three release channels: Expe
1515
|--:|--|--|--|:--:|--|
1616
| **** | **Stable** | Production-ready channel intended for apps in market. Includes only stable, supported APIs suitable for long-term use. | No more than every six months <br/> *(plus servicing updates as needed)* | Yes | **1.8.4 (1.8.260101001)** <br/> Released: 01/13/2026 <br/> [Release notes](./release-notes/windows-app-sdk-1-8.md?pivots=stable#version-184-18260101001) |
1717
| **❇️** | **Preview** | Early look at the next Stable release. May introduce breaking API changes before final stabilization. | At least one preview for each Stable release | No | **1.8 Preview (1.8-preview)** <br/> Released: 08/19/2025 <br/> [Release notes](./release-notes/windows-app-sdk-1-8.md?pivots=preview#version-18-preview-18-preview) ** |
18-
| **🔄** | **Experimental** | Early-stage features under active development. APIs may change, be removed, or never ship. Intended for exploration and feedback only. | Published as needed to gather feedback on prototypes and early designs | No | **2.0 Experimental 4 (2.0.0-experimental4)** <br/> Released: 11/11/2025 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=experimental#version-20-experimental-3-200-experimental3) |
18+
| **🔄** | **Experimental** | Early-stage features under active development. APIs may change, be removed, or never ship. Intended for exploration and feedback only. | Published as needed to gather feedback on prototypes and early designs | No | **2.0 Experimental 4 (2.0.0-experimental4)** <br/> Released: 01/13/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=experimental#version-20-experimental-4-200-experimental4) |
1919

2020

2121
For a comprehensive list of all current and previous releases of the Windows App SDK, including download locations, see [Downloads for the Windows App SDK](downloads.md).

hub/apps/windows-app-sdk/release-notes/windows-app-sdk-2-0.md

Lines changed: 198 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,201 @@ zone_pivot_groups: wasdk-release-channels
2626

2727
:::zone pivot="experimental"
2828

29+
## Version 2.0 Experimental 4 (2.0.0-Experimental4)
30+
31+
Released: **Jan 13, 2026** <br><br>
32+
33+
<details><summary>ONNX Runtime Alignment and Execution Provider Stability</summary>
34+
35+
>
36+
> * Windows ML experimental builds align with ONNX Runtime mainline version 1.24 to improve compatibility and stability.
37+
> * Stable Application Binary Interface (ABI) execution providers are enforced to ensure predictable behavior across devices, with non‑stable execution providers excluded from acquisition.
38+
> * Only the OpenVINO execution provider is supported, with additional execution providers to be added over time as they meet stability requirements.
39+
> * The size of Microsoft.Windows.AI.MachineLearning.dll was reduced by approximately 160 KB.
40+
>
41+
</details>
42+
43+
<details><summary>App Content Search</summary>
44+
45+
>
46+
> * New experimental APIs to lookup statistics of items being indexed. This provides visibility into what is happening in the index.
47+
> * Support for Query cancellation to allow apps to run a query and update it if there is a new query before the current one completes. This allows responding faster to the query as a user types in the query string.
48+
> * Prefix matching support for short strings to improve results as user is typing.
49+
>
50+
</details>
51+
52+
<details><summary>Video Super Resolution Improvements</summary>
53+
54+
>
55+
> * VideoScaler is now disposable, improving resource management and lifecycle control.
56+
> * The VSR model is now compiled and cached to improve performance and reduce repeated initialization costs.
57+
> * A capability check has been added to validate VSR support before use.
58+
> * Explicit WinML initialization is no longer required when using Video Super Resolution.
59+
</details>
60+
61+
62+
<details><summary>WinUI FlowLayout Spacing improvements</summary>
63+
64+
>
65+
> * The `FlowLayout` control now uses ItemSpacing and LineSpacing terminology instead of horizontal and vertical spacing properties. The aligned naming improves clarity and consistency with modern layout patterns across UI frameworks.
66+
</details>
67+
68+
69+
<details><summary>WinUI WrapPanel improvements</summary>
70+
71+
>
72+
> * The `WrapPanel` control now uses ItemSpacing and LineSpacing nomenclature instead of the previous horizontal and vertical spacing properties.
73+
</details>
74+
75+
<details><summary>Custom XAML Predicates and IXamlPredicate Integration</summary>
76+
77+
>
78+
> * Implemented the `IXamlPredicate` interface to define custom predicates that integrate seamlessly with XAML's conditional namespace syntax and are evaluated at XAML parse time.
79+
> * Custom predicates enable conditional XAML scenarios based on application-specific factors such as:
80+
> * Feature flags
81+
> * Device capabilities
82+
> * Business logic
83+
> * Configuration settings
84+
> * Other runtime conditions
85+
</details>
86+
87+
<details><summary>WinUI Open-Source Enhancements</summary>
88+
89+
>
90+
> * Updated packages to enable external usability, which includes changes to:
91+
> * Microsoft.UI.DCPP.Dependencies.Minimal
92+
> * Microsoft.UI.DCPP.Dependencies.Edge
93+
> * ExpPointerPointStatics
94+
> * Added build support for Visual Studio 2026
95+
> * Introduced tools and scripts for use by external developers to build and test WinUI.
96+
>
97+
</details>
98+
99+
<details><summary>WinUI API deprecation and rename</summary>
100+
101+
>
102+
> - [deprecated] DependencyObject.Dispatcher
103+
> - [deprecated] Window.Current
104+
> - [deprecated] FocusManager.GetFocusedElement
105+
> - [renamed] SystemBackdropHost to SystemBackdropElement
106+
</details>
107+
108+
109+
<details><summary>WinAI API Namespace rename</summary>
110+
111+
>
112+
> - [renamed] `Microsoft.Windows.AI.Search.Experimental.AppContentIndex` to `Microsoft.Windows.Search.AppContentIndex`
113+
</details>
114+
115+
116+
<details><summary>Bug fixes</summary>
117+
118+
>
119+
> * Fixed “Class not registered” errors when using self-contained deployment with Windows ML. Developers using self-contained deployment no longer need to register all the Foundation package activatable classes that were used internally.
120+
> * Fixed a potential crash occurring on process shutdown when using Windows ML.
121+
> * Fixed the `ImageForegroundExtractor` API routing path so calls reach the correct endpoint.
122+
> * Ensured execution provider install and download progress is correctly forwarded to apps during package deployment.
123+
> * Fixed a crash in `SystemBackdrop` when the target disconnects by guarding invalid disconnection paths.
124+
> * Fixed an issue that prevented Windows AI APIs from being available for some applications.
125+
</details>
126+
127+
128+
<details><summary>New or updated APIs</summary>
129+
130+
>
131+
> This release includes the following new and modified experimental APIs compared to 2.0.0-experimental3:
132+
>
133+
> ```
134+
> Microsoft.UI.Content
135+
>
136+
> ChildSiteLink
137+
> IsHitTestVisible
138+
> ```
139+
> ```
140+
> Microsoft.UI.Xaml.Controls
141+
>
142+
> FlowLayout
143+
> LineSpacing
144+
> LineSpacingProperty
145+
> MinItemSpacing
146+
> MinItemSpacingProperty
147+
>
148+
> SystemBackdropElement
149+
> WrapPanel
150+
> ItemSpacing
151+
> ItemSpacingProperty
152+
> ItemsStretch
153+
> ItemsStretchProperty
154+
> LineSpacing
155+
> LineSpacingProperty
156+
>
157+
> WrapPanelItemsStretch
158+
> ```
159+
> ```
160+
> Microsoft.UI.Xaml.Markup
161+
>
162+
> IXamlPredicate
163+
> ```
164+
> ```
165+
> Microsoft.Windows.AI.Video
166+
>
167+
> VideoScaler
168+
> Dispose
169+
> ```
170+
> ```
171+
> Microsoft.Windows.Search.AppContentIndex
172+
>
173+
> AppContentIndexContract
174+
> AppContentIndexer
175+
> AppContentIndexListener
176+
> AppIndexContentRegion
177+
> AppIndexImageQuery
178+
> AppIndexImageQuerySession
179+
> AppIndexQueryMatch
180+
> AppIndexTextQuery
181+
> AppIndexTextQuerySession
182+
> AppIndexTextStreamEncoding
183+
> AppManagedImageQueryMatch
184+
> AppManagedIndexableAppContent
185+
> AppManagedTextQueryMatch
186+
> ContentItemErrorDetail
187+
> ContentItemReader
188+
> ContentItemReindexingStatus
189+
> ContentItemStatus
190+
> ContentItemStatusResult
191+
> ContentRegionTextOptions
192+
> DeleteIndexResult
193+
> DeleteIndexStatus
194+
> DeleteIndexWhileInUseBehavior
195+
> GetOrCreateIndexOptions
196+
> GetOrCreateIndexResult
197+
> GetOrCreateIndexStatus
198+
> ImageQueryMatch
199+
> ImageQueryOptions
200+
> ImageQuerySessionResult
201+
> IndexableAppContent
202+
> IndexCapabilities
203+
> IndexCapabilitiesOfCurrentSystem
204+
> IndexCapability
205+
> IndexCapabilityInitializationStatus
206+
> IndexCapabilityLanguageStatus
207+
> IndexCapabilityOfCurrentSystemStatus
208+
> IndexCapabilityRequirement
209+
> IndexCapabilityState
210+
> IndexStatistics
211+
> QueryMatchContentKind
212+
> QueryMatchScope
213+
> RegionContentKind
214+
> TextLexicalMatchType
215+
> TextQueryMatch
216+
> TextQueryOptions
217+
> TextQuerySessionResult
218+
> ```
219+
220+
>
221+
</details>
222+
223+
29224
## Version 2.0 Experimental 3 (2.0.0-Experimental3)
30225
31226
Released: **November 17, 2025** <br><br>
@@ -276,7 +471,7 @@ Released: **November 17, 2025** <br><br>
276471
277472
</details>
278473
279-
<details><summary>Bugfixes</summary>
474+
<details><summary>Bug fixes</summary>
280475
281476
>
282477
> * Fixed bounding box calculation when text is rotated. In some circumstances, the OCR text matching within images reported inaccurate or empty region bounds when the text was rotated.
@@ -290,8 +485,8 @@ Released: **November 17, 2025** <br><br>
290485
291486
Released: **November 6, 2025** <br><br>
292487
293-
[!IMPORTANT]
294-
If you previously installed Windows App SDK 2.0 Experimental 1, follow the [NuGet Uninstall](/nuget/consume-packages/install-use-packages-visual-studio#uninstall-a-package) guide to remove the `Microsoft.WindowsAppSDK` NuGet Metapackage with version `2.0.250930001-experimental1` from your project and the associated WinAppSDK component packages from that release before trying this new version, since the previously released Experimental package has a higher version number than the current one.
488+
> [!IMPORTANT]
489+
> If you previously installed Windows App SDK 2.0 Experimental 1, follow the [NuGet Uninstall](/nuget/consume-packages/install-use-packages-visual-studio#uninstall-a-package) guide to remove the `Microsoft.WindowsAppSDK` NuGet Metapackage with version `2.0.250930001-experimental1` from your project and the associated WinAppSDK component packages from that release before trying this new version, since the previously released Experimental package has a higher version number than the current one.
295490
296491
<details><summary>App Content Search</summary>
297492

0 commit comments

Comments
 (0)