Skip to content

Commit c543573

Browse files
agniuksScottj1s
andauthored
WinAppSDK 2.0 Preview2 Release Notes (#6577)
* release notes init * onnx runtime update * add to bugfixes * addressing feedback * Apply suggestions from code review Co-authored-by: Scott Jones <[email protected]> * additional notes and addressing feedback * additional notes * update links to 2.0.0-preview2 * fix redist link --------- Co-authored-by: Scott Jones <[email protected]>
1 parent 1ccc4a9 commit c543573

4 files changed

Lines changed: 115 additions & 8 deletions

File tree

hub/apps/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ items:
2828
- name: Release notes
2929
items:
3030
- name: Windows App SDK 2.0
31-
href: windows-app-sdk/release-notes/windows-app-sdk-2-0.md?pivots=experimental
31+
href: windows-app-sdk/release-notes/windows-app-sdk-2-0.md?pivots=preview
3232
- name: Windows App SDK 1.8
3333
href: windows-app-sdk/release-notes/windows-app-sdk-1-8.md
3434
- 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
@@ -34,7 +34,8 @@ For older releases, see the [Archive of Windows App SDK downloads](downloads-arc
3434

3535
| Version | Runtime downloads |
3636
|--|--|
37-
| **2.0 Preview (2.0-preview)** <br/> 02/13/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=preview) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F2.0-preview1) | [Installer (x64)](https://aka.ms/windowsappsdk/2.0/2.0-preview1/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/2.0/2.0-preview1/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/2.0/2.0-preview1/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable (ZIP)](https://aka.ms/windowsappsdk/2.0/2.0-preview1/Microsoft.WindowsAppRuntime.Redist.2.0-preview1.zip) |
37+
| **2.0 Preview2 (2.0.0-preview2)** <br/> 03/31/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=preview) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F2.0.0-preview2) | [Installer (x64)](https://aka.ms/windowsappsdk/2.0/2.0.0-preview2/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/2.0/2.0.0-preview2/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/2.0/2.0.0-preview2/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable (ZIP)](https://aka.ms/windowsappsdk/2.0/2.0.0-preview2/Microsoft.WindowsAppRuntime.Redist.2.0.zip) |
38+
| **2.0 Preview1 (2.0.0-preview1)** <br/> 02/13/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=preview) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F2.0-preview1) | [Installer (x64)](https://aka.ms/windowsappsdk/2.0/2.0-preview1/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/2.0/2.0-preview1/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/2.0/2.0-preview1/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable (ZIP)](https://aka.ms/windowsappsdk/2.0/2.0-preview1/Microsoft.WindowsAppRuntime.Redist.2.0-preview1.zip) |
3839

3940
For older releases, see the [Archive of Windows App SDK downloads](downloads-archive.md).
4041

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ The latest version of the Windows App SDK ships via three release channels: Expe
1414
| | Channel | Description | Release cadence | Supported? | Latest release |
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.6 (1.8.260317003)** <br/> Released: 03/18/2026 <br/> [Release notes](./release-notes/windows-app-sdk-1-8.md?pivots=stable#version-186-18260317003) |
17-
| **❇️** | **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 | **2.0 Preview (2.0-preview)** <br/> Released: 02/13/2026 <br/> [Release Notes](release-notes/windows-app-sdk-2-0.md#windows-app-sdk-200-preview1-release-notes) ** |
17+
| **❇️** | **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 | **2.0 Preview2 (2.0.0-preview2)** <br/> Released: 03/31/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=preview#version-20-preview-2-200-preview2) |
1818
| **🔄** | **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 6 (2.0.0-experimental6)** <br/> Released: 03/13/2026 <br/> [Release notes](./release-notes/windows-app-sdk-2-0.md?pivots=experimental#version-20-experimental-6-200-experimental6) |
1919

2020

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

Lines changed: 111 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Windows App SDK 2.0 release notes
33
description: Provides information about what's new in Windows App SDK 2.0.
44
ms.topic: release-notes
5-
ms.date: 09/22/2025
5+
ms.date: 03/31/2026
66
keywords: windows win32, windows app development, Windows App SDK, release notes
77
ms.localizationpriority: medium
88
zone_pivot_groups: wasdk-release-channels
@@ -20,14 +20,120 @@ zone_pivot_groups: wasdk-release-channels
2020

2121
:::zone pivot="preview"
2222

23+
## Version 2.0 Preview 2 (2.0.0-Preview2)
24+
25+
Released: **March 31, 2026** <br><br>
26+
27+
<details><summary>Windows ML</summary>
28+
29+
>
30+
> The Microsoft.WindowsAppSDK.ML NuGet package has been refactored, adding a new base dependency. The existing ML NuGet package's functionality remains the same, but the core Windows ML features have been refactored into a base dependent package called Microsoft.Windows.AI.MachineLearning. This new package contains a minimal set of dependencies, but on C#/WinRT or C++/WinRT it only supports down to Windows 10 18362. If you need Windows 10 17763 support, use the existing Microsoft.WindowsAppSDK.ML package.
31+
>
32+
> For new transitive dependencies, we recommend using tooling to upgrade the package (nuget.exe or VS). See also: [Windows App SDK 1.6 release notes](/windows/apps/windows-app-sdk/release-notes/windows-app-sdk-1-6?pivots=stable).
33+
>
34+
35+
</details>
36+
37+
<details><summary>Updated ONNX Runtime</summary>
38+
39+
>
40+
> The version of ONNX Runtime has been updated to 1.24.4. See [ONNX Runtime versions](/windows/ai/new-windows-ml/onnx-versions) for more info.
41+
>
42+
43+
</details>
44+
45+
<details><summary>Windows AI APIs</summary>
46+
47+
>
48+
> Enforced Phi Silica APIs to be part of a Limited Access Feature.
49+
>
50+
> Added additional enum states to help explain transient failures during the AI model acquisition process, providing guidance on issues such as missing capabilities, incompatible hardware, or required OS updates.
51+
>
52+
> Added checks for various network and Windows Update errors during AI model installation, flagging durable failures so users can understand why model packages failed to install.
53+
>
54+
> Improved diagnosability for Text Intelligence APIs used in Windows AI scenarios.
55+
>
56+
57+
</details>
58+
59+
<details><summary>App Content Search</summary>
60+
61+
>
62+
> App Content Search has been removed from 2.0 preview while we work to improve fundamentals and ensure future compatibility as the underlying AI models change.In the meantime, please continue to use the experimental channel to try the latest changes.
63+
>
64+
65+
</details>
66+
67+
<details><summary>WebView2 (WinUI 3)</summary>
68+
69+
>
70+
> Enabled drag support for WebView2 content hosted in WinUI 3 applications. This capability was previously unsupported and is now available without introducing new public APIs. Note: Drop into WebView2 from external sources is already supported.
71+
>
72+
> #### Supported scenarios
73+
>
74+
> - **Standard drag-and-drop content**
75+
> Dragging text, HTML, images, and URLs is supported. Based on current behavior, dragging images outside the app results in a default file name (for example, `download.jpg`) when dropped into File Explorer.
76+
> *Example scenario:* A user selects text or an image inside WebView2 and drags it either within the app or to another destination such as File Explorer.
77+
>
78+
> - **Drag cancellation**
79+
> On-demand cancellation of an active drag operation is supported.
80+
> *Example scenario:* An app conditionally blocks drag operations for certain content types (such as restricted or ephemeral content) by cancelling the drag after it has been initiated.
81+
>
82+
> - **Custom drag visuals**
83+
> Custom drag UI, such as icons or previews, is supported to help users clearly identify the content being dragged.
84+
> *Example scenario:* An app displays a thumbnail preview or icon while a user drags media content, making it clear which item is currently being moved.
85+
>
86+
> - **Customizable drag data**
87+
> Editing and customizing drag data is supported, enabling app-specific scenarios such as dragging messages within the app (for example, as an alternative interaction for message forwarding).
88+
> *Example scenario:* An app customizes the drag payload to include contextual metadata, such as the originating application name. When the content is dropped, the destination can display or process information like "From \<app name\>" to indicate the source of the dragged content.
89+
>
90+
> #### Limitations
91+
>
92+
> - Support for additional drag data types is limited. The following formats are not currently supported:
93+
> - `DownloadURL`
94+
>
95+
> #### Requirements
96+
>
97+
> - **Minimum WebView2 Runtime version (Edge Beta channel):** 144.0.3719.11
98+
>
99+
100+
</details>
101+
102+
<details><summary>Custom XAML Conditionals (IXamlCondition)</summary>
103+
104+
>
105+
> The `IXamlCondition` interface enables developers to define custom conditions that integrate with XAML's conditional namespace syntax and are evaluated at XAML parse time. This is a rename and graduation of the experimental `IXamlPredicate` interface. Custom conditions enable conditional XAML scenarios based on application-specific factors such as feature flags, device capabilities, business logic, configuration settings, and other runtime conditions.
106+
>
107+
108+
</details>
109+
110+
<details><summary>Bug fixes</summary>
111+
112+
>
113+
> * Fixed MSB8027 and LNK4042 build warnings caused by duplicate ClCompile items in Windows App SDK NuGet .targets files by moving preprocessor definitions from `<Target>` blocks to `<ItemDefinitionGroup>`. An opt-out workaround (`WindowsAppSDK_Arm64EcCompilerWorkaround`) is included for ARM64EC+LTCG builds to avoid a known MSVC internal compiler error.
114+
> * Fixed a ListView crash that could occur during keyboard navigation (Tab/Shift+Tab) after the items list was updated.
115+
> * Fixed an issue where WinUI 3 could crash if focus was moved to the CoreWebView2Controller while the controller was not visible.
116+
>
117+
118+
</details>
119+
120+
<details><summary>New or updated APIs</summary>
121+
122+
>
123+
> This release includes the following new and modified APIs compared to 2.0-Preview1:
124+
> ```
125+
> Microsoft.UI.Xaml.Markup
126+
>
127+
> IXamlCondition
128+
> ```
129+
>
130+
131+
</details>
132+
23133
## Version 2.0 Preview 1 (2.0.0-Preview1)
24134
25135
Released: **February 13, 2026** <br><br>
26136
27-
### Windows App SDK 2.0.0-Preview1 Release Notes
28-
29-
---
30-
31137
<details><summary>Windows ML</summary>
32138
33139
> * The version of ONNX Runtime in Windows ML has been updated to 1.24 RC

0 commit comments

Comments
 (0)