v9.0.1: Bugfixes! That's it, that's the release.

Just a couple of bugfixes for you to enjoy!

No fancy funny text here this time, sorry. It's Friday for me too you know?!

What's Changed

• issue-1884-fix-snackbar-anchoring-ios: Attach snackbar to top anchor … by @raginmari in #1896
• Fixing crash in IconTintColorBehavior by @PaulNiemiec in #1883
• [housekeeping] Automated PR to fix formatting errors by @github-actions in #1902
• Add PresentationStyle by @cat0363 in #1892
• [housekeeping] Automated PR to fix formatting errors by @github-actions in #1915

New Contributors

• @raginmari made their first contribution in #1896
• @PaulNiemiec made their first contribution in #1883

Full Changelog: 9.0.0...9.0.1

v9.0.0: Breaking Bugfixes

Version 9! That must mean amazing new goodies! 😱

Unfortunately, no. Although every release of the Toolkit is a party of its own, for this release there are a couple of bugfixes that required breaking changes and therefore we bumped the version up to 9.

However, is XAML and converters are your jam, then be sure to check out the improvements in usage with CompareConverter. @bijington has done some great work with that and you can find the documentation for that right here.

Find all the details below, if you have any questions or concerns, please let us know!

You might also like the .NET MAUI Community Toolkit standup live stream recording for May. Join us live and come hang out every first Thursday of every month on the .NET Foundation YouTube channel!

As always, many thanks to our contributors for this version, especially the community ones 👏 you are our heroes!

Breaking Changes

Replace FrozenSet with IReadOnlyList

By @brminnick in #1839

This was breaking because it changed the signature of some public APIs:

AlertView.macios.cs changed the Children property from:

public FrozenSet<UIView> Children

to

public IReadOnlyList<UIView> Children

Improve the usage experience with CompareConverter in XAML

By @bijington in #1841

This change is breaking because CompareConverter now takes 2 type arguments.

It went from

public abstract class CompareConverter<TReturnObject> : BaseConverterOneWay<IComparable, object>

to

public abstract class CompareConverter<TValue, TReturnObject> : BaseConverterOneWay<TValue, object> where TValue : IComparable

NOTE this is only breaking if you inherited from CompareConverter.

What's Changed

• Fix Android AvatarView Image BackgroundColor by @TRybina132 in #1786
• Fixes Snackbar and Toast on iOS release builds by @mjo151 in #1767
• Update Touch Behavior Sample by @Axemasta in #1784

🥱

• FabricBot: Onboarding to GitOps.ResourceManagement because of FabricBot decommissioning by @dotnet-policy-service in #1675
• [housekeeping] Automated PR to fix formatting errors by @github-actions in #1821
• [Housekeeping] Use Collection Expressions by @brminnick in #1792
• [housekeeping] Automated PR to fix formatting errors by @github-actions in #1840
• [housekeeping] Automated PR to fix formatting errors by @github-actions in #1843
• [housekeeping] Automated PR to fix formatting errors by @github-actions in #1848

New Contributors

• @dotnet-policy-service made their first contribution in #1675
• @mjo151 made their first contribution in #1767
• @tsanie made their first contribution in #1827
• @mikelor made their first contribution in #1817

Full Changelog: 8.0.1...9.0.0

v3.1.1 MediaElement: 🙅 say no to bugs!

Our beloved MediaElement is getting some attention lately, so here is a new bugfix release with some improvements ✨

Thank you @tsanie for your contribution to this project!

What's Changed

• Fix problem that ErrorCode always overwritten by ErrorCodeName. (Android) by @tsanie in #1827
• Fix Back button behavior when Media Element is full screen by @ne0rrmatrix in #1761
• Fix AVPlayer Crash on IOS 16.x and 17.x by @ne0rrmatrix in #1813
• Fix Media Element Android Layout by @ne0rrmatrix in #1814

New Contributors

