Skip to content

Releases: CommunityToolkit/Windows

[Pre-release] v8.3.260211-preview1

11 Feb 19:10

Choose a tag to compare

Pre-release

What's Changed

Vertical Orientated Components 🚦

  • Orientation option for Segmented by @Avid29 in #747
  • [RangeSelector] Add support for vertical orientation by @Illustar0 in #756

Bug Fixes 🐞

  • Fix Segmented control's container VisualState adjustment and arrow key focus issues by @Avid29 in #815
  • Remove SpriteVisual from visual tree in attached shadows before disposing of composition resources by @Ryken100 in #818
  • [Extensions] AlternateColor without item containers by @Avid29 in #763
  • Fixed DoubleToObjectConverterSample by @Avid29 in #823

Repository

  • Increment MinorVersion from 2 to 3 by @michael-hawker in #765
  • Convert tests to UIThreadTestMethod pattern by @Copilot in #764
  • Enable crash dumps for uwp/wasdk unit tests by @Arlodotexe in #493
  • Disable roll-forward to fix spontaneous CI build failure. by @Arlodotexe in #826
  • Update .NET SDK to 9.0.310 and use global.json for CI version control by @Arlodotexe in #827
  • Enable procdump first-chance exception monitoring for WinUI 3 test diagnostics by @Arlodotexe in #828

New Contributors

Full Changelog: v8.2.251219...v8.3.260211-preview1

v8.2.251219

20 Dec 01:08

Choose a tag to compare

What's Changed

An incremental update of various fixes atop the 8.2 release: 8.2.251219.

For changes since 8.1, see the full 8.2 release notes here. Below are changes since 8.2.250402.

Bug Fixes

Infrastructure

  • Refactor project reference generation to include test projects by @Arlodotexe in #684
  • Update Uno Behaviors to 3.0.3 by @Arlodotexe in #693
  • Install .NET 6 SDK to re-enable XAML Styler by @Arlodotexe in #729
  • Remove net6.0 install for Xaml-Style-Check CI job, update xamlstyler by @Arlodotexe in #733
  • Pin to windows-2022 runners by @Arlodotexe in #737
  • Replace Task.Delay with CompositionTargetHelper in RichSuggestBox tests by @Copilot in #753
  • Bump uno-check to latest stable version by @Arlodotexe in #758

New Contributors

Full Changelog: v8.2.250402...v8.2.251219

Windows Community Toolkit Labs 🧪

As always, be sure to follow the Windows Community Toolkit Labs releases for the latest new controls and experiments getting worked on! Now published to NuGet as well! See updates in that release feed here.

Share on Social

X/Twitter
Bluesky
Mastodon

v8.2.250402

02 Apr 21:44

Choose a tag to compare

See more information on our release blog here

What's Changed

This release adds support for Native AOT and UWP for .NET 9. As well as improvements to SwitchPresenter and adds SwitchConverter among other APIs, see the blog for a breakdown. Individual changes since 8.1 below.

Important Changes

Dependencies/TFM

The Toolkit's dependencies have been updated to WindowsAppSDK 1.6 and Uno Platform 5.5 versions to take in fixes and updates we needed to support .NET 8 and address other issues within the Toolkit. As usual, the Toolkit should be forward compatible with minor versions of these libraries and frameworks.

We've also updated our Win2D dependency in this PR which now means the base TFM required for building is again 19041 and should work with the default WinUI templates. We know this caused a lot of confusion for folks with the 8.1 release.

Note: We've also updated to XAML Behaviors 3.0 which unifies the namespaces for behaviors, you'll need to apply that alignment when upgrading to change Microsoft.Xaml.Interactions.Core to Microsoft.Xaml.Interactivity.

Highlights

Samples/Docs

Bug Fixes

Infrastructure

New Contributors

Any known AOT issues are tracked here, please open new issues for any not on that list if you discover them, thank you.

Full Changelog: v8.1.240916...v8.2.250402

[Pre-release] v8.2.250129-preview2

28 Jan 20:07
9830e43

Choose a tag to compare

Pre-release

What's Changed

This pre-release adds initial preview support for UWP support for .NET 9. Please let us know if you encounter any issues whether or not you're using this framework.

New Features

Bug Fixes

Documentation

Infrastructure

New Contributors

Full Changelog: v8.2.241112-preview1...v8.2.250129-preview2

See prior pre-release notes: https://github.com/CommunityToolkit/Windows/releases/tag/v8.2.241112-preview1

