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
• 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"/> to CommunityToolkit.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 from PopupExtensions.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