• @tsanie made their first contribution in #1827

Full Changelog: 8.0.1...3.1.1-mediaelement

v2.0.2 Windows Maps: User Location Fix

Just the one fix by our amazing community member @mikelor (thank you!) that fixes a bug for showing the users location. But we didn't want to keep this from you, so here is a release just to get this bug out of your way!

What's Changed

• Fix Windows Map control no longer displays the User's Location Pin after adding a Pin to the Map when IsShowingUser is set to True #1801 by @mikelor in #1817

New Contributors

• @mikelor made their first contribution in #1817

Full Changelog: 8.0.1...2.0.2-maps

v8.0.1: TouchBehavior (and all Behaviors) Hotfix

By implementing TouchBehavior we found out that the databinding for it was a bit odd and went to investigate why.

The good news is: we found it! 🎉

The bad news is: it applied to all of our behaviors 🙈

We quickly fixed it and rolling it out as a minor release. Technically it's a breaking change, but we expect not many people to be impacted by that. If we thought wrong: our sincere apologies.

Check the PR below for all the details, TL;DR is data binding for behaviors is now a lot easier!

What's Changed

• For All CommunityToolkit.Maui.Behaviors, Ensure BindingContext Is Automatically Set to the Attached View's BindingContext by @brminnick in #1791

Full Changelog: 8.0.0...8.0.1

v8.0.0: Can Touch This! TouchBehavior is Here!

TouchBehavior is here!

The release a lot of people have been waiting for is here. Version 8.0 of the .NET MAUI Community Toolkit introduces the ever popular TouchBehavior! You might know TouchBehavior as TouchEffect in the Xamarin world, but since Effects no longer exist, it has now been turned into a Behavior.

Due to the amazing work of @Axemasta this functionality is now ported from the Xamarin Community Toolkit to .NET MAUI. Of course, @bijington was on the case with the documentation, so we have that in place for you as well.

Breaking Snackbar on Windows

Otherwise, there is A LOT going on in this release, just look at the list below. There is however one thing we do want to highlight: the breaking changes for Snackbar.

Based on your feedback @VladislavAntonyuk did a complete rewrite of the Snackbar on Windows, ultimately of course to make things better, but it requires some changes on your side if you are working with Snackbar on Windows today. On other platforms it should work unchanged.

Find all the details in our updated documentation for this.

NavigationBar coloring for Android

Another functionality that was ported over from the Xamarin Community Toolkit is the NavigationBar coloring. This is very specific to Android and allows you to change the color of the systems navigation bar (the bottom one with the back button, home button, etc.)

@pictos did a great job on this one figuring out how to fit this into our toolkit 👏

Find all the docs on how to start using it, right here.

Thank you contributors!

Of course we couldn't have done this without our amazing community and team, a major feature like TouchBehavior being implemented by someone from the community is what this project is all about. Truly amazing.

Special shoutout to our first-time contributors: @Marioo1357, @eduardoagr, @StevilKnevil, @Cybrosys, @marco-skizza and @Axemasta but of course a BIG THANK YOU to all of you!

Big Ol' List of Changes

