dotnet/maui

What's Changed

.NET MAUI 9 SR 11 introduces significant improvements across all platforms with focus on quality, performance, and developer experience. This release includes 72 commits with various improvements, bug fixes, and enhancements.

.NET MAUI Product Fixes

Collectionview

• [iOS] PullToRefresh activity indicator improvements - fix by @kubaflo in https://github.com/dotnet/maui/pull/20824

  🔧 Fixes
  • [iOS] RefreshView indicator not displayed when IsRefreshing is manually set to true and collectionView is at the top
  • PullToRefresh activity indicator hidden behind header in CollectionView

• Fix CarouselView layout constraint issues on Mac Catalyst by @Copilot in https://github.com/dotnet/maui/pull/30714

  🔧 Fixes
  • [MAUI] The list does not show newly added recipes
  • Fixed the SafeArea branch test case failures issues

• [iOS] Changing IsGrouped on runtime with CollectionViewHandler2 does not properly work - fix by @kubaflo in https://github.com/dotnet/maui/pull/31100

  🔧 Fixes
  • Changing IsGrouped on runtime with CollectionViewHandler2 does not properly work

• [iOS/Mac] Fixed the Border Rendering issues in CollectionViewHandler2 by @Ahamed-Ali in https://github.com/dotnet/maui/pull/27801

  🔧 Fixes
  • Improve iOS CollectionView performance by leveraging the new platform level invalidation mechanism
  • Items' shapes are sometimes rendered incorrectly using CollectionView2Handler

• [main] Update ui-tests.yml timeout to account for CollectionView by @github-actions[bot] in https://github.com/dotnet/maui/pull/31234

  🔧 Fixes
  • Update ui-tests.yml timeout to account for CollectionView

• [iOS]CarouselView Position Not Respected When Changing From Hidden to Visible in CV2 - fix by @kubaflo in https://github.com/dotnet/maui/pull/29999

  🔧 Fixes
  • [iOS] - CarouselView Position Not Respected When Changing From Hidden to Visible in CV2

Controls Button

• [Android] Gradient background with ImageButton by @kubaflo in https://github.com/dotnet/maui/pull/26297

  🔧 Fixes
  • Assigning a Brush of type RadialGradientBrush to the Background property of an ImageButton causes the BG to show a solid color

Controls Dialogalert

• Add support to dismiss the prompt with enter on keyboard by @pictos in https://github.com/dotnet/maui/pull/27419

  🔧 Fixes
  • Shell.Current.DisplayPromptAsync doesn't react on Enter press on WinUI

• [Windows] Fix ActionSheet maximum size and styling by @morning4coffe-dev in https://github.com/dotnet/maui/pull/30835

  🔧 Fixes
  • Actionsheet maximum size has been hardcoded on windows, creating display issues

Controls Entry

• [Android] Editor and Entry don't update placeholder and text color on theme change - fix by @kubaflo in https://github.com/dotnet/maui/pull/30603

• [Android] Editor and Entry don't update placeholder and text color on theme change

Controls General

• [Windows] Cleanup of AccessibilityExtensions by @MartyIX in https://github.com/dotnet/maui/pull/27052

Controls Label

• [iOS, Android, Windows] TextTransform Property Does Not Apply at Runtime When TextType="Html" Is Set on Label - fix by @kubaflo in https://github.com/dotnet/maui/pull/29700

  🔧 Fixes
  • TextTransform Property Does Not Apply at Runtime When TextType="Html" Is Set on Label

• [Windows] Optimize Label.CharacterSpacing on initial load by @MartyIX in https://github.com/dotnet/maui/pull/31391

  🔧 Fixes
  • [WinUI] Creating a complex grid is very slow

Controls Searchbar

• [iOS] SearchBar placeholder color is not updating on theme change - fix by @kubaflo in https://github.com/dotnet/maui/pull/30597

  🔧 Fixes
  • [iOS] SearchBar placeholder color is not updating on theme change

Controls Slider

• [iOS] Thumb image improvements by @kubaflo in https://github.com/dotnet/maui/pull/27516

  🔧 Fixes
  • [iOS] Slider's thumb image doesn't respect color
  • Thumb Image Disappears in Slider Control When Changing Thumb Color on iOS and Catalyst

Controls Stepper

• Fix Stepper control fails to reach maximum value when increment exceeds remaining threshold by @SuthiYuvaraj in https://github.com/dotnet/maui/pull/29763

  🔧 Fixes
  • [Windows] - Stepper control fails to reach maximum value when increment exceeds remaining threshold

Docs

• Move externally linked XML API docs to inline source code documentation by @Copilot in https://github.com/dotnet/maui/pull/30313

  🔧 Fixes
  • Move externally linked XML API docs to source code

