Releases: CommunityToolkit/Maui
11.1.1: Minor Patch Release
You probably don't need to worry about this one, just stay on the latest version!
If you experience any issues with WinRT.Runtime conflicts between 2.1.0 and 2.2.0 then this might be something you need, but this is also fixed in the version that will come after 11.2.0.
Details: #2612
Full Changelog: 11.1.0...11.1.1
11.2.0: .NET MAUI Dependency Update & RatingView ⭐️
What's Changed
- Rating view by @GeorgeLeithead in #2191
- SpeechRecognition fixes by @VladislavAntonyuk in #2562
- Enhance copilot instructions for C# best practices by @ne0rrmatrix in #2586
- fix TouchBehavior Android KeyBoard activation by @plewm in #2497
- Enable developers to inherit from BaseBehavior and BaseConverter again by @bijington in #2573
- Run UserStoppedTypingBehavior Command on UIThread by @pictos in #2591
Requirements
The following tools are now required for CommunityToolkit.Maui:
- Download/install .NET SDK v9.0.202
- 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.json
file 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.202",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}
Le keeping the house
- [Housekeeping] Increase minimum .NET SDK dependency to v9.0.202 by @TheCodeTraveler in #2592
- [Housekeeping] Add Co-Pilot Prompts by @GeorgeLeithead in #2576
- [Housekeeping] Fix Typos in CONTRIBUTING.md by @GeorgeLeithead in #2544
- [Housekeeping] Clean up AvatarView sample namespaces by @GeorgeLeithead in #2546
- Increase
Microsoft.Maui.*
Dependencies to v9.0.40 by @TheCodeTraveler in #2525 - Bump MauiPackageVersion to 9.0.50 by @pictos in #2584
New Contributors
- @dotMorten made their first contribution in #2549
- @phunkeler made their first contribution in #2523
- @plewm made their first contribution in #2497
Full Changelog: 11.1.0...11.2.0
v6.0.2 MediaElement: Increase .NET MAUI dependency
What's Changed
- Bump MauiPackageVersion to 9.0.50 by @pictos in #2584
- [Housekeeping] Increase minimum .NET SDK dependency to v9.0.202 by @TheCodeTraveler in #2592
Full Changelog: 11.1.0...6.0.2-mediaelement
Requirements
The following tools are now required for CommunityToolkit.Maui:
- Download/install .NET SDK v9.0.202
- 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.json
file 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.202",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}
v3.0.2 Maps: Rerendering the Map on connectivity changes
What's Changed
- Map doesn't re-render If there is no internet by @VladislavAntonyuk in #2512
- Bump MauiPackageVersion to 9.0.50 by @pictos in #2584
- [Housekeeping] Increase minimum .NET SDK dependency to v9.0.202 by @TheCodeTraveler in #2592
Full Changelog: 11.1.0...3.0.2-maps
Requirements
The following tools are now required for CommunityToolkit.Maui:
- Download/install .NET SDK v9.0.202
- 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.json
file 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.202",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}
v2.0.3 CameraView: Don't photograph bugs!
What's Changed
- Ensure only color streams are used by @dotMorten in #2549
- [Android] Sync ImageCapture Use Case w/ Display Rotation by @phunkeler in #2523
- Bump MauiPackageVersion to 9.0.50 by @pictos in #2584
- [Housekeeping] Increase minimum .NET SDK dependency to v9.0.202 by @TheCodeTraveler in #2592
New Contributors
- @dotMorten made their first contribution in #2549
- @phunkeler made their first contribution in #2523
Full Changelog: 11.1.0...2.0.3-camera
Requirements
The following tools are now required for CommunityToolkit.Maui:
- Download/install .NET SDK v9.0.202
- 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.json
file 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.202",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}
11.1.0: just some much needed bugfixes!
What's Changed
- Add IProvideParentValues as required service for AppThemeResourceExtension by @jfversluis in #2460
- Add UnconditionalSuppressMessage to fix IL2092 by @jfversluis in #2461
- Fix XamlRoot being set incorrectly in Popup Handler by @ne0rrmatrix in #2476
- Fix statusBar color changes on modal pages by @pictos in #2413
- Fix Snackbar layout #1901 by @VladislavAntonyuk in #2456
- Fix options not working for Core by @ne0rrmatrix in #2491
- Enhance DrawingView and DrawingViewService to provide the ability to export the full image size by @bijington in #2193
- Enable Expander on ListView + Enable Expander CollectionView GridLayout 1557 by @VladislavAntonyuk in #1567
- Fix XamlC warning for
DrawingViewModel
and MVVMTK warningSpeechToTextPage
by @ne0rrmatrix in #2513
Housekeeping
- [Housekeeping] Improve Code Coverage Report by @VladislavAntonyuk in #2498
- XUnit V3 by @VladislavAntonyuk in #2486
- [Housekeeping] Add
[SupportedOSPlatform]
toAppBuilderExtensions
by @TheCodeTraveler in #2488 - [Housekeeping] Fix Unit Test Failure:
Catastrophic failure: System.ArgumentOutOfRangeException
by @TheCodeTraveler in #2479 - Bump FluentAssertions from 8.0.0 to 8.0.1 in /samples by @dependabot in #2464
- [Housekeeping] Add Benchmarks to GitHub Actions by @TheCodeTraveler in #2452
- Bump coverlet.collector from 6.0.3 to 6.0.4 in /samples by @dependabot in #2458
- Use GitHub Actions by @VladislavAntonyuk in #2091
New Contributors
Full Changelog: 11.0.0...11.1.0
v6.0.1 MediaElement: Windows Improvements
What's Changed
- Update MediaElement Transport Controls for Windows by @ne0rrmatrix in #2329
- Move permissions from sample android manifest to Media Element by @ne0rrmatrix in #2500
- Fix Windows Media Element in MultiWindow Mode on exit Crash by @ne0rrmatrix in #2259
Full Changelog: 11.0.0...6.0.1-mediaelement
v2.0.2 CameraView: Fixed Android crash
Thank you so much @UlriCode for your contribution!
What's Changed
- [CameraView] Android - Fix SetSurfaceProvider crash by @UlriCode in #2449
- Update transient dependancies for camera to fix build warnings by @ne0rrmatrix in #2493
New Contributors
Full Changelog: 11.0.0...2.0.2-camera
11.0.0: Offline speech recognition
And just like that, the first release in 2025 is v11 of the .NET MAUI Community Toolkit!
Offline speech recognition
In this release we add offline speech recognition. No need for an active internet connection, you can now to speech to text while offline. Note that this is available from Android 33 and up and iOS13 and up. Check out all the details on the docs.
Statusbar gap
Did you notice there was a gap when using the StatusBarBehavior
on iOS? Thanks to @kubaflo not anymore! We made sure that the calculations for the status bar height is now correct and are even giving you fine-grained control over the calculations by being able to specify if the safe area should be included or not.
And much more!
Be sure to check out the full list below with all the changes ,and last but not least, we also did releases for CameraView, MediaElement and Maps, so be sure to check those out too!
Make sure to check the requirements below for using this/building this project yourself.
Requirements
The following tools are now required for CommunityToolkit.Maui:
- Download/install .NET SDK v9.0.102
- 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.json
file 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.102",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}
What's Changed
- Fix bug: Support for arrays in IsListNotNullOrEmptyConverter/IsListNotNullOrEmptyConverter by @jenscski in #2396
- change to ResetValidationTokenSource to guard against a disposed validationTokenSource by @matt-bartholomew in #2344
- Offline Speech Recognition #2089 by @VladislavAntonyuk in #2242
- Support Microsoft.Maui.Controls v9.0.30 and .NET SDK v9.0.102 by @brminnick in #2444
- Migrate to PEG parser. Introduce boolean operators and constants. by @stephenquan in #2182
- [iOS] StatusBarBehavior does not occupy entire notch - fix by @kubaflo in #2309
Bumpers 🚗 & Housekeeping
- Fix ObservableProperties error: mvvmtk0045 by @ne0rrmatrix in #2399
- Fix mvvmtk0045 warnings for
SpeechToTextViewModel
by @ne0rrmatrix in #2402 - Fix mvvmtk0045 warnings for
VariableMultiValueConverterViewModel
by @ne0rrmatrix in #2401 - Fix mvvmtk0045 warning for
StateContainerViewModel
by @ne0rrmatrix in #2400 - Fix mvvmtk0045 and XC0045 warnings by @ne0rrmatrix in #2403
- Bump coverlet.collector from 6.0.2 to 6.0.3 in /samples by @dependabot in #2421
- Bump xunit from 2.9.2 to 2.9.3 in /samples by @dependabot in #2432
- Bump xunit.runner.visualstudio from 3.0.0 to 3.0.1 in /samples by @dependabot in #2435
- Bump xunit.v3 from 1.0.0 to 1.0.1 in /samples by @dependabot in #2436
- [Housekeeping] Remove Null Forgiving Operator by @brminnick in #2446
- Bump System.Formats.Asn1 from 9.0.0 to 9.0.1 in /samples by @dependabot in #2442
- Bump FluentAssertions from 7.0.0 to 8.0.0 in /samples by @dependabot in #2441
New Contributors
- @jenscski made their first contribution in #2396
- @matt-bartholomew made their first contribution in #2344
- @Forestbrook made their first contribution in #2312
- @stephenquan made their first contribution in #2182
- @kubaflo made their first contribution in #2309
Full Changelog: 10.0.0...11.0.0
v6.0.0 MediaElement: Now using Media3 on Android!
What's Changed
- Update Media Element to use Media3 by @ne0rrmatrix in #2076
Requirements
The following tools are now required for CommunityToolkit.Maui:
- Download/install .NET SDK v9.0.102
- Install Xcode 16.1.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.json
file 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.102",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}
Full Changelog: 10.0.0...6.0.0-mediaelement