v12.0.0: Popup V2 is here! | Toolkit Releases

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
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 Shaun Lawrence in https://github.com/CommunityToolkit/Maui/pull/1581
Fix: Animation behavior TapGestureRecognizer by @IeuanWalker in https://github.com/CommunityToolkit/Maui/pull/2567
Move UseMicrosoftTestingPlatformRunner to Directory.Build.props by @Youssef1313 in https://github.com/CommunityToolkit/Maui/pull/2619
Add <InternalsVisibleTo Include="CommunityToolkit.Maui"/> to CommunityToolkit.Maui.Core.csproj by Brandon Minnick in https://github.com/CommunityToolkit/Maui/pull/2628
Add Android TextureView by @jonmdev in https://github.com/CommunityToolkit/Maui/pull/2540
[Android] TouchBehavior prevents keyboard Tab navigation to next element - fix by Jakub Florkowski in https://github.com/CommunityToolkit/Maui/pull/2673
Fix RS1038 Warning: Compiler extensions should be implemented in assemblies with compiler-provided references by Brandon Minnick in https://github.com/CommunityToolkit/Maui/pull/2676
Return IPopupResult from PopupExtensions.ClosePopupAsync() by Brandon Minnick in https://github.com/CommunityToolkit/Maui/pull/2677
Fix issue with tint not applying to loaded images by @myix765 in https://github.com/CommunityToolkit/Maui/pull/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 https://github.com/CommunityToolkit/Maui/pull/2379
Pin WindowsSdkPackageVersion by Gerald Versluis in https://github.com/CommunityToolkit/Maui/pull/2613
Update AppThemeResourceExtension to not use IProvideParentValues by Gerald Versluis in https://github.com/CommunityToolkit/Maui/pull/2639

Housekeeping

[Housekeeping] fix copilot-instructions.md by @FaithfulDev in https://github.com/CommunityToolkit/Maui/pull/2678
Bump peter-evans/create-pull-request from 3 to 7 by @dependabot in https://github.com/CommunityToolkit/Maui/pull/2631
Bump jfversluis/dotnet-format from 1.0.5 to 1.0.9 by @dependabot in https://github.com/CommunityToolkit/Maui/pull/2632
Bump actions/checkout from 3 to 4 by @dependabot in https://github.com/CommunityToolkit/Maui/pull/2630
[Housekeeping] Increase Xcode to 16.3 for Sample App Builds in CI/CD Pipelines by Brandon Minnick in https://github.com/CommunityToolkit/Maui/pull/2622

New Contributors

@Youssef1313 made their first contribution in https://github.com/CommunityToolkit/Maui/pull/2619
@jonmdev made their first contribution in https://github.com/CommunityToolkit/Maui/pull/2540
@FaithfulDev made their first contribution in https://github.com/CommunityToolkit/Maui/pull/2678
@nixkuroi made their first contribution in https://github.com/CommunityToolkit/Maui/pull/2379
@elaurentin made their first contribution in https://github.com/CommunityToolkit/Maui/pull/2666

Full Changelog: https://github.com/CommunityToolkit/Maui/compare/11.2.0…12.0.0