v8.2.250402

[michael-hawker]

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 shoulbe 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

• Updated to WinAppSdk 1.6, fixed AoT annotations by @Arlodotexe in Updated to WinAppSdk 1.6, fixed AoT annotations #457
• Refactor MultiTarget, fix consuming uwp from net9.0-windows by @Arlodotexe in Refactor MultiTarget, fix consuming uwp from net9.0-windows #591
• SwitchPresenter 2.0 and the new SwitchConverter 🦙❤️ by @michael-hawker in SwitchPresenter 2.0 and the new SwitchConverter 🦙❤️ #550
• Enable 'AcrylicBrush' in WinUI 3 again by @Sergio0694 in Enable 'AcrylicBrush' in WinUI 3 again #488
• Improvements to DispatcherQueueTimer.Debounce extension by @michael-hawker in Improvements to DispatcherQueueTimer.Debounce extension #569

Samples/Docs

• Erinwoo/media samples by @michael-hawker in Erinwoo/media samples #654
• Updated readme by @niels9001 in Updated readme #652
• Fixed AoT data binding in IncrementalLoadingCollectionSample by @Arlodotexe in Fixed AoT data binding in IncrementalLoadingCollectionSample #531
• Fixes AdvancedCollectionView items are empty in gallery sample under Windows App SDK #513 - AdvancedCollectionView not working with NativeAoT by @michael-hawker in Fixes #513 - AdvancedCollectionView not working with NativeAoT #535
• Fix invalid XML comment in SettingsExpander by @michael-hawker in Fix invalid XML comment in SettingsExpander #646
• chore: update typos in class properties summary by @ajpinedam in chore: update typos in class properties summary #471
• Fixed a small typo by @HotCakeX in Fixed a small typo #586
• Fixed a typo by @HotCakeX in Fixed a typo #588

Bug Fixes

• Update _toolTip even if toolTipText isn't available by @dotMorten in Update _toolTip even if toolTipText isn't available #479
• Fix: DockPanel measure fix by @Poker-sang in Fix: DockPanel measure fix #618
• Hook up TokenizingTextBox AutoSuggestBoxStyle by @miksalmon in Hook up TokenizingTextBox AutoSuggestBoxStyle  #657
• Fix issue with Windows 11 ListViewStyle by @TopperDEL in Fix issue with Windows 11 ListViewStyle #566
• Fix: StaggeredLayout division bug by @Poker-sang in Fix: StaggeredLayout division bug #574
• Fix: prevent StaggeredLayout floating point errors by @Poker-sang in Fix: prevent StaggeredLayout floating point errors #573
• Fix analyzer warnings for CsWinRTAotWarningLevel 2 by @Arlodotexe in Fix analyzer warnings for CsWinRTAotWarningLevel 2 #507
• Updated Win2d, fixed AttachedCardShadow under NativeAoT by @Arlodotexe in Updated Win2d, fixed AttachedCardShadow under NativeAoT #526
• Fix: ColorPicker Binding failed by @Poker-sang in Fix: ColorPicker Binding failed #579

Infrastructure