• Android File Saver - remove MemoryStream by @VladislavAntonyuk in #1637
• Avatar sample updated to include badges by @vhugogarcia in #1636
• 🔥 FIX - fix unit tests by @pictos in #1694
• Memory leak on TintedImageBehavior fix by @Marioo1357 in #1625
• [First - PlatformSpecific] NavigationBar for Android by @pictos in #1678
• Add missing Handler disconnect on Unloaded event by @ne0rrmatrix in #1691
• Fix IOS bug in media Element when using Popup by @ne0rrmatrix in #1597
• Modify ColorConverters to support two-way bindings by @eduardoagr in #1544
• Fixed issue with tinted image size being set incorrectly on Windows. by @StevilKnevil in #1685
• Fix Hot Reload with Popup by @BretJohnson in #1635
• Remove Bindings on Popup Close by @cat0363 in #1614
• Windows Snackbar rewrite by @VladislavAntonyuk in #1658
• Updated StatusBarBehavior to support defining which lifecycle event to use in applying the changes by @Cybrosys in #1471
• Remove the old code to set the status bar behavior values by @bijington in #1713
• Close Stream #1588 by @VladislavAntonyuk in #1751
• SpeechRecognition Add more categories for AudioSession #1645 by @VladislavAntonyuk in #1741
• FileSaver Progress by @VladislavAntonyuk in #1740
• Remove popup shadow on iOS 17 by @cat0363 in #1615
• Change to display Popup on Active Window page on Windows by @cat0363 in #1617
• Add popup size update on iOS by @cat0363 in #1653
• Fix an issue with Popup size and position on Android by @cat0363 in #1683
• Add popup sizing page to cover more test scenarios by @bijington in #1770
• Fix IOS crash when entering Full Screen by @ne0rrmatrix in #1755
• Add TouchBehavior by @Axemasta in #1673
• Add Platform-Specific Option to Enable Snackbar on Windows by @brminnick in #1780

Swept Under the Rug 🧹

• [Sample App] Add Microsoft.Extensions.Http.Resilience by @brminnick in #1643
• [housekeeping] Automated PR to fix formatting errors by @github-actions in #1563
• [housekeeping] Automated PR to fix formatting errors by @github-actions in #1696
• Increase Microsoft.Maui.* Dependencies to v8.0.7 by @brminnick in #1699
• [housekeeping] Automated PR to fix formatting errors by @github-actions in #1701
• [housekeeping] Automated PR to fix formatting errors by @github-actions in #1714
• [housekeeping] Automated PR to fix formatting errors by @github-actions in #1754
• [housekeeping] Automated PR to fix formatting errors by @github-actions in #1759
• [housekeeping] Automated PR to fix formatting errors by @github-actions in #1763
• Also update Maps NuGet version number for PR builds by @jfversluis in #1772
• Increase to latest MauiPackageVersion, v8.0.14 by @brminnick in #1774
• [Housekeeping] Update NuGet Packages by @brminnick in #1775

New Contributors

• @Marioo1357 made their first contribution in #1625
• @eduardoagr made their first contribution in #1544
• @StevilKnevil made their first contribution in #1685
• @Cybrosys made their first contribution in #1471
• @marco-skizza made their first contribution in #1736
• @Axemasta made their first contribution in #1673

Full Changelog: 7.0.1...8.0.0

v2.0.1 Windows Maps: bugfix for crash!

This release fixes a crash that was introduced when updating .NET MAUI to version 8.0.10.

As part of this change in .NET MAUI, the initialisation call for the .NET MAUI Community Toolkit Maps would also crash because the Toolkit was call the .NET MAUI UseMauiMaps call as part of the initialisation.

This call was not needed, but until now did not cause any problems. We removed the call and thus fixed the crash.

More information can be found here: dotnet/maui#21360

To correctly initialise the .NET MAUI Maps as well as the Toolkit Maps you MauiProgram should look something like this:

  var builder = MauiApp.CreateBuilder();
  builder
	  .UseMauiApp<App>()
	  .ConfigureFonts(fonts =>
	  {
		  fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
		  fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
	  });

    #if IOS || ANDROID
    builder.UseMauiMaps();
    #endif
    
    #if WINDOWS
    // Initialize the .NET MAUI Community Toolkit Maps by adding the below line of code
    builder.UseMauiCommunityToolkitMaps("key")
    #endif

   return builder.Build();

v3.1.0 MediaElement: fullscreen support is finally here!

Years in the making but here it is! Fullscreen support for our MediaElement 🤯 A big shoutout to @ne0rrmatrix and @vhugogarcia but also @pictos @bijington and @brminnick for all their work, reviews and probably some blood, sweat, tears, the occasional fights with partners, sacrifices to the binary father and who knows what else.

