v12.1.0: Popup V2 bugfixes! | Toolkit Releases

What’s Changed

Restrict AddPopup extensions to View to avoid ContentPage from being allowed by Shaun Lawrence in https://github.com/CommunityToolkit/Maui/pull/2715
[Popup] Properly handle Android Back Button pressed by Brandon Minnick in https://github.com/CommunityToolkit/Maui/pull/2716
Speech Recognition Windows Ensure unsubscribe from events on Stop Recording by Vladislav Antonyuk in https://github.com/CommunityToolkit/Maui/pull/2705
Prevent a tap inside the content from closing a popup by Shaun Lawrence in https://github.com/CommunityToolkit/Maui/pull/2741
[Popup] Add Popup.CanBeDismissedByTappingOutsideOfPopup by Brandon Minnick in https://github.com/CommunityToolkit/Maui/pull/2753
ShowPopupAsync will now correctly return once the popup is closed under heavy garbage collection by Shaun Lawrence in https://github.com/CommunityToolkit/Maui/pull/2756
Remove exception swallowing and update tests to exhibit expected behaviour by Shaun Lawrence in https://github.com/CommunityToolkit/Maui/pull/2749
Fix: .UseMauiCommunityToolkit() Analyzer when wrapped in preprocessor directives by @IeuanWalker in https://github.com/CommunityToolkit/Maui/pull/2769
Publish main to github nuget by Vladislav Antonyuk in https://github.com/CommunityToolkit/Maui/pull/2760
[Popup] Add DefaultPopupOptionsSettings and DefaultPopupSettings to .UseMauiCommunityToolkit(Options) by Brandon Minnick in https://github.com/CommunityToolkit/Maui/pull/2759
[Popup] Add ComplexPopup to CommunityToolkit.Maui.Sample by Brandon Minnick in https://github.com/CommunityToolkit/Maui/pull/2771
Fix Windows Snackbar Registration by James Crutchley in https://github.com/CommunityToolkit/Maui/pull/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
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: https://github.com/CommunityToolkit/Maui/compare/12.0.0…12.1.0