dotnet/maui

What's Changed

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

.NET MAUI Product Fixes

Android

• [release/9.0.1xx-sr12] [Android] -Picker dialog causes crash when page is popped while dialo… by @github-actions[bot] in https://github.com/dotnet/maui/pull/31919

  🔧 Fixes
  • [Android] -Picker dialog causes crash when page is popped while dialo…

BlazorWebView

• Replace UseStaticFiles() with MapStaticAssets() in Blazor Maui Web template by @Copilot in https://github.com/dotnet/maui/pull/31618

  🔧 Fixes
  • [Blazor][Maui] Use MapStaticAssets in the Blazor Maui Web template

• Revert "Replace UseStaticFiles() with MapStaticAssets() in Blazor Maui Web template" by @mattleibow in https://github.com/dotnet/maui/pull/31676

  🔧 Fixes
  • Replace UseStaticFiles() with MapStaticAssets() in Blazor Maui Web template

• Reland "Replace UseStaticFiles() with MapStaticAssets() in Blazor Maui Web template" by @mattleibow in https://github.com/dotnet/maui/pull/31677

  🔧 Fixes
  • Revert "Replace UseStaticFiles() with MapStaticAssets() in Blazor Maui Web template"

Button

• Radio Button Null Selection Fix by @asi-evin in https://github.com/dotnet/maui/pull/31175

  🔧 Fixes
  • RadioButtonGroup.SelectedValue = null doesn't reset RadioButton IsChecked state

Collectionview

• [iOS] Flyout Menu CollectionView First Item Misaligned - fix by @kubaflo in https://github.com/dotnet/maui/pull/30501

  🔧 Fixes
  • [Regression] [iOS] Flyout Menu CollectionView First Item Misaligned Since 9.0.51 (iOS 15–18.1 Affected, Works in 9.0.50)

• [iOS] CV1 & CV2 - Support for RTL by @kubaflo in https://github.com/dotnet/maui/pull/27653

  🔧 Fixes
  • [iOS, Mac] CollectionView with a static string-based ItemsSource does not respect right-to-left (RTL) FlowDirection.
  • [iOS] FlowDirection = "RightToLeft" doesn't work with CV1 & CV2

• [iOS] Support for KeepLastItemInView for CollectionView2 on iOS by @kubaflo in https://github.com/dotnet/maui/pull/31104

  🔧 Fixes
  • ItemsUpdatingScrollMode on CollectionViewHandler2
  • [.NET10]I9-Scroll mode "KeepLastItemInView" does not keep the last item at the end of the displayed list when adding new items.

• Fix for Preventing Incorrect TalkBack Announcements During CollectionView Deselection on Android by @praveenkumarkarunanithi in https://github.com/dotnet/maui/pull/29818

  🔧 Fixes
  • [Accessibility] CollectionView Selected on Android

• [iOS] Fixed the crash occurred on CarouselView2 when deleting last one remaining item with loop as false by @Ahamed-Ali in https://github.com/dotnet/maui/pull/31537

  🔧 Fixes
  • [iOS] CarouselView with CarouselViewHandler2 make app crash when Loop="False" and user scroll to the last position - fix
  • [iOS] Fix CarouselView proper bounce-back behavior when Loop=false
  • [iOS] Crash occurred on CarouselView2 when deleting last one remaining item with loop as false

• Fix Customised CollectionView inherited from does not ScrollTo and display selection correctly by @SuthiYuvaraj in https://github.com/dotnet/maui/pull/31549

  🔧 Fixes
  • [Windows] - Customised CollectionView (inherited from) does not [ScrollTo] and display selection correctly

• [iOS] CurrentItem does not work when PeekAreaInsets is set - fix by @kubaflo in https://github.com/dotnet/maui/pull/29995

  🔧 Fixes
  • [CarouselViewHandler2] CurrentItem does not work when PeekAreaInsets is set

• [release/9.0.1xx-sr12] [iOS] Fix memory leak in CollectionViewHandler2 ItemsLayout PropertyChanged subscription by @github-actions[bot] in https://github.com/dotnet/maui/pull/31922

  🔧 Fixes
  • Fix memory leak in CollectionView and CarouselView by using instance-based ItemsLayout defaults