Also as part of the fullscreen change you should now be able to use MediaElement when using Shell, not using Shell, inside of a CollectionView, etc. Also something many people have been waiting for.

Please note that we did update the MediaElement docs with a note about using fullscreen on Android, so be sure to read that.

Go grab this release and try it out in your apps!

What's Changed

• Fix IOS bug in media Element when using Popup by @ne0rrmatrix in #1597
• Media Element Full Screen Support for Android and Windows by @vhugogarcia in #1692
• Fixes #1702: Fixed Memory Leak in MediaElement by @marco-skizza in #1736

Full Changelog: 3.0.1-mediaelement...3.1.0-mediaelement

7.0.1: Last Update of 2023!

Happy holidays for those of you who celebrate! In the meanwhile, we're not clowning around and present to you the last release of 2023.

This version has a good number of bugfixes and improvements, but nothing too crazy so that it might blow up your project before you go on a holiday break. As always a big thank you to anyone and everyone not only using our product but also caring, engaging and even contributing. We appreciate it!

Let's make 2024 even better 🚀

What's Changed

• Add support for setting badge count using UNUserNotificationCenter … by @VladislavAntonyuk in #1531
• Use fully qualified namespace for Colors reference in TextToColorGenerator by @IIARROWS in #1536
• Remove SkiaSharp.Views Dependency by @JoonghyunCho in #1547
• Fix IOS/MacOS AvataView background color with image bug by @TRybina132 in #1539
• [BUG] [Windows] UniformItemsLayout item positioning not correct #1553 by @VladislavAntonyuk in #1566
• Add sample to trigger an animation using the AnimateCommand by @bijington in #1577
• Removes the transparent color set on Android when null by @vhugogarcia in #1584

We couldn't make this project work without these dependencies 🫶

• Bump CommunityToolkit.Maui.Markup from 3.3.1 to 4.0.0 in /samples by @dependabot in #1528
• Bump xunit.runner.visualstudio from 2.5.3 to 2.5.4 in /samples by @dependabot in #1540
• Bump xunit from 2.6.1 to 2.6.2 in /samples by @dependabot in #1542
• Bump Microsoft.CodeAnalysis from 4.7.0 to 4.8.0 in /samples by @dependabot in #1551
• Bump Microsoft.CodeAnalysis.CSharp.Workspaces from 4.7.0 to 4.8.0 in /samples by @dependabot in #1550
• Bump Microsoft.CodeAnalysis.CSharp from 4.4.0 to 4.8.0 in /samples by @dependabot in #1552
• Bump Microsoft.CodeAnalysis.CSharp from 4.4.0 to 4.8.0 in /samples by @dependabot in #1559

New Contributors

So many new contributors this release, thank you so much @IIARROWS, @TRybina132, @ne0rrmatrix and our very own Tizen superhero @JoonghyunCho. We appreciate all the time that you are spending on this project and making it better.

• @IIARROWS made their first contribution in #1536
• @JoonghyunCho made their first contribution in #1547
• @TRybina132 made their first contribution in #1539
• @ne0rrmatrix made their first contribution in #1537

Full Changelog: 7.0.0...7.0.1

v3.0.1 MediaElement: Bugfixes!

Some small bugfixes, but not less important, thanks for the amazing @ne0rrmatrix. Thank you!

What's Changed

• Fix Media Element Position Bug for Android and IOS by @ne0rrmatrix in #1555
• Fix Media Element crash in IOS with Sample app by @ne0rrmatrix in #1568
• Fix for MediaElement Android Resource file not found by @ne0rrmatrix in #1537
• Change HLS URL by @ne0rrmatrix in #1571
• Fix HLS CTD on Windows by @ne0rrmatrix in #1543

New Contributors

• @ne0rrmatrix made their first contribution in #1537

Full Changelog: 2.0.0-maps...3.0.1-mediaelement