Skip to content

Conversation

renovate[bot]
Copy link
Contributor

@renovate renovate bot commented Jul 4, 2025

This PR contains the following updates:

Package Change Age Confidence
CommunityToolkit.Maui 6.1.0 -> 12.2.0 age confidence

Release Notes

CommunityToolkit/Maui (CommunityToolkit.Maui)

v12.2.0: : More Popup fixes!

Compare Source

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

New Contributors

Full Changelog: CommunityToolkit/Maui@12.1.0...12.2.0

v12.1.0: : Popup V2 bugfixes!

Compare Source

What's Changed

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
  • 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: CommunityToolkit/Maui@12.0.0...12.1.0

v12.0.0: : Popup V2 is here!

Compare Source

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:

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
  • 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

Housekeeping

New Contributors

Full Changelog: CommunityToolkit/Maui@11.2.0...12.0.0

v11.2.0: : .NET MAUI Dependency Update & RatingView ⭐️

Compare Source

What's Changed

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
  • 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

New Contributors

Full Changelog: CommunityToolkit/Maui@11.1.0...11.2.0

v11.1.1: : Minor Patch Release

Compare Source

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: CommunityToolkit/Maui@11.1.0...11.1.1

v11.1.0: : just some much needed bugfixes!

Compare Source

What's Changed

Housekeeping

New Contributors

Full Changelog: CommunityToolkit/Maui@11.0.0...11.1.0

v11.0.0: : Offline speech recognition

Compare Source

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
  • 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

Bumpers 🚗 & Housekeeping

New Contributors

Full Changelog: CommunityToolkit/Maui@10.0.0...11.0.0

v10.0.0: : .NET 9 support is here!

Compare Source

It took some great effort from multiple people, but it's finally here! .NET 9 support for the .NET MAUI Community Toolkit!

Requirements

The following tools are now required for CommunityToolkit.Maui.:

  • Download/install .NET SDK v9.0.101
  • Install Xcode 16.1.0
    • 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
    • On Windows, open the command prompt (or Powershell) and enter the following command: dotnet workload install maui
  • 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.101", 
    "rollForward": "latestFeature",
    "allowPrerelease": false
  }
}

Breaking Changes

Major Breaking Changes
image
  • All CommunityToolkit.Maui.Behaviors no longer automatically assign Behavior.BindingContext for you

  • .NET 8 no longer supported

  • Xcode 16.1 Required

  • Increase minimum supported OS versions of CommunityToolkit.Maui.MediaElement

    • Android 26.0
    • iOS 15.0
    • MacCatalyst 15.0
  • Increase minimum supported versions of CommunityToolkit.Maui.Camera to 15.0:

    • iOS 15.0
    • MacCatalyst 15.0
Minor Breaking Changes
  • Expander is not trim safe
  • ValidationBehaviors are not trim safe
  • CommunityToolkit.Maui.Maps is not trim safe
  • Remove PopupService.ShowPopop(TViewModel)
    • Removes [Obsolete] method
    • Use PopupService.ShowPopup<T>() instead
  • Remove PopupService.ShowPopopAsync(TViewModel, CancellationToken)
    • Removes [Obsolete] method
    • Use PopupService.ShowPopupAsync<T>() instead
  • Remove ability to subclass BaseConverter<TFrom, TTo>
    • Subclassing from BaseConverter<TFrom, TTo> is not supported
    • Support requires documentation and complete unit tests
  • Remove ability to subclass BaseConverter<TFrom, TTo, TParam>
    • Subclassing from BaseConverter<TFrom, TTo, TParam> is not supported
    • Support requires documentation and complete unit tests
  • ValidationFlags.ValidateOnFocusing renamed to ValidationFlags.ValidateOnFocused
  • ValidationFlags.ValidateOnUnfocusing renamed to ValidationFlags.ValidateOnUnfocused
  • In CommunityToolkit.Maui.Camera, add linker.xml for net9.0-android to avoid the Linker removing Xamarin.AndroidX.Camera.Core, Xamarin.AndroidX.Camera.Lifecycle, Xamarin.AndroidX.Camera.Video, Xamarin.AndroidX.Camera.View, and Xamarin.AndroidX.Camera.Camera2
  • public static Task<bool> ShowKeyboardAsync(this ITextInput, CancellationToken) -> public static ValueTask<bool> ShowKeyboardAsync(this ITextInput, CancellationToken)
  • NuGet package will not support Microsoft.Maui.Controls .NET 10 until .NET 10 GA