Controls Entry

• [Android, iOS, MacOS] Fixed Entry ClearButton Color Not Updating on AppThemeBinding Change by @NanthiniMahalingam in https://github.com/dotnet/maui/pull/30817

  🔧 Fixes
  • Facing issues with the Entry, DatePicker, and CheckBox components when applying themes.
  • [iOS] Clear button does not apply TextColor when set at runtime

Controls Flyout

• [Windows] Fixed Unstable order of Flyout Items with conditional visibility by @SubhikshaSf4851 in https://github.com/dotnet/maui/pull/29197

  🔧 Fixes
  • Unstable order of FlyoutItems with conditional visibility

• [Windows, Catalyst] Fix IsPresented=true Not Working on Initial Value in FlyoutPage by @devanathan-vaithiyanathan in https://github.com/dotnet/maui/pull/31515

  🔧 Fixes
  • [Windows, Catalyst] IsPresented=true Not Working on Initial Value in FlyoutPage

Controls Searchbar

• Fix SearchBar IsTextPredictionEnabled false functionality by @Shalini-Ashokan in https://github.com/dotnet/maui/pull/31255

  🔧 Fixes
  • [Android, iOS] IsTextPredictionEnabled="False" for SearchBar not working

• [Android] Fix SearchBar FlowDirection Property Not Working by @devanathan-vaithiyanathan in https://github.com/dotnet/maui/pull/30431

  🔧 Fixes
  • [Android] SearchBar FlowDirection Property Not Working on Android

• [Android] SearchBar does not update colors on theme change - fix by @kubaflo in https://github.com/dotnet/maui/pull/30601

  🔧 Fixes
  • Theme issue on Search bar control in .NET MAUI
  • [Android] SearchBar does not update colors on theme change

Controls Titleview

• [iOS] Shell/navigation page title view - respect the margin property by @kubaflo in https://github.com/dotnet/maui/pull/31701

  🔧 Fixes
  • [iOS] Navigation bar TitleView isn't rendered within the device's bounds.

Data Binding

• [release/9.0.1xx-sr12] Fix ProjectList not displaying due to missing BindingContext update in template sample by @github-actions[bot] in https://github.com/dotnet/maui/pull/31954

  🔧 Fixes
  • Fix ProjectList not displaying due to missing BindingContext update in template sample

Drawing

• [Windows] Allow to remove clip at runtime by @MartyIX in https://github.com/dotnet/maui/pull/31488

  🔧 Fixes
  • [Windows] Fix performance issue using Shadows
  • [Windows] Allow to remove shadows at runtime

• [Android] Sort gradient stops by offset by @kubaflo in https://github.com/dotnet/maui/pull/31318

  🔧 Fixes
  • LinearGradientBrush can not work

Entry

• [release/9.0.1xx-sr12] [Android][Regression] Fixed Entry and Editor AppThemeBinding colors for text and placeholder reset to default on theme change by @github-actions[bot] in https://github.com/dotnet/maui/pull/31921

  🔧 Fixes
  • [Android][Regression] Fixed Entry and Editor AppThemeBinding colors for text and placeholder reset to default on theme change

Gestures

• [Windows] Test inclusion for the PointerGestureRecognizer issue in MultiWindow. by @Ahamed-Ali in https://github.com/dotnet/maui/pull/31143

  🔧 Fixes
  • [Windows]Fixed the PointerGestureRecognizer behaves incorrectly when multiple windows are open.

Infrastructure

• [ci] Run xharness DeviceTests on dnceng-public Helix by @rmarinho in https://github.com/dotnet/maui/pull/30544

  🔧 Fixes
  • Run device tests on dnceng/helix

• [ci] Inventory start by @rmarinho in https://github.com/dotnet/maui/pull/31593

• Separate snapshot diffs artifacts in CI by @jfversluis in https://github.com/dotnet/maui/pull/31724

• [main] Update dependencies from dotnet/xharness by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/31741

