13.0.0: .NET 10 Support is here!

Breaking Changes

• .NET 10 Required
• Removed Deprecated IPopup
• Removed Deprecated MauiPopup
• Removed Deprecated PopupHandler
• Removed Deprecated PopupExtensions
• (CameraView) Developers must manually request Permissions.Camera and Permissions.Microphone:

var cameraPermissionsRequest = await Permissions.RequestAsync<Permissions.Camera>();
var microphonePermissionsRequest = await Permissions.RequestAsync<Permissions.Microphone>();

• (FileSaver) Developers must manually request Permissions.StorageRead and Permissions.StorageWrite:

var readPermissionStatus = await Permissions.RequestAsync<Permissions.StorageRead>();
var writePermissionStatus = await Permissions.RequestAsync<Permissions.StorageWrite>();

• (FolderPicker) Developers must manually request Permissions.StorageRead and Permissions.StorageWrite:

var readPermissionStatus = await Permissions.RequestAsync<Permissions.StorageRead>();
var writePermissionStatus = await Permissions.RequestAsync<Permissions.StorageWrite>();

• (SpeechToText) Developers must manually request permissions for Permissions.Microphone and manually call ISpeechToText.RequestPermissions():

    static async Task<bool> ArePermissionsGranted(ISpeechToText speechToText)
    {
        var microphonePermissionStatus = await Permissions.RequestAsync<Permissions.Microphone>();
        var isSpeechToTextRequestPermissionsGranted = await speechToText.RequestPermissions(CancellationToken.None);

        return microphonePermissionStatus is PermissionStatus.Granted
               && isSpeechToTextRequestPermissionsGranted;
    }

What's Changed

• CarouselViewHandler2 InvalidCastException for MauiMediaElement.macios.cs when using CollectionViewHandler2 and CarouselViewHandler2 by @TheCodeTraveler in #2926
• (Popup) Enable Popup v2 Inside Custom NavigationPage by @pictos in #2919
• Add .NET 10 Support by @TheCodeTraveler in #2902
• Allow Developers to Manually Request Permissions when using CameraView, FileSaver, FolderPicker and SpeechToText by @VladislavAntonyuk in #2934

Full Changelog: 12.3.0...13.0.0

7.0.0 MediaElement: .NET 10 support is here!

Breaking Changes

• .NET 10 Required

What's Changed

• Add .NET 10 Support by @TheCodeTraveler in #2902

Full Changelog: 6.1.3-mediaelement...7.0.0-mediaelement

5.0.0 Camera: .NET 10 support is here!

Breaking Changes

• .NET 10 Required
• (CameraView) Developers must manually request Permissions.Camera and Permissions.Microphone:

var cameraPermissionsRequest = await Permissions.RequestAsync<Permissions.Camera>();
var microphonePermissionsRequest = await Permissions.RequestAsync<Permissions.Microphone>();

What's Changed

• Add .NET 10 Support by @TheCodeTraveler in #2902

Full Changelog: 4.0.0-camera...5.0.0-camera

4.0.0 Maps: .NET 10 support is here!

Breaking Changes

• .NET 10 Required

What's Changed

• Add .NET 10 Support by @TheCodeTraveler in #2902

Full Changelog: 3.0.3-maps...4.0.0-maps

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
• 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 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 OnPositionDiscontinuity back 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
• 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 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
• 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 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.OnTappingOutsideOfPopup when 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

• @waheez made their first contribution in #2840
• @ruyut made their first contribution in #2846

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