[Pre-release] v8.2.241112-preview1

14 Nov 04:53

Choose a tag to compare

Pre-release

What's Changed

You don't need to modify your TFM off of 19041 anymore! This was a problem for folks with 8.1, but has now been fixed by working with the dependency that caused this original bump, thanks everyone for the feedback! Enjoy!

New Controls

Native AOT Support

For a remaining list of known issues with AOT, see this issue. Most are with specific samples vs. components, we're currently aware of issues with WrapLayout.

Bug Fixes

  • Updated Microsoft.Graphics.Win2D package reference to version 1.3.0, downgrade TFM back to 19041 by @Arlodotexe in #540
  • Enabled 'AcrylicBrush' in WinUI 3 again by @Sergio0694 in #488
  • Update _toolTip even if toolTipText isn't available by @dotMorten in #479
  • chore: update typos in class properties summary by @ajpinedam in #471

Infrastructure

New Contributors

Full Changelog: v8.1.240916...v8.2.241112-preview1

v8.1.240916

16 Sep 22:37
28e6925

Choose a tag to compare

See main 8.1 release notes here

Minor hotfix

What's Changed

Full Changelog: v8.1.240821...v8.1.240916

Join discussion here

v8.1.240821

22 Aug 16:14

Choose a tag to compare

See more information on our release blog here

What's Changed

Important Changes

Dependencies/TFM

The Toolkit’s dependencies have been updated to the latest WindowsAppSDK 1.5 and Uno Platform 5.2 versions to take in fixes and updates we needed to support .NET 8 and address other issues within the Toolkit.

When consuming the Toolkit, you must target Windows version 22621 instead of the prior 18362, i.e. if you were targeting net6.0-windows10.0.18362, you would target net6.0-windows10.0.22621 instead now.

Be sure to update the TargetFramework in your csproj AND your publishing profile xml (if you have it there too).

This does not affect your ability to run down-level with the minimum target version, that remains at 17763.

Older Package NuGet Redirects

Many older 7.x and below NuGet packages of the Windows Community Toolkit have been updated to redirect to their closest matching 8.1 counterparts.

For instance:

  • Microsoft.Toolkit.Uwp.UI.Controls.Primitives now redirects to CommunityToolkit.Uwp.Controls.Primitives
  • CommunityToolkit.WinUI.UI.Controls.Primitives now redirects to CommunityToolkit.WinUI.Controls.Primitives
  • and so on for other packages.

The redirects help raise awareness about the new package names for developers who want to use the latest from the Windows Community Toolkit. You should see these notifications within Visual Studio on older projects. If you're updating from 7.x packages, see our migration guide here.

Highlights

Samples

Bug Fixes

  • [SettingsExpander] Fix CornerRadius bug by @niels9001 in #329
  • Fix: AdvancedCollection inserts at wrong position when adding to end of source collection by @Poker-sang in #309
  • Segmented - Update EqualPanel to avoid Layout Cycle by @qhy040404 in #360
  • [GridSplitter] Fix #339: resize both items when they are fixed size to avoid the change overflowing to the irrelevant Star-sized item by @abdes in #342
  • Refactor: Adaptive Column Width for StaggeredLayout by @Poker-sang in #371
  • fix: Uno Platform - Avoid square border around RangeSelector Thumbs by @MartinZikmund in #400
  • Update DockPanel.md by @mael8 in #419
  • Fix DockPanel measuring bug by @Poker-sang in #416
  • Fix IsNullOrEmptyStateTrigger for Uno to consider FEs as non-empty by @Youssef1313 in #452
  • fix: ProtectedCursor is now supported in Uno Platform by @MartinZikmund in #433

Infrastructure

New Contributors

Known Issues

  • Regression with WAP packaging projects, see: #490

Full Changelog: v8.0.240109...v8.1.240821

v8.1.240606-rc

06 Jun 18:34
efbaf96

Choose a tag to compare

v8.1.240606-rc Pre-release
Pre-release

What's Changed

Important Notes

  • There should also be a better error message now if the wrong TFM is used by a consuming project:

image

  • We may have noticed issues with the transitive dependencies for the Media packages (or possibly related to Animations package), if you notice issues where you need to install additional packages manually, please comment on this issue.

Highlights

Documentation

Infrastructure

  • Updated actions to latest version for node 20 by @Arlodotexe in #387
  • Fixed duplicate artifact names across matrices in CI by @Arlodotexe in #411
  • Fixed duplicated artifacts in CI when uploading package list by @Arlodotexe in #421