• [main] Update dependencies from dotnet/xharness by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/31872

• [release/9.0.1xx-sr12] [ci] Update arcade main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31987

  🔧 Fixes
  • [ci] Update arcade main

Layout

• Fixed System.ArgumentException when setting FlyoutLayoutBehavior dynamically [Windows] by @Dhivya-SF4094 in https://github.com/dotnet/maui/pull/31491

  🔧 Fixes
  • [Windows] System.ArgumentException thrown when setting FlyoutLayoutBehavior dynamically

Navigation

• [iOS] Fix Navigation Page BackButtonTitle Not Updating by @devanathan-vaithiyanathan in https://github.com/dotnet/maui/pull/31583

  🔧 Fixes
  • [iOS, macOS] Navigation Page BackButtonTitle Not Updating

• [Android,Windows] Fix NavigatingFrom event order inconsistency with PushAsync by @Vignesh-SF3580 in https://github.com/dotnet/maui/pull/31536

  🔧 Fixes
  • [Android, Windows] NavigatingFrom event order inconsistent across platforms with PushAsync

• [iOS] Fix added for Navigation.SetTitleView does not work in ios 26. by @sheiksyedm in https://github.com/dotnet/maui/pull/31831

  🔧 Fixes
  • NavigationPage.TitleView content is not displayed on iPadOS 26 when built with Xcode 26
  • Navigation.SetTitleView does not work in ios 26

• Invert NavigationPage UseMauiHandler flag by @drasticactions in https://github.com/dotnet/maui/pull/31859

Other

• .NET 9 Release Branding by @PureWeen in https://github.com/dotnet/maui/pull/31545

• [inflight/candidate] September 15th - Fix null reference in ItemsViewController flow direction by @kubaflo in https://github.com/dotnet/maui/pull/31603

• [Testing] Fixed Test case failure in PR 31525 - [09/15/2025] Candidate by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/31611

• Revert PR #30501 by @sheiksyedm in https://github.com/dotnet/maui/pull/31643

• [inflight/candidate] September 15th, 2025 by @PureWeen in https://github.com/dotnet/maui/pull/31525

• Revert PR - 30526 by @Ahamed-Ali in https://github.com/dotnet/maui/pull/31692

  🔧 Fixes
  • [Windows]Fixed the PointerGestureRecognizer behaves incorrectly when multiple windows are open.
  • [Windows] Upgrade Windows App SDK from 1.7.3 to 1.7.4

• Candidate Branch September 22nd by @PureWeen in https://github.com/dotnet/maui/pull/31681

• 9.0.120 Release Branding by @PureWeen in https://github.com/dotnet/maui/pull/31979

Refreshview

• [Windows] Fix RefreshView Command executes multiple times when IsRefreshing is set to True by @devanathan-vaithiyanathan in https://github.com/dotnet/maui/pull/31471

  🔧 Fixes
  • [Windows] RefreshView Command executes multiple times when IsRefreshing is set to True

Shapes

• [ci] Add back dnceng-public maui pipeline by @rmarinho in https://github.com/dotnet/maui/pull/31524

Shell

• [iOS] Shell/NavigationPage TitleView by @kubaflo in https://github.com/dotnet/maui/pull/20959

  🔧 Fixes
  • Unnecessary Margin in TitleView
  • [Spec] Shell/NavigationPage TitleView
  • [iOS] Wrong default left/right margin in the navigation bar on iOS

• Fix for exception thrown when disconnecting page handlers in the Unloaded event while navigating on MacCatalyst and iOS by @KarthikRajaKalaimani in https://github.com/dotnet/maui/pull/29410

  🔧 Fixes
  • Crash on shell navigation for Mac Catalyst

• [Android] Shell BackButtonBehavior binding Command to valid ICommand causes back button to disappear by @kubaflo in https://github.com/dotnet/maui/pull/28132

  🔧 Fixes
  • [Android] Shell.FlyoutIcon doesn't show correctly.
  • [Android] Shell BackButtonBehavior binding Command to valid ICommand causes back button to disappear

TabbedPage

