Skip to content

Releases: microsoft/microsoft-ui-xaml

WinUI 3 in WinAppSDK 2.2.0

10 Jun 00:05

Choose a tag to compare

WinUI 3 in Windows App SDK 2.2.0

This release of WinUI 3 ships as part of Windows App SDK 2.2.0. To use it in your app, install the Microsoft.WindowsAppSDK 2.2.0 NuGet package.

What's new in WinUI 3:

  • New XamlBindingHelper boxing-free setter overloads. New SetPropertyFromThickness, SetPropertyFromCornerRadius, and SetPropertyFromColor overloads on XamlBindingHelper let {x:Bind} set value-type properties without boxing. The Setter.ValueProperty dependency property is also now exposed.

Bug fixes:

  • Fixed a crash in RenderTargetBitmap when the target element leaves the visual tree (for example, a popup closes) before PreCommit completes. RenderAsync now returns E_ABORT instead of crashing.
  • Fixed a use-after-free crash in ScrollView when the control is destroyed while its hide-indicators timer tick is still pending. See microsoft/microsoft-ui-xaml#10514.
  • Fixed a potential crash in Microsoft.UI.Xaml.dll!DirectUI::DXamlCore::GetPeerPrivate caused by attempting to access an object scheduled to be freed.
  • Fixed an issue where Microsoft.UI.System.ThemeSettings could crash an app if it was destroyed on a background thread (for example, when destroyed by the .NET garbage collector).
  • Fixed a crash that could occur on certain devices when active touch contacts were canceled by input hardware, such as when pen input overrides them.

For the full set of changes across Windows App SDK 2.2.0, see the Windows App SDK 2.2.0 release notes.

Try it out

WinUI 3 in WinAppSDK 1.8.9

10 Jun 00:05

Choose a tag to compare

WinUI 3 in Windows App SDK 1.8.9

This release of WinUI 3 ships as part of Windows App SDK 1.8.9. To use it in your app, install the Microsoft.WindowsAppSDK 1.8.260529003 NuGet package.

1.8.9 is a stable servicing release for 1.8. The WinUI changes in this release are two reliability fixes:

  • Fixed a memory leak in ItemsRepeater where recycled elements were never garbage collected due to a reference cycle through the RecyclePool, which could also cause crashes in InvalidateChildrenMeasure.
  • Fixed a potential crash when releasing touch contacts in a ScrollViewer before scrolling.

For the full set of changes, see the Windows App SDK 1.8.9 release notes.

Try it out

WinUI 3 in WinAppSDK 2.2.2-experimental9

10 Jun 00:05

Choose a tag to compare

WinUI 3 in Windows App SDK 2.2.2-Experimental9 🧪

This experimental release of WinUI 3 ships as part of Windows App SDK 2.2 Experimental 9. To use it in your app, install the Microsoft.WindowsAppSDK 2.2.2-experimental9 NuGet package.

This release ships alongside Windows App SDK 2.2.0 stable and brings forward the WinUI changes from that release, including the new XamlBindingHelper boxing-free setter overloads (SetPropertyFromThickness, SetPropertyFromCornerRadius, SetPropertyFromColor), the newly exposed Setter.ValueProperty dependency property, and the 2.2.0 WinUI bug fix batch.

For the full set of changes, see the Windows App SDK 2.2 Experimental 9 release notes.

Try it out

WinUI 3 in WinAppSDK 2.1.3

21 May 23:31

Choose a tag to compare

WinUI 3 in Windows App SDK 2.1.3

This release of WinUI 3 ships as part of Windows App SDK 2.1.3. To use it in your app, install the Microsoft.WindowsAppSDK 2.1.3 NuGet package.

What's new in WinUI 3:

  • TitleBar custom drag regions. TitleBar now recursively walks TitleBar.Content and automatically excludes interactive controls from the drag region while keeping empty gaps draggable by default. Three new APIs (TitleBar.IsDragRegion attached property, TitleBar.AutoRefreshDragRegions, and TitleBar.RecomputeDragRegions()) give developers explicit control when the default behavior isn't sufficient. See PR microsoft/microsoft-ui-xaml#10936 and tracking issue microsoft/microsoft-ui-xaml#10421.