• Update Directory.Build.props to Version 8.2 by @michael-hawker in Update Directory.Build.props to Version 8.2 #483
• Fixed Codespace container build failure by @Arlodotexe in Fixed Codespace container build failure  #458
• Update Microsoft.WindowsAppSDK to 1.6-preview2 by @Arlodotexe in Update Microsoft.WindowsAppSDK to 1.6-preview2 #492
• Update Microsoft.WindowsAppSdk to 1.6 stable by @Arlodotexe in Update Microsoft.WindowsAppSdk to 1.6 stable #503
• Run CI when merging to dev/* branches by @Arlodotexe in Run CI when merging to dev/* branches #504
• Run CI when pushing to dev/* branches by @Arlodotexe in Run CI when pushing to dev/* branches #505
• Merge patch 8.1.240916 into main by @Arlodotexe in Merge patch 8.1.240916 into main #508
• Fixed failed NuGet validation due to webview2 reference by @michael-hawker in Fixed failed NuGet validation due to webview2 reference #521
• Update Microsoft.Graphics.Win2D package reference to version 1.3.0, downgrade TFM back to 19041 by @Arlodotexe in Update Microsoft.Graphics.Win2D package reference to version 1.3.0, downgrade TFM back to 19041  #540
• Update config.yml by @Arlodotexe in Update config.yml #539
• Update tooling pointer, bump global.json to 8.0.403 by @Arlodotexe in Update tooling pointer, bump global.json to 8.0.403 #541
• Specify directory for dotnet to install to and execute from. by @Arlodotexe in Specify directory for dotnet to install to and execute from. #567
• Update tooling pointer by @michael-hawker in Update tooling pointer #572
• Fix solution generation via default .bat by @Arlodotexe in Fix solution generation via default .bat #580
• Enable .NET 8 for uwp MultiTarget, upgrade packages by @Arlodotexe in Enable .NET 8 for uwp MultiTarget, upgrade packages #584
• Fixed an issue where ExcludeMultiTargets wasn't working as expected by @Arlodotexe in Fixed an issue where ExcludeMultiTargets wasn't working as expected #592
• Bump Win2D dependencies by @Sergio0694 in Bump Win2D dependencies #594
• Bump tooling pointer by @Sergio0694 in Bump tooling pointer #595
• Fix sudden CI errors by @Arlodotexe in Fix sudden CI errors #609
• Update XamlBehaviors to 3.0.0 by @Sergio0694 in Update XamlBehaviors to 3.0.0 #613
• Update WinUI 2 to 2.8.7 stable by @Sergio0694 in Update WinUI 2 to 2.8.7 stable #620
• Fixes solution generation issues by updating slngen by @Arlodotexe in Fixes solution generation issues by updating slngen #638
• Update tooling with latest fixes and improvements by @Arlodotexe in Update tooling with latest fixes and improvements #645
• Align RootNamespace across tests to remove "Experiment" suffix by @Arlodotexe in Align RootNamespace across tests to remove "Experiment" suffix #659
• Removed the MainLatest feed from nuget.config by @Arlodotexe in Removed the MainLatest feed from nuget.config #666

New Contributors

• @Sergio0694 made their first contribution in Enable 'AcrylicBrush' in WinUI 3 again #488
• @dotMorten made their first contribution in Update _toolTip even if toolTipText isn't available #479
• @ajpinedam made their first contribution in chore: update typos in class properties summary #471
• @TopperDEL made their first contribution in Fix issue with Windows 11 ListViewStyle #566
• @HotCakeX made their first contribution in Fixed a small typo #586
• @miksalmon made their first contribution in Hook up TokenizingTextBox AutoSuggestBoxStyle  #657

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

---

This discussion was created from the release v8.2.250402.

[SongOfYouth]

When will you release the preview components, some of them have existed for a long time....

[michael-hawker]

Many of them are still just initial experiments. There's a variety of factors that determine when something is ready to move forward, including interest/usage, completeness, samples/docs, and usually the thing that's missing the most: tests. I've asked @Arlodotexe to clean-up the info here in the Labs repo about the process: https://github.com/CommunityToolkit/Labs-Windows/tree/main?tab=readme-ov-file#when-is-an-experiment-done

If anyone wants to champion finalizing components and ensuring they meet the bars to include in the main repo, then please let us know.

In the meantime, we are investigating making labs components more accessible by publishing their preview packages to NuGet.

[jp-weber]

Will lottie also be updated to the latest version soon? https://github.com/CommunityToolkit/Lottie-Windows/releases

[Balkoth]

Where is a list of breaking changes?

[michael-hawker]

The only thing we're aware of is from the underlying dependency and updating XAML Behaviors to 3.0 (which unified its namespace), I've added it to the dependency notes, but we haven't changed our API surface, AFAIK.

[Balkoth]

Thanks i tripped exactly over this one.