• [iOS, Mac] TabbedPage overflow "More" button does not works by @kubaflo in https://github.com/dotnet/maui/pull/31385

  🔧 Fixes
  • [iOS, Mac] TabbedPage overflow "More" button does not works

• [Android] Fixed incorrect tab content display in TabbedPage by @Vignesh-SF3580 in https://github.com/dotnet/maui/pull/27294

  🔧 Fixes
  • Android Tabbar, clicking 4th tab opens the 5th tab
  • [TabbedPage] PopToRootAsync displaying wrong page
  • TabbedPage: content not shown after readding

Theming

• Fix NRE on GetSystemResources by @drasticactions in https://github.com/dotnet/maui/pull/31605

WebView

• [Windows] Fix for FlowDirection="RightToLeft" causes mirrored content in WebView and HybridWebView by @HarishwaranVijayakumar in https://github.com/dotnet/maui/pull/30709

  🔧 Fixes
  • [Windows] FlowDirection="RightToLeft" causes mirrored content in WebView and HybridWebView

• Temporarily disable flaky WebView tests using FlakyTest attribute by @Copilot in https://github.com/dotnet/maui/pull/31868

  🔧 Fixes
  • [testing] Re-enable disabled flaky UITests WebViewShouldNotMirrored & CookiesCorrectlyLoadWithMultipleWebViews

Windows

• [Windows] Upgrade Windows App SDK from 1.7.3 to 1.7.4 by @MartyIX in https://github.com/dotnet/maui/pull/31667

• [Windows] Optimize TextHighlighters use by @MartyIX in https://github.com/dotnet/maui/pull/31429

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

• Misc nativeAOT Windows stability adjustments by @morning4coffe-dev in https://github.com/dotnet/maui/pull/31274

  🔧 Fixes
  • [Windows] Improve NativeAOT support

• [Windows] Revert cleanup of AccessibilityExtensions by @MartyIX in https://github.com/dotnet/maui/pull/31608

  🔧 Fixes
  • MAUI 9.0.110 crashes on Windows when SemanticProperties.Description is set for ToolbarItem
  • [Windows] Cleanup of AccessibilityExtensions

• [Windows] Build warnings with older WinAppSDK version by @MartyIX in https://github.com/dotnet/maui/pull/31669

  🔧 Fixes
  • [Windows] Build warnings mention WinAppSDK 1.6 but the used version is 1.7

Xaml

• Delete GlobalXmlns.cs from maui-mobile template by @jfversluis in https://github.com/dotnet/maui/pull/31730

  🔧 Fixes
  • add global xmlns in template

• [Testing] Added Tests for Issue31139 and DispatcherExtensions by @ghost in https://github.com/dotnet/maui/pull/31213

  🔧 Fixes
  • [Testing] Write a test that would have accounted for "Expose DispatcherExtentions"

• [Testing] Feature Matrix UITest Cases for Picker Control by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/30496

• [Testing] Feature matrix UITest Cases for IndicatorView Control by @NafeelaNazhir in https://github.com/dotnet/maui/pull/31156

• [Testing] Resolved Cursor Visibility issue on UITestSearchBar control by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/31041

• [Testing] Feature matrix UITest Cases for TitleBar Control by @HarishKumarSF4517 in https://github.com/dotnet/maui/pull/30905

  🔧 Fixes
  • [macOS] VisualStateManager ForegroundColor State Not Applied
  • [Windows, Mac] RTL FlowDirection causes overlap with native window control buttons in TitleBar

• Add test to MAUI Manual test runner to verify issue #31483 by @CathyZhu0110 in https://github.com/dotnet/maui/pull/31548

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

• [Testing] Fixed Test case failure in PR 31525 - [09/15/2025] Candidate - 2 by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/31645

• Update copilot instructions for UI test categories by @jfversluis in https://github.com/dotnet/maui/pull/31710

• [Testing] - Added tests for Graphics IImage Breaking Issues 30350 & 30425 by @NafeelaNazhir in https://github.com/dotnet/maui/pull/31665

  🔧 Fixes
  • [Testing] - Added tests for Graphics IImage Breaking Issues 30350 & 30425

