Releases: CommunityToolkit/Maui
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.CanBeDismissedByTappingOutsideOfPopup
by @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
DefaultPopupOptionsSettings
andDefaultPopupSettings
to.UseMauiCommunityToolkit(Options)
by @TheCodeTraveler in #2759 - [Popup] Add
ComplexPopup
toCommunityToolkit.Maui.Sample
by @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.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.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
v12.0.0: Popup V2 is here!
An all new implementation of Popups! We complete wrote Popup from the ground up so that it is now more stable and easier to work with than ever.
If you're migrating, be sure to check out our Popup v2 Migration Guide, along with the updated Popup documentation:
- Popup: https://learn.microsoft.com/dotnet/communitytoolkit/maui/views/popup
- Customizing a Popup using Popup Options: https://learn.microsoft.com/dotnet/communitytoolkit/maui/views/popup/popup-options
- Popup Service: https://learn.microsoft.com/dotnet/communitytoolkit/maui/views/popup-service
- Returning a Result from Popup: https://learn.microsoft.com/dotnet/communitytoolkit/maui/views/popup/popup-result
Breaking Changes
- CommunityToolkit.Maui
Popup.Anchor
feature removed
- CommunityToolkit.Maui.Camera
- Updated Namespaces
- Refactored the following methods in
CameraView
:ValueTask CaptureImage(CancellationToken); Task StartCameraPreview(CancellationToken); void StopCameraPreview();
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.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.300",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}
What's Changed
- Popup V2 by @bijington in #1581
- Fix: Animation behavior TapGestureRecognizer by @IeuanWalker in #2567
- Move UseMicrosoftTestingPlatformRunner to Directory.Build.props by @Youssef1313 in #2619
- Add
<InternalsVisibleTo Include="CommunityToolkit.Maui"/>
toCommunityToolkit.Maui.Core.csproj
by @TheCodeTraveler in #2628 - Add Android TextureView by @jonmdev in #2540
- [Android] TouchBehavior prevents keyboard Tab navigation to next element - fix by @kubaflo in #2673
- Fix RS1038 Warning: Compiler extensions should be implemented in assemblies with compiler-provided references by @TheCodeTraveler in #2676
- Return
IPopupResult
fromPopupExtensions.ClosePopupAsync()
by @TheCodeTraveler in #2677 - Fix issue with tint not applying to loaded images by @myix765 in #2077
- BUG FIX: adding count check for navigation stack before getting last item, adding check for mainpage as current page as additional failover. by @nixkuroi in #2379
- Pin WindowsSdkPackageVersion by @jfversluis in #2613
- Update AppThemeResourceExtension to not use IProvideParentValues by @jfversluis in #2639
Housekeeping
- [Housekeeping] fix copilot-instructions.md by @FaithfulDev in #2678
- Bump peter-evans/create-pull-request from 3 to 7 by @dependabot in #2631
- Bump jfversluis/dotnet-format from 1.0.5 to 1.0.9 by @dependabot in #2632
- Bump actions/checkout from 3 to 4 by @dependabot in #2630
- [Housekeeping] Increase Xcode to 16.3 for Sample App Builds in CI/CD Pipelines by @TheCodeTraveler in #2622
New Contributors
- @Youssef1313 made their first contribution in #2619
- @jonmdev made their first contribution in #2540
- @FaithfulDev made their first contribution in #2678
- @nixkuroi made their first contribution in #2379
- @elaurentin made their first contribution in #2666
Full Changelog: 11.2.0...12.0.0
v6.1.0 MediaElement: Hitting pause on the bugs!
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.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.300",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}
What's Changed
- Add missing PlayerListener stubs back to Media Element by @ne0rrmatrix in #2530
- Remove MediaElement Handler disconnect in popups by @ne0rrmatrix in #2656
- [MediaElement][Android][API < 30] Fix System Bar After Transition From Fullscreen by @phunkeler in #2652
- No artwork shown in-app on MediaElement using meta data #2659 by @elaurentin in #2666
New Contributors
- @elaurentin made their first contribution in #2666
Full Changelog: 11.2.0...6.1.0-mediaelement
v3.0.0 Camera: Refactorings!
Breaking Changes
- CommunityToolkit.Maui.Camera: Refactored
ValueTask CameraView.CaptureImage(CancellationToken)
,CameraView.StartCameraPreview(CancellationToken)
andvoid CameraView.StopCameraPreview()
methods
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.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.300",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}
What's Changed
- Refactor
CameraView.CaptureImage
,CameraView.StartCameraPreview
andCameraView.StopCameraPreview
by @TheCodeTraveler in #2655
Full Changelog: 11.2.0...3.0.0-camera
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
}
}