Bug fixes:

  • Fixed a memory leak in ItemsRepeater where recycled elements were never garbage collected due to a reference cycle through the RecyclePool, which could also cause crashes in InvalidateChildrenMeasure.
  • Fixed a crash where an implicit Show/Hide animation completion callback could access a destroyed CUIElement, causing an access violation.
  • Fixed an issue where windowed popup content opened in a XAML Island did not respect OverrideScale, causing content to appear oversized and clipped. See GitHub issue microsoft/microsoft-ui-xaml#11000.
  • Fixed an integer divide-by-zero crash in UniformGridLayout::GetMajorSize when an ItemsRepeater is laid out in an available width narrower than one item's minor stride.
  • Fixed a fail-fast crash caused by re-entrant dispatch during cross-apartment COM release operations in UIAffinityReleaseQueue::DoCleanup.
  • Fixed ambiguous module lookup when multiple modules with the same name are loaded in the same process. GetModuleHandleW has been replaced with GetModuleHandleExW so the correct module is resolved by address.
  • Fixed an issue where XAML compiler errors were silently lost when using dotnet build, showing only MSB3073: exited with code 1 instead of the actual error messages. See GitHub issue microsoft/microsoft-ui-xaml#9813.

For the full set of changes across Windows App SDK 2.1.3, see the Windows App SDK 2.1.3 release notes.

Try it out

WinUI 3 in WinAppSDK 2.1.4-experimental8 🧪

21 May 23:31

Choose a tag to compare

WinUI 3 in Windows App SDK 2.1.4-Experimental8 🧪

This experimental release of WinUI 3 ships as part of Windows App SDK 2.1.4-experimental8. To use it in your app, install the Microsoft.WindowsAppSDK 2.1.4-experimental8 NuGet package.

This release ships alongside Windows App SDK 2.1.3 stable and brings forward the WinUI changes from that release, including the new TitleBar custom drag region APIs (TitleBar.IsDragRegion, TitleBar.AutoRefreshDragRegions, TitleBar.RecomputeDragRegions()) and the 2.1.3 WinUI bug fix batch.

For the full set of changes, see the Windows App SDK 2.1 Experimental 8 release notes.

Try it out

WinUI 3 in WinAppSDK 1.8.8

12 May 23:07

Choose a tag to compare

Title: WinUI 3 in WinAppSDK 1.8.8


The source code for the version of WinUI 3 in WinAppSDK 1.8.8 is available. 1.8.8 is a stable servicing release for the WinAppSDK that focuses on reliability fixes for 1.8, including XAML popup scaling in islands, a RenderTargetBitmap.RenderAsync access-violation fix, and build-time NuGet tooling improvements.

Check out our release notes for the list of fixes and changes in this release.

Download the WinAppSDK NuGet package for 1.8.8 here: https://www.nuget.org/packages/Microsoft.WindowsAppSDK/1.8.260508005

WinUI 3 in WinAppSDK 2.0.1

29 Apr 23:10

Choose a tag to compare

The source code for the version of WinUI 3 in WinAppSDK 2.0.1 is available. 2.0.1 is the stable GA release of WinAppSDK 2.0, our first major version update since WinAppSDK 1.0 (November 2021) and the first release on the new Semantic Versioning scheme.

This release ships new APIs and improvements across the platform, including XAML conditionals, modern Storage Pickers, expanded popup and anchoring APIs in Microsoft.UI.Content, new package deployment and validation APIs, and more.

Check out our full release notes for the full list of changes in this release.

Download the WinUI NuGet package for 2.0.1 here: https://www.nuget.org/packages/Microsoft.WindowsAppSDK.WinUI/2.0.12

WinUI 3 in WinAppSDK 1.8.7

21 Apr 23:11

Choose a tag to compare

The source code for the version of WinUI 3 in WinAppSDK 1.8.7 is available. 1.8.7 is a stable servicing release for the WinAppSDK
that includes bug fixes and reliability improvements for 1.8, plus two additive Windows AI APIs and an updated ONNX Runtime.

Check out our release notes for the list of fixes and changes in this release.

Download the WinUI NuGet package for 1.8.7 here: https://www.nuget.org/packages/Microsoft.WindowsAppSDK.WinUI/1.8.260415005

WinUI 3 in WinAppSDK 2.0-experimental7 🧪

21 Apr 21:42

Choose a tag to compare

The source code for the version of WinUI 3 in WinAppSDK 2.0.0-experimental7 is available. 2.0.0-experimental7 is an experimental WinAppSDK release that includes bug fixes for earlier versions and access to non-stable APIs.

Check out our release notes for the list of fixed issues and new or experimental APIs in this release.

Download the WinUI NuGet package for 2.0-experimental7 here: https://www.nuget.org/packages/Microsoft.WindowsAppSDK.WinUI/2.0.10-experimental

WinUI 3 in WinAppSDK 1.8.4

13 Jan 23:06

Choose a tag to compare

The source code for the version of WinUI 3 in the WinAppSDK 1.8.4 is available. 1.8.4 is a stable servicing release for the WinAppSDK that fixes critical bugs for 1.8.

Check out our release notes for the list of issues fixed in this release.

Download the NuGet package for 1.8.4 here: https://www.nuget.org/packages/Microsoft.WindowsAppSDK/1.8.260101001.