• [Testing] Added Left/Right Cropping Support for Screenshot Verification in UI Tests by @NafeelaNazhir in https://github.com/dotnet/maui/pull/31715

• [Testing] Feature Matrix UITest Cases for RefreshView Control by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/30614

• [Testing] Feature matrix UITest Cases for TwoPaneView Control by @HarishKumarSF4517 in https://github.com/dotnet/maui/pull/30610

• [Testing] Feature matrix UITest Cases for WebView Control by @NafeelaNazhir in https://github.com/dotnet/maui/pull/30517

• [Testing] Feature matrix UITest Cases for SwipeView Control by @LogishaSelvarajSF4525 in https://github.com/dotnet/maui/pull/30968

• [Testing] Feature matrix UITest Cases for Border Control by @HarishKumarSF4517 in https://github.com/dotnet/maui/pull/29746

• [Testing] Feature matrix UITest Cases for FlyoutPage by @NafeelaNazhir in https://github.com/dotnet/maui/pull/31426

• [Testing] Feature matrix UITest Cases for ContentPage by @HarishKumarSF4517 in https://github.com/dotnet/maui/pull/31144

• [Testing] Feature matrix UITest Cases for Shapes Control by @HarishKumarSF4517 in https://github.com/dotnet/maui/pull/30389

• [Testing] Feature matrix UITest Cases for ContentView Control by @LogishaSelvarajSF4525 in https://github.com/dotnet/maui/pull/31499

• [Testing] Feature matrix UITest Cases for AbsoluteLayout by @NafeelaNazhir in https://github.com/dotnet/maui/pull/31517

• [Testing] Feature matrix UITest Cases for NavigationPage by @HarishKumarSF4517 in https://github.com/dotnet/maui/pull/31468

• [Testing] Feature matrix UITest Cases for Horizontal and Vertical Stack Layout by @HarishKumarSF4517 in https://github.com/dotnet/maui/pull/31393

• Compilation issue resolved on inflight/current branch by @sheiksyedm in https://github.com/dotnet/maui/pull/31675

• Candidate branch september 22nd current item should work test fix by @kubaflo in https://github.com/dotnet/maui/pull/31685

• [Testing] Fixed Test case failure in PR 31681 - [09/22/2025] Candidate by @NafeelaNazhir in https://github.com/dotnet/maui/pull/31696

• [Testing] Fixed Test case failure in PR 31681 - [09/22/2025] Candidate2 by @NafeelaNazhir in https://github.com/dotnet/maui/pull/31712

• [Testing] Fixed Test case failure in PR 31681 - [09/22/2025] Candidate3 by @NafeelaNazhir in https://github.com/dotnet/maui/pull/31723

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

• [testing] Update androidApiLevels for device tests by @rmarinho in https://github.com/dotnet/maui/pull/31827

• [housekeeping] Automated PR to fix formatting errors on inflight/current by @github-actions[bot] in https://github.com/dotnet/maui/pull/31334
• [housekeeping] Automated PR to fix formatting errors on inflight/current by @github-actions[bot] in https://github.com/dotnet/maui/pull/31415
• [housekeeping] Automated PR to fix formatting errors on inflight/current by @github-actions[bot] in https://github.com/dotnet/maui/pull/31509
• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31529
• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31598
• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31638
• [housekeeping] Move to latest extensions version by @rmarinho in https://github.com/dotnet/maui/pull/31697
• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31720
• [housekeeping] Automated PR to fix formatting errors on inflight/current by @github-actions[bot] in https://github.com/dotnet/maui/pull/31576
• [housekeeping] Automated PR to fix formatting errors on inflight/current by @github-actions[bot] in https://github.com/dotnet/maui/pull/31599
• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31742
• Update UI test category Copilot instructions by @jfversluis in https://github.com/dotnet/maui/pull/31748
• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31802
• [ci] Fix branch classification by @rmarinho in https://github.com/dotnet/maui/pull/31811
• [ci] Fix branch classification by @rmarinho in https://github.com/dotnet/maui/pull/31816