And who doesn't love some numbers?! 📈

Analyzer Benchmarks

.NET 9.0 Mean Error StdDev Median Gen0 Gen1 Allocated
VerifyNoErrorsWhenUseMauiCommunityToolkit 8.863 ms 0.1748 ms 0.3240 ms 8.724 ms 62.5000 31.2500 1.59 MB
VerifyNoErrorsWhenUseMauiCommunityToolkitHasAdditionalWhitespace 8.695 ms 0.1654 ms 0.4358 ms 8.528 ms 62.5000 31.2500 1.59 MB
VerifyErrorsWhenMissingUseMauiCommunityToolkit 12.071 ms 0.3756 ms 1.0470 ms 11.546 ms 66.6667 - 2.29 MB
.NET 8.0 Mean Error StdDev Median Gen0 Allocated
VerifyNoErrorsWhenUseMauiCommunityToolkitMediaElement 9.763 ms 0.1928 ms 0.4765 ms 9.633 ms 31.2500 1.46 MB
VerifyNoErrorsWhenUseMauiCommunityToolkitMediaElementHasAdditonalWhitespace 9.565 ms 0.1862 ms 0.4637 ms 9.460 ms 31.2500 1.46 MB
VerifyErrorsWhenMissingUseMauiCommunityToolkitMediaElement 15.495 ms 0.3879 ms 1.0814 ms 15.058 ms 66.6667 2.24 MB

ILLinker Failing on iPhone Device (non-simulator) and MacCatalyst Release Builds:

If you run into a build error while building your macOS/Mac Catalyst app, try opting out of the new type registrar. We did that for our sample app for the time being while this bug gets resolved. More information here: https://github.com/xamarin/xamarin-macios/wiki/.NET-9-release-notes#opting-out

  <!-- Fixes Static Registrar causing Linker error: https://github.com/xamarin/xamarin-macios/blob/main/docs/managed-static-registrar.md -->
  <Target Name="SelectStaticRegistrar" AfterTargets="SelectRegistrar">
    <PropertyGroup Condition="'$(Registrar)' == 'managed-static'">
        <Registrar>static</Registrar>
    </PropertyGroup>
  </Target>

What's Changed

New Contributors

Full Changelog: CommunityToolkit/Maui@9.1.1...10.0.0

v9.1.1: : A handful of bugfixes before the new major release

Compare Source

.NET 9 is almost upon us, just before the new major release that we will be introduction as part of there, here are a couple of bugfixes that you can use today!

A big thank you to @​Bensley96 for the very first contribution to this project 👏

Requirements

The following tools are now required for CommunityToolkit.Maui.:

  • Xcode 16.0.0
    • 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)
  • Download/install .NET SDK v8.0.403
  • 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
    • On Windows, open the command prompt (or Powershell) and enter the following command: dotnet workload install maui
  • 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": "8.0.403", 
    "rollForward": "latestMajor",
    "allowPrerelease": false
  }
}

What's Changed

🧼 Housekeeping 🧽

New Contributors

Full Changelog: CommunityToolkit/Maui@9.1.0...9.1.1

v9.1.0: : AOT support is here!

Compare Source

Required Updates

The following tools are now required for .NET MAUI Community Toolkit v9.1.0

  • Xcode 16.0.0
    • 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)
  • Download/install .NET SDK v8.0.403
  • 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
    • On Windows, open the command prompt (or Powershell) and enter the following command: dotnet workload install maui
  • 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": "8.0.403", 
    "rollForward": "latestMajor",
    "allowPrerelease": false
  }
}

What's Changed

Housekeeping 🧹

New Contributors

Big thank you to our community contributors 👏

Full Changelog: CommunityToolkit/Maui@9.0.3...9.0.4

v9.0.3: : Transparent Status bar for Android, Icon Tint Color Updates and more!

Compare Source

Just before the weekend, here are some new goodies to play with!

Minor new functionalities, bugfixes and we updated the dependency of .NET MAUI to 8.0.71 to match the latest version that is included in the workload that comes with Visual Studio.

What's Changed


Configuration

📅 Schedule: Branch creation - "after 4am and before 8am on saturday" in timezone Asia/Shanghai, Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.


  • If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

@renovate renovate bot force-pushed the renovate/communitytoolkit.maui-12.x branch from a61eb81 to 6cba422 Compare July 20, 2025 14:30
@renovate renovate bot force-pushed the renovate/communitytoolkit.maui-12.x branch from 6cba422 to 72264ea Compare August 8, 2025 17:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants