Releases: CommunityToolkit/Maui
12.3.0: Minor fixes and no upper MAUI version restriction
This version brings some minor fixes (but still very important!) and removes the upper version restriction for Microsoft.Maui.Controls. Although it is not officially supported, you may now use the .NET MAUI Community Toolkit with the .NET 10 preview.
Thank you for using the .NET MAUI Community Toolkit!
What's Changed
- Provide an extension method to detect if popup was previous page by @bijington in #2767
- Fix memory leak on popups by @pictos in #2858
- Update BindablePropertySourceGenerator to use partial properties by @pictos in #2835
Requirements
The following tools are now required for CommunityToolkit.Maui:
- Download/install .NET SDK v9.0.306
- Install Xcode 26.0.1 (or higher)
- Read the latest .NET MAUI Release wiki to always find the latest-supported version) of Xcode for .NET MAUI
- We HIGHLY recommend using the open-source tool Xcodes to easily manage your installed Xcode versions
- Update to the latest stable version of Visual Studio (or Jet Brains Rider)
- After installing the latest stable .NET SDK, update to the latest stable version of the .NET MAUI workload:
- On macOS, open the Terminal and enter the following command:
sudo dotnet workload install maui; sudo dotnet workload update - On Windows, open the command prompt (or Powershell) and enter the following command:
dotnet workload install maui && dotnet workload update
- On macOS, open the Terminal and enter the following command:
- Add a
global.jsonfile to your application with the following parameters to ensure you're not using a unsupported preview version of .NET (example below)- The .NET MAUI Community Toolkit does not provide support for preview releases of .NET
global.json
{
"sdk": {
"version": "9.0.306",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}Full Changelog: 12.2.0...12.3.0
6.1.3 MediaElement: blockbuster bugfixes!
What's Changed
- Fix Media Element Full Screen in Windows when using Multiple Windows by @ne0rrmatrix in #2506
- Fix Windows Media Source bug with Packaged Apps by @ne0rrmatrix in #2609
- Add missing media3 Stub
OnPositionDiscontinuityback to Android Med… by @ne0rrmatrix in #2825 - Fix MediaElement not working on FlyoutPage in IOS/MAC Catalyst by @ne0rrmatrix in #2532
- Fix Media Element fails to load a URL by @ne0rrmatrix in #2265
Requirements
The following tools are now required for CommunityToolkit.Maui.MediaElement:
- Download/install .NET SDK v9.0.306
- Install Xcode 26.0.1 (or higher)
- Read the latest .NET MAUI Release wiki to always find the latest-supported version) of Xcode for .NET MAUI
- We HIGHLY recommend using the open-source tool Xcodes to easily manage your installed Xcode versions
- Update to the latest stable version of Visual Studio (or Jet Brains Rider)
- After installing the latest stable .NET SDK, update to the latest stable version of the .NET MAUI workload:
- On macOS, open the Terminal and enter the following command:
sudo dotnet workload install maui; sudo dotnet workload update - On Windows, open the command prompt (or Powershell) and enter the following command:
dotnet workload install maui && dotnet workload update
- On macOS, open the Terminal and enter the following command:
- Add a
global.jsonfile to your application with the following parameters to ensure you're not using a unsupported preview version of .NET (example below)- The .NET MAUI Community Toolkit does not provide support for preview releases of .NET
global.json
{
"sdk": {
"version": "9.0.306",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}Full Changelog: 12.2.0...6.1.3-mediaelement
4.0.0 Camera: video recording is here!
Maybe the most anticipated functionality for our camera package is finally here: you can now record videos with the CameraView!
What's Changed
- Camera Video Recording by @VladislavAntonyuk in #2710
- Fix camera view app crashes when switching camera on windows by @TheCodeTraveler in #2907
- Fix camera package fails to build with latest Maui version by @ne0rrmatrix in #2916
Requirements
The following tools are now required for CommunityToolkit.Maui.Camera:
- Download/install .NET SDK v9.0.306
- Install Xcode 26.0.1 (or higher)
- Read the latest .NET MAUI Release wiki to always find the latest-supported version) of Xcode for .NET MAUI
- We HIGHLY recommend using the open-source tool Xcodes to easily manage your installed Xcode versions
- Update to the latest stable version of Visual Studio (or Jet Brains Rider)
- After installing the latest stable .NET SDK, update to the latest stable version of the .NET MAUI workload:
- On macOS, open the Terminal and enter the following command:
sudo dotnet workload install maui; sudo dotnet workload update - On Windows, open the command prompt (or Powershell) and enter the following command:
dotnet workload install maui && dotnet workload update
- On macOS, open the Terminal and enter the following command:
- Add a
global.jsonfile to your application with the following parameters to ensure you're not using a unsupported preview version of .NET (example below)- The .NET MAUI Community Toolkit does not provide support for preview releases of .NET
global.json
{
"sdk": {
"version": "9.0.306",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}Full Changelog: 12.2.0...4.0.0-camera
v12.2.0: More Popup fixes!
Some more fixes related to Popup and then some... Also, this release reinstates the assembly versioning that got lost in translation somewhere. Most people probably didn't even notice or care. But if you're one of the people who does... Now its fixed!
What's Changed
- Adds installation instructions to README by @VladislavAntonyuk in #2797
- Fire
Action PopupOptions.OnTappingOutsideOfPopupwhen Android Back Button Pressed by @TheCodeTraveler in #2799 - Prevent Popup From Being Dismissed when Tapped Inside Popup by @bijington in #2800
- Reinstate assembly versioning by @jfversluis in #2837
- Refactor TextCaseConverter and enhance ListToStringConverterTests by @waheez in #2840
- Fix typo in the example label text on IsInRangeConverterPage by @ruyut in #2846
New Contributors
Full Changelog: 12.1.0...12.2.0
v6.1.2 MediaElement: very minor bugfix
Very minor release which reinstates the assembly versioning that got lost in translation somewhere. Most people probably didn't even notice or care. But if you're one of the people who does... Now its fixed!
What's Changed
- Reinstate assembly versioning by @jfversluis in #2837
Full Changelog: 12.1.0...6.1.2-mediaelement
v3.0.3 Maps: very minor bugfix
Very minor release which reinstates the assembly versioning that got lost in translation somewhere. Most people probably didn't even notice or care. But if you're one of the people who does... Now its fixed!
What's Changed
- Reinstate assembly versioning by @jfversluis in #2837
Full Changelog: 12.1.0...3.0.3-maps
v3.0.2 Camera: very minor bugfix
Very minor release which reinstates the assembly versioning that got lost in translation somewhere. Most people probably didn't even notice or care. But if you're one of the people who does... Now its fixed!
What's Changed
- Reinstate assembly versioning by @jfversluis in #2837
Full Changelog: 12.1.0...3.0.2-camera
v12.1.0: Popup V2 bugfixes!
What's Changed
- Restrict AddPopup extensions to View to avoid ContentPage from being allowed by @bijington in #2715
- [Popup] Properly handle Android Back Button pressed by @TheCodeTraveler in #2716
- Speech Recognition Windows Ensure unsubscribe from events on Stop Recording by @VladislavAntonyuk in #2705
- Prevent a tap inside the content from closing a popup by @bijington in #2741
- [Popup] Add
Popup.CanBeDismissedByTappingOutsideOfPopupby @TheCodeTraveler in #2753 - ShowPopupAsync will now correctly return once the popup is closed under heavy garbage collection by @bijington in #2756
- Remove exception swallowing and update tests to exhibit expected behaviour by @bijington in #2749
- Fix: .UseMauiCommunityToolkit() Analyzer when wrapped in preprocessor directives by @IeuanWalker in #2769
- Publish main to github nuget by @VladislavAntonyuk in #2760
- [Popup] Add
DefaultPopupOptionsSettingsandDefaultPopupSettingsto.UseMauiCommunityToolkit(Options)by @TheCodeTraveler in #2759 - [Popup] Add
ComplexPopuptoCommunityToolkit.Maui.Sampleby @TheCodeTraveler in #2771 - Fix Windows Snackbar Registration by @ne0rrmatrix in #2755
Requirements
The following tools are now required for CommunityToolkit.Maui:
- Download/install .NET SDK v9.0.300
- Install Xcode 16.2.0 (or higher)
- Read the latest .NET MAUI Release wiki to always find the latest-supported version) of Xcode for .NET MAUI
- We HIGHLY recommend using the open-source tool Xcodes to easily manage your installed Xcode versions
- Update to the latest stable version of Visual Studio (or Jet Brains Rider)
- After installing the latest stable .NET SDK, update to the latest stable version of the .NET MAUI workload:
- On macOS, open the Terminal and enter the following command:
sudo dotnet workload install maui; sudo dotnet workload update - On Windows, open the command prompt (or Powershell) and enter the following command:
dotnet workload install maui && dotnet workload update
- On macOS, open the Terminal and enter the following command:
- Add a
global.jsonfile to your application with the following parameters to ensure you're not using a unsupported preview version of .NET (example below)- The .NET MAUI Community Toolkit does not support preview releases of .NET
global.json
{
"sdk": {
"version": "9.0.300",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}Full Changelog: 12.0.0...12.1.0
v6.1.1 MediaElement: Minor Bugfix
Note that there was a problem with the 6.1.0 version number on NuGet, this was posted as 6.1.0-mediaelement which made it show up as a pre-prerelease.
What's Changed
- Fix MediaElement in Sample App by @ne0rrmatrix in #2788
- Fix Windows Media Element Controls by @ne0rrmatrix in #2680
Full Changelog: 12.0.0...6.1.1-mediaelement
v3.0.1 Camera: Camera Image Stream Improvements!
Note that there was a problem with the 3.0.0 version number on NuGet, this was posted as 3.0.0-camera which made it show up as a pre-prerelease.
What's Changed
- Return Camera Image (
Stream) fromICameraView.CaptureImage()by @TheCodeTraveler in #2695 - Small error in the CameraViewDefaults API docs by @jfversluis in #2735
Full Changelog: 12.0.0...3.0.1-camera