Releases: microsoft/microsoft-ui-xaml
WinUI 3 in WinAppSDK 2.2.0
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
XamlBindingHelperboxing-free setter overloads. NewSetPropertyFromThickness,SetPropertyFromCornerRadius, andSetPropertyFromColoroverloads onXamlBindingHelperlet{x:Bind}set value-type properties without boxing. TheSetter.ValuePropertydependency property is also now exposed.
Bug fixes:
- Fixed a crash in
RenderTargetBitmapwhen the target element leaves the visual tree (for example, a popup closes) beforePreCommitcompletes.RenderAsyncnow returnsE_ABORTinstead of crashing. - Fixed a use-after-free crash in
ScrollViewwhen 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::GetPeerPrivatecaused by attempting to access an object scheduled to be freed. - Fixed an issue where
Microsoft.UI.System.ThemeSettingscould 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
- Install the Microsoft.WindowsAppSDK 2.2.0 NuGet package.
- Download and update the WinUI Gallery to see the WinUI 3 updates firsthand.
WinUI 3 in WinAppSDK 1.8.9
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
ItemsRepeaterwhere recycled elements were never garbage collected due to a reference cycle through theRecyclePool, which could also cause crashes inInvalidateChildrenMeasure. - Fixed a potential crash when releasing touch contacts in a
ScrollViewerbefore scrolling.
For the full set of changes, see the Windows App SDK 1.8.9 release notes.
Try it out
- Install the Microsoft.WindowsAppSDK 1.8.260529003 NuGet package.
- Download and update the WinUI Gallery to see the WinUI 3 updates firsthand.
WinUI 3 in WinAppSDK 2.2.2-experimental9
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
- Install the Microsoft.WindowsAppSDK 2.2.2-experimental9 NuGet package.
- Download and update the WinUI Gallery to see the WinUI 3 updates firsthand.
WinUI 3 in WinAppSDK 2.1.3
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.
TitleBarnow recursively walksTitleBar.Contentand automatically excludes interactive controls from the drag region while keeping empty gaps draggable by default. Three new APIs (TitleBar.IsDragRegionattached property,TitleBar.AutoRefreshDragRegions, andTitleBar.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
ItemsRepeaterwhere recycled elements were never garbage collected due to a reference cycle through theRecyclePool, which could also cause crashes inInvalidateChildrenMeasure. - 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::GetMajorSizewhen anItemsRepeateris 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.
GetModuleHandleWhas been replaced withGetModuleHandleExWso the correct module is resolved by address. - Fixed an issue where XAML compiler errors were silently lost when using
dotnet build, showing onlyMSB3073: exited with code 1instead 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
- Install the Microsoft.WindowsAppSDK 2.1.3 NuGet package.
- Download and update the WinUI Gallery to see the WinUI 3 updates firsthand.
WinUI 3 in WinAppSDK 2.1.4-experimental8 🧪
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
- Install the Microsoft.WindowsAppSDK 2.1.4-experimental8 NuGet package.
- Download and update the WinUI Gallery to see the WinUI 3 updates firsthand.
WinUI 3 in WinAppSDK 1.8.8
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
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
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 🧪
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
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.