v8.1.240821

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

• Adding ColorPicker by @niels9001 in #241
• Porting TabbedCommandBar by @niels9001 in #243
• Add overlay to ImageCropper by @shatyuka in #364
• fix:On the Windows app SDK using CameraHelper, FrameArrived time execution for a period of time will not be triggered. by @GreenShadeZhang in #376
• [SettingsExpander] Support FontFamily by @niels9001 in #333
• Enhance: Add spacing properties for DockPanel by @Poker-sang in #346
• Update Microsoft.WindowsAppSdk to latest stable 1.5 by @Arlodotexe in #354
• Update to Uno 5.x by @Arlodotexe in #311
• Add net8.0-windows to WinAppSdk by @Arlodotexe in #328

Samples

• [SwitchPresenter] Sample as a loader replacement by @niels9001 in #285
• Adding new Segmented sample by @niels9001 in #236

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

• Upgrade to latest stable WinAppSdk 1.4 by @Arlodotexe in #300
• Update uno-check to 1.18.1 by @Arlodotexe in #320
• Cleanup project references by @Arlodotexe in #318
• Update WinAppSdk to latest 1.4.4 (1.4.231219000) by @Arlodotexe in #314
• Disable Implicit animations when running under Uno by @Arlodotexe in #326
• Fix CI failure after update to PowerShell 7.4.0 by @Arlodotexe in #330
• Fixed PackageId being overridden by MSBuild.Sdk.Extras import by @Arlodotexe in #352
• Upgrade to C# Dev Kit by @Arlodotexe in #353
• Update Uno to 5.1.75 by @Arlodotexe in #355
• Update Microsoft.WindowsAppSDK to 1.5.240311000 by @Arlodotexe in #369
• Added missing package descriptions by @Arlodotexe in #362
• Updated Uno to 5.1.87 by @Arlodotexe in #370
• Updated tooling to latest main by @Arlodotexe in #382
• Updated actions to latest version for node 20 by @Arlodotexe in #387
• Updated tooling to latest main by @Arlodotexe in #399
• Documentation fixup for v8.1 by @Arlodotexe in #398
• Fixed duplicate artifact names across matrices in CI by @Arlodotexe in #411
• Fixed remaining Microsoft Learn doc warnings by @Arlodotexe in #410
• Fixed duplicated artifacts in CI when uploading package list by @Arlodotexe in #421
• Enable AoT for net8 in Release by @Arlodotexe in #417
• Update Uno version, Uno TFMs to .NET 8 by @Arlodotexe in #422
• Update dotnet-tools.json - slngen to 11.2.6 by @michael-hawker in #442
• MultiTarget Matrix for CI, support for solution generation by @Arlodotexe in #456
• Update build requirements in readme by @Arlodotexe in #476

New Contributors

• @qhy040404 made their first contribution in #360
• @shatyuka made their first contribution in #364
• @abdes made their first contribution in #342
• @GreenShadeZhang made their first contribution in #376
• @MartinZikmund made their first contribution in #400
• @mael8 made their first contribution in #419
• @Youssef1313 made their first contribution in #452

Known Issues

• Regression with WAP packaging projects, see: #490

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