New Contributors

Full Changelog: v8.1.240328-rc...v8.1.240606-rc

For changelog of the last 8.1-rc compared to the last stable release: https://github.com/CommunityToolkit/Windows/releases/tag/v8.1.240328-rc

v8.1.240328-rc

28 Mar 23:53

Choose a tag to compare

v8.1.240328-rc Pre-release
Pre-release

What's Changed

Welcome to the 8.1-rc release of the Windows Community Toolkit! We have a lot of new and exciting updates in this release, most notably updates for our dependent framework compatibility and a couple of long-standing controls we weren't able to migrate in the original 8.0 release, ColorPicker and TabbedCommandBar, originally contributed by @robloo and @yoshiask.

If you're migrating from 7.x to 8.0, check out our main 8.0 release notes here.

You can find the 8.1.240328-rc packages on NuGet.org.

Migration Notes 📖

We had to update the WinAppSdk TFM to 22621 to resolve incompatabilies with Win2D in the Media component when we upgraded from Windows App SDK 1.3 to 1.4. The full list of notes about this change can be found here, but to summarize:

  • This won't cause issues for targeting older versions of Windows, but it will require those who depend on our packages to upgrade their TFM to net*-windows10.0.22621.0 (where star * is 6.0, 7.0 [support ending soon], or 8.0).

Dependencies/Frameworks

We've updated our packages to support the latest .NET 8.0 (windows10.0.22621.0), Windows App SDK 1.5.240311000, and Uno 5.1.87.

New Components / Features

We've brought over the popular ColorPicker and TabbedCommandBar experiences from our old codebase, enjoy! The Camera helpers have also been fixed for use on Windows App SDK, thanks @GreenShadeZhang for helping us drive understanding on changes in the platform in this space! 🎉

ImageCropper has a new feature thanks to @shatyuka! @Poker-sang added a new Spacing property to DockPanel, and GridSplitter's behavior for fixed columns was updated by @abdes! 🎉

  • Adding ColorPicker by @niels9001 in #241
  • Porting TabbedCommandBar by @niels9001 in #243
  • fix:On the Windows app SDK using CameraHelper, FrameArrived time execution for a period of time will not be triggered. by @GreenShadeZhang in #376
  • Add overlay to ImageCropper by @shatyuka in #364
  • [GridSplitter] Fix #339: resize both items when they are fixed size to avoid the change overflowing to the irrelevant Star-sized item by @abdes in #342
  • [SettingsExpander] Support FontFamily by @niels9001 in #333
  • Enhance: Add spacing properties for DockPanel by @Poker-sang in #346
  • [SwitchPresenter] Sample as a loader replacement by @niels9001 in #285
  • Adding new Segmented sample by @niels9001 in #236

Infrastructure

Ongoing updates/intermediary commits/improvements to the Toolkit's underlying tooling.

Bug Fixes

Other important fixes and updates to AdvancedCollectionView from @Poker-sang and a Layout Cycle issue for the Segmented control by @qhy040404! 🎉

  • Fix: AdvancedCollection inserts at wrong position when adding to end of source collection by @Poker-sang in #309
  • Added missing package descriptions by @Arlodotexe in #362
  • Disable Implicit animations (unsupported) when running under Uno by @Arlodotexe in #326
  • [SettingsExpander] Fix CornerRadius bug by @niels9001 in #329
  • Segmented - Update EqualPanel to avoid Layout Cycle by @qhy040404 in #360
  • Refactor: Adaptive Column Width for StaggeredLayout by @Poker-sang in #371

New Contributors 🎉

Thanks to all our new contributors this release for helping us to improve the Windows Community Toolkit for everyone!

Full Changelog: v8.0.240109...v8.1.240328-rc

If you find any issues with this pre-release, please comment in the discussion and open an issue to let us know.

v8.0.240109

10 Jan 00:04

Choose a tag to compare

What's Changed

  • [SettingsControls] Bugfix for wrapping states by @niels9001 in #252
  • Fixed compositor nullreference in WinUI 3 by @Arlodotexe in #299
  • Fixing crash when setting empty string for SettingsCard's Header and Description by @Dub1shu in #312
  • [SettingsCard] Accesibility improvements by @niels9001 in #284
  • Fix ExpressionFunctions.ColorLerpRgb by @h82258652 in #304

New Contributors

Misc Updates

NuGet

Full Changelog: v8.0.230907...v8.0.240109