• [main] Added a README with details about how to compile the manual tests by @github-actions[bot] in https://github.com/dotnet/maui/pull/31492

  🔧 Fixes
  • Added a README with details about how to compile the manual tests

Drawing

• [iOS] Fixed Invalid Color warning by @SubhikshaSf4851 in https://github.com/dotnet/maui/pull/30876

  🔧 Fixes
  • .NET MAUI: There is an "Invalid color" error on iOS when drawing a pattern using the GraphicsView

• [Android] BackgroundColor for GraphicsView by @kubaflo in https://github.com/dotnet/maui/pull/26320

  🔧 Fixes
  • GraphicsView does not change the Background/BackgroundColor on Android

• Changing shape background color with dataTrigger by @kubaflo in https://github.com/dotnet/maui/pull/25544

  🔧 Fixes
  • DataTrigger doesn't change Rectangle background color on iOS

• [Android] GraphicsView scaling after canvas.ResetState - fix by @kubaflo in https://github.com/dotnet/maui/pull/31183

  🔧 Fixes
  • [Android] GraphicsView draws at half size after canvas.ResetState() (issue appears on second Draw)

Essentials

• [Android][Permissions]Requesting permissions using RequestAsync while the app is in the background - fix by @kubaflo in https://github.com/dotnet/maui/pull/30697

  🔧 Fixes
  • Requesting permissions using RequestAsync while the app is in the background always returns granted.

Gestures

• [iOS] Span's TapGestureRecognizer not working if text is truncated - UITest by @kubaflo in https://github.com/dotnet/maui/pull/22213

  🔧 Fixes
  • Span's TapGestureRecognizer not working if text is truncated

• [Android] TapGestureRecognizer cannot be tapped using Android Talkback in MAUI - fix by @kubaflo in https://github.com/dotnet/maui/pull/31486

  🔧 Fixes
  • TapGestureRecognizer cannot be tapped using Android Talkback in MAUI 9.0.100

• Fix pan and pinch gesture completion on Windows by @jeremy-visionaid in https://github.com/dotnet/maui/pull/31123

  🔧 Fixes
  • PinchGestureRecognizer does not complete correctly when interrupted by an alert on Windows

Image

• [android] improve performance of ImageHandler.PlatformArrange() by @jonathanpeppers in https://github.com/dotnet/maui/pull/23665

• [Windows] Fixed Image clipping not working by @SubhikshaSf4851 in https://github.com/dotnet/maui/pull/30684

  🔧 Fixes
  • [Windows] Image Clipping not working correctly

Infrastructure

• Update Versions.props SR11 Versioning by @PureWeen in https://github.com/dotnet/maui/pull/31117

• [ci] Add more keys by @rmarinho in https://github.com/dotnet/maui/pull/31130

• Update bug-report.yml 9.0.100 SR10 by @PureWeen in https://github.com/dotnet/maui/pull/31163

• [ci] Add branch classification file by @rmarinho in https://github.com/dotnet/maui/pull/31292

Navigation

• [Android] Toolbar overflow menu icon color by @kubaflo in https://github.com/dotnet/maui/pull/25627

  🔧 Fixes
  • Change the more menu button on MAUI ContentPage.ToolbarItems
  • Unable to set toolbar overflow menu color if not using shell.

• [iOS] Fixed NavigationStack not updating when OnAppearing is invoked by @Vignesh-SF3580 in https://github.com/dotnet/maui/pull/28666

  🔧 Fixes
  • [iOS] Popping a page includes an unexpected page in the NavigationStack when the underlying page's OnAppearing method is called

• [Android] Overriding back button functionality with OnBackButtonPressed returning false in a modally pushed page causes stack overflow - fix by @kubaflo in https://github.com/dotnet/maui/pull/28812

  🔧 Fixes
  • [Android] Overriding back button functionality with OnBackButtonPressed returning false in a modally pushed page causes stack overflow

Other

• August 16th, 2025 Candidate by @PureWeen in https://github.com/dotnet/maui/pull/31201

• General nativeAOT support improvements by @morning4coffe-dev in https://github.com/dotnet/maui/pull/31228

  🔧 Fixes
  • [Windows] Improve NativeAOT support

• August 25th, 2025 Candidate by @PureWeen in https://github.com/dotnet/maui/pull/31507

  🔧 Fixes
  • [iOS] Popping a page includes an unexpected page in the NavigationStack when the underlying page's OnAppearing method is called
  • [Android] Overriding back button functionality with OnBackButtonPressed returning false in a modally pushed page causes stack overflow
  • Gradient never returns to the correct colour

• .NET 9 SR 11 release branding by @PureWeen in https://github.com/dotnet/maui/pull/31526

• 9.0.110 branding by @PureWeen in https://github.com/dotnet/maui/pull/31527

Picker

• Fixed Picker Items are not Displaying on macOS platform by @NanthiniMahalingam in https://github.com/dotnet/maui/pull/27535

  🔧 Fixes
  • [regression/7.0.96] Picker is empty on mac catalyst
  • Picker loses the ability to pick/present items on small windows
  • Picker Items are not Displaying on macOS

• [MacOS] Picker's dialog improvement by @kubaflo in https://github.com/dotnet/maui/pull/27525

  🔧 Fixes
  • [MacCatalyst] When opening the Picker, the first item is selected instead of the currently selected item.
  • I9- EnumPicker on MacCatalyst and Android platforms displays items abnormally

• [MacOS] Fixed the picker items do not appear when tapping on the picker after navigating through PushModalAsync by @NanthiniMahalingam in https://github.com/dotnet/maui/pull/28003

  🔧 Fixes
  • Picker doesn't show options in modal
  • Picker() on Mac Catalyst does not display dialog with items

Shell

• [main] Check if tab bar hidden value actually changed for Shell by @github-actions[bot] in https://github.com/dotnet/maui/pull/31170

  🔧 Fixes
  • Check if tab bar hidden value actually changed for Shell

TabbedPage

• [Android] Top bar item colors - fix by @kubaflo in https://github.com/dotnet/maui/pull/26964

  🔧 Fixes
  • Tab Icon Color Changes Temporarily During Horizontal Scrolling Between Tabs

• [Windows] Fix for TabbedPage more menu items color. by @Tamilarasan-Paranthaman in https://github.com/dotnet/maui/pull/26876

  🔧 Fixes
  • Menu of TabbedPage's text can be difficult to read

Templates

• Changed Syncfusion toolkit version from 1.0.5 to 1.0.6 by @PaulAndersonS in https://github.com/dotnet/maui/pull/30960

• [Proposal] Removed the default span styling from the template by @kubaflo in https://github.com/dotnet/maui/pull/28818

WebView

• Optimize JS escaping by @symbiogenesis in https://github.com/dotnet/maui/pull/27528

Windows

• Add Windows to nativeAOT template integration test by @morning4coffe-dev in https://github.com/dotnet/maui/pull/31250

  🔧 Fixes
  • [Windows] Improve NativeAOT support

• [Android, Windows] Fixed App.Current.PageDisappearing not raised when a page is popped by @Vignesh-SF3580 in https://github.com/dotnet/maui/pull/28998

  🔧 Fixes
  • App.Current.PageDisappearing is not raised when a page is popped from the navigation stack.

Xaml

• Fix XAML compiled binding warnings in DeviceTests.Runners by adding x:DataType attributes by @Copilot in https://github.com/dotnet/maui/pull/30219

  🔧 Fixes
  • Fix warnings on DeviceTests.Runners

iOS

• Fix iOS Custom Entitlements File Not Respected in Single Project Templates by @Copilot in https://github.com/dotnet/maui/pull/30275

  🔧 Fixes
  • iOS Custom Entitlements File Not Respected

• [Testing] Publish new snapshots and diffs to a specific artifacts folder by @jsuarezruiz in https://github.com/dotnet/maui/pull/27928

• [Android] Input controls should not change keyboard visibility - UITest by @kubaflo in https://github.com/dotnet/maui/pull/29569

  🔧 Fixes
  • [Testing] Create Tests for all input based controls that make sure we don't change keyboard behavior

• [Testing] Fixed Test case failure in PR 31201 - [08/16/2025] Candidate by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/31212

• Added manual test App by @jsuarezruiz in https://github.com/dotnet/maui/pull/29963

• Add BuildNativeAOT parameter with separate build and test execution control by @Copilot in https://github.com/dotnet/maui/pull/31252

• [Testing] Fix for flaky UITests in CI by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/30959

• [Testing] Fixed Test case failure in PR 31201 - [08/16/2025] Candidate - 2 by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/31249

• Add comments for manual test app .NET MAUI package configuration by @jfversluis in https://github.com/dotnet/maui/pull/31493

• Add TargetFramework instructions for ManualTest app by @jfversluis in https://github.com/dotnet/maui/pull/31523

• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31120

• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31181

• [housekeeping] Automated PR to fix formatting errors on inflight/current by @github-actions[bot] in https://github.com/dotnet/maui/pull/31094

• [housekeeping] Automated PR to fix formatting errors on inflight/current by @github-actions[bot] in https://github.com/dotnet/maui/pull/31138

• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31197

• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31312

• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31333

• Fix file locking race condition in parallel builds by adding retry logic to Copy tasks by @jsuarezruiz in https://github.com/dotnet/maui/pull/31364

  🔧 Fixes
  • Microsoft.Maui.Core.props" could not be loaded. The process cannot access the file

• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31477

• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31508