What's Changed

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

AI

• PR Reviewer Agent by @PureWeen in https://github.com/dotnet/maui/pull/32340

• [AI] Moved PR Reviewer Agent to File-Based Instruction System by @kubaflo in https://github.com/dotnet/maui/pull/32659

• Improved pr-reviewer AI agent and modified the usage instructions in README by @kubaflo in https://github.com/dotnet/maui/pull/32718

• Add checkpoint/resume system for PR review agent by @kubaflo in https://github.com/dotnet/maui/pull/32774

• [AI] The Issue-Resolver agent by @kubaflo in https://github.com/dotnet/maui/pull/32804

• [AI] Fixed links for agents by @kubaflo in https://github.com/dotnet/maui/pull/32818

• Agents scripts by @PureWeen in https://github.com/dotnet/maui/pull/32819

• Add Git workflow rules for Copilot CLI by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32873

• Simplify agent instructions and consolidate sandbox testing workflow by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32950

Animation

• [Windows]Fixed the ViewExtensions RotateYTo and RotateXTo with length 0 crashes by @Ahamed-Ali in https://github.com/dotnet/maui/pull/30167

  🔧 Fixes

  • [Windows]ViewExtensions RotateYTo and RotateXTo with length 0 crashes on Windows

Button

• [Android] Fixed Material controls themeing issue by @NirmalKumarYuvaraj in https://github.com/dotnet/maui/pull/30415

  🔧 Fixes

  • Java.Lang.IllegalArgumentException: The style on this component requires your app theme to be Theme.MaterialComponent.

CollectionView

• Fix for CollectionView with GridItemsLayout (Span=1) doesn't adapt to window width reduction on Windows platform by @praveenkumarkarunanithi in https://github.com/dotnet/maui/pull/31038

  🔧 Fixes

  • [MAUI]I1_Layout-Vertical list and Grid content cannot adapt when the window is reduced

• [iOS] RTL column mirroring in UICollectionView - fix by @kubaflo in https://github.com/dotnet/maui/pull/32372

  🔧 Fixes

  • [iOS] FlowDirection="RightToLeft" issue in CollectionView version 9.0.120

• [iOS][CV2]Fixed Selected item color changes from lightskyblue to lightgray after scrolling when deploying ManualMaui Demo project on iOS 26.1 by @KarthikRajaKalaimani in https://github.com/dotnet/maui/pull/32822

  🔧 Fixes

  • [iOS][CV2]Selected item color changes from lightskyblue to lightgray after scrolling when deploying ManualMaui Demo project on iOS 26.1
  • Fix CollectionView selection color persisting incorrectly after scrolling on iOS 26.1

• [Android] Prevent CollectionView SelectionChanged from triggering on SwipeView gesture by @Vignesh-SF3580 in https://github.com/dotnet/maui/pull/30652

  🔧 Fixes

DateTimePicker

• [iOS] Fix DatePicker to consistently display 4-digit years by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32451

Dialogalert

• Return stub IAlertManagerSubscription for standard AlertManager by @drasticactions in https://github.com/dotnet/maui/pull/32646

Docs

• Add README-AI.md file by @PureWeen in https://github.com/dotnet/maui/pull/32502

• Improve AI agent documentation and testing instructions by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32485

• [release/10.0.1xx-sr2] Add comprehensive README to Microsoft.Maui.Controls NuGet package by @github-actions[bot] in https://github.com/dotnet/maui/pull/33059

Drawing

• [iOS] Fixed LinearGradientBrush in Shell FlyoutBackground misaligned by @SubhikshaSf4851 in https://github.com/dotnet/maui/pull/32137

  🔧 Fixes

  • [iOS] LinearGradientBrush in Shell.FlyoutBackground sometimes misaligned/not calculated correctly

• Fix SolidColorBrush.Equals to compare Color values instead of references by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32956

  🔧 Fixes

  • Application freezes when Background property is set to a DynamicResource of type OnPlatform Color

• Entry Height gets updated when loaded inside the RoundRectangle Shape by @SuthiYuvaraj in https://github.com/dotnet/maui/pull/25166

  🔧 Fixes

  • [regression/8.0.0] Entry bug—height grows on every input event

Entry

• Add accessibility identifier to MauiDoneAccessoryView Done button for UI testing by @jfversluis via @Copilot in https://github.com/dotnet/maui/pull/32828

  🔧 Fixes

  • Make MauiDoneAccessoryView DoneButton accessible

• [iOS] Fixed the text color issue when setting it to null dynamically in Entry, TimePicker, and SearchBar. by @Ahamed-Ali in https://github.com/dotnet/maui/pull/32888

  🔧 Fixes

  • [iOS] Text Color of the Entry, TimePicker and SearchBar is not properly worked on dynamic Scenarios

Essentials

• [Windows] Fix for SemanticScreenReader.Default.Announce throws exception when called from MainPage constructor by @HarishwaranVijayakumar in https://github.com/dotnet/maui/pull/30264

  🔧 Fixes

  • SemanticScreenReader.Default.Announce throws exception when called from MainPage constructor

Essentials Securestorage

• Remove use of storage account read tokens by @mmitche in https://github.com/dotnet/maui/pull/32779

General

• [iOS] - Added Focus propagation to MauiView by @NirmalKumarYuvaraj in https://github.com/dotnet/maui/pull/31154

  🔧 Fixes

  • Add Focus propagation to MauiView

Gestures

• [Windows] Allow tap gesture in ContentView by @jsuarezruiz in https://github.com/dotnet/maui/pull/17482

  🔧 Fixes

  • [regression/7.0.49] TapGestureRecognizer Tapped events not worked in Windows Platform

• [iOS] Fix for Unable to Update iOS SwipeGesture Direction at Runtime by @BagavathiPerumal in https://github.com/dotnet/maui/pull/30165

  🔧 Fixes

  • Unable to Update iOS SwipeGesture Direction at Runtime

Label

• 10.0.20 Update PreReleaseVersionLabel and StabilizePackageVersion by @PureWeen in https://github.com/dotnet/maui/pull/33057

Layout

• Fix ContentViewRespondsWhenViewRemoved test fails on Catalyst by @SuthiYuvaraj in https://github.com/dotnet/maui/pull/32481

  🔧 Fixes

  • [Bug] ContentViewRespondsWhenViewRemoved test fails on Catalyst

• Fixed HorizontalStackLayout Crashes Debugger on Negative Spacing by @devanathan-vaithiyanathan in https://github.com/dotnet/maui/pull/26927

  🔧 Fixes

  • HorizontalStackLayout Crashes Debugger on Negative Spacing

• Fixed Button rendering overflow in StackLayout by @Dhivya-SF4094 in https://github.com/dotnet/maui/pull/28001

  🔧 Fixes

  • Button rendering overflow issue when padding is set in StackLayout.
  • [Windows] StackLayout does not constrain child controls when padding is added

Localization

• LEGO: Pull request from lego/hb_7241b85a-f216-4d55-a9fa-d8030c736df5_20251107204636959 to main by @csigs in https://github.com/dotnet/maui/pull/32449

Map

• [iOS] Map pin InfoWindowClicked event is never fired by @KarthikRajaKalaimani in https://github.com/dotnet/maui/pull/31062

  🔧 Fixes

  • [iOS] Map pin InfoWindowClicked event is never fired

Mediapicker

• Fix MediaPicker and FilePicker returning null on cancellation by @jfversluis via @Copilot in https://github.com/dotnet/maui/pull/32656

  🔧 Fixes

  • MediaPicker.PickPhotosAsync returns null in some cases
  • Comment seemingly conflicts with return type. Neither makes sense.

Modal

• [iOS] Fix modal page crash during app snapshot creation by @jfversluis via @Copilot in https://github.com/dotnet/maui/pull/31866

Navigation

• predictive back gesture support for Android 13+ by @kubaflo in https://github.com/dotnet/maui/pull/32461

  🔧 Fixes

  • [NET 10 regression, Android] Back button crashes the app
  • IServiceProvider is disposed with new Maui Project @ Android

• Fix for Page OnAppearing triggered twice when navigating via ShellItem change with PresentationMode set to Modal by @SyedAbdulAzeemSF4852 in https://github.com/dotnet/maui/pull/32582

  🔧 Fixes

  • Page's OnAppearing triggered twice with ShellItemChanged + PresentationMode Modal combo

Picker

• [Android] Refactor selection limit handling in MediaPicker by @kubaflo in https://github.com/dotnet/maui/pull/32571

  🔧 Fixes

  • MediaPicker.Default.PickPhotosAsync() throws NRE on Maui 10 for Android

• Fix: Picker selects incorrect item after item removal by @Shalini-Ashokan in https://github.com/dotnet/maui/pull/29313

  🔧 Fixes

  • Incorrect logic of the Picker element when an item in a binded collection is deleted

RadioButton

• Removed Value property coercion in RadioButton by @kubaflo in https://github.com/dotnet/maui/pull/32489

  🔧 Fixes

  • [Regression] RadioButton should support Null Value

SafeArea

• [Android] Refactor WindowInsetListener to per-view registry with MauiWindowInsetListener by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32278

• Fix SafeAreaEdges.SoftInput applying bottom padding when keyboard is hidden and inset consumption issue by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32064

• Fix AppBarLayout insets when FlyoutPage is pushed modally on Android by @NirmalKumarYuvaraj via @Copilot in https://github.com/dotnet/maui/pull/32379

  🔧 Fixes

  • When a FlyoutPage is pushed Modally it doesn't inset the AppBarLayout

• Fix content page title clipping on Android API < 30 with window insets compatibility by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32537

  🔧 Fixes

  • Shell content page title position incorrect/clipped

SearchBar

• [iOS] SearchHandler overlaps title and title view - fix by @kubaflo in https://github.com/dotnet/maui/pull/30772

  🔧 Fixes

  • [iOS] SearchHandler overlaps title and title view

Shapes

• Add demands for Darwin OS in UI tests pipeline by @mattleibow in https://github.com/dotnet/maui/pull/32532

• [ci] Add a new pipeline for uitests by @rmarinho in https://github.com/dotnet/maui/pull/32592

• [XSG] add XmlLineInfoProvider by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32530

• Refactor device test stages in pipeline configuration by @mattleibow in https://github.com/dotnet/maui/pull/32712

• Add XAML unit testing guidelines by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32788

Shell

• Replace deprecated ScreenResolutionUtility task with PowerShell script for Windows UI tests by @rmarinho via @Copilot in https://github.com/dotnet/maui/pull/32599

• [iOS] Add size update for Shell Popup Overlay after rotation by @cat0363 in https://github.com/dotnet/maui/pull/15866

  🔧 Fixes

  • The overlay when displaying Shell Flyout is not drawn correctly when the screen is rotated on iOS.

• [Android] NET10 - Exception on quit - fix by @kubaflo in https://github.com/dotnet/maui/pull/32647

  🔧 Fixes

  • NET10 - Exception on quit

• [iOS] Fix for Shell Navigation Bar Remaining Visible After Navigating Back to a ContentPage with NavigationBar Hidden by @SyedAbdulAzeemSF4852 in https://github.com/dotnet/maui/pull/32622

  🔧 Fixes

  • [NET 10] Shell Navigation Bar Remains Visible After Navigating Back to ContentPage with NavBar Hidden (iOS Only)

• [iOS] Added support for large titles in Shell by @kubaflo in https://github.com/dotnet/maui/pull/32081

  🔧 Fixes

  • iOS Page.LargeTitleDisplay does not work on iOS 16.1 Simulators

• [Issue-Resolver] Fix TabBar visibility on macOS 26 (Tahoe) by @kubaflo in https://github.com/dotnet/maui/pull/32910

Slider

• Implemented ios:Slider.UpdateOnTap by @kubaflo in https://github.com/dotnet/maui/pull/20124

  🔧 Fixes

  • iOS-specific Slider.UpdateOnTab doesn't work

SwipeView

• Fix for SwipeView Command Binding Issue in CollectionView Templates by @BagavathiPerumal in https://github.com/dotnet/maui/pull/32790

  🔧 Fixes

  • Binding the Swipe command in a SwipeView within a CollectionView template won't work in .NET 10 RC2.

TabbedPage

• Fix TabbedPage crash on iPadOS 26+ with narrow viewports by @jfversluis via @Copilot in https://github.com/dotnet/maui/pull/32662

  🔧 Fixes

  • TabbedPage crashes on iPadOS 26.1 with windowed applications in narrow viewports

• Fixed the TabBar is not visible on Mac Catalyst on iOS26. by @sheiksyedm in https://github.com/dotnet/maui/pull/32972

  🔧 Fixes

  • .Net 9 TabBar not work on Mac
  • [MacOS 26] 'Search Recipe' and 'My Recipe' tab are missing on MacOS Tahoe 26.1

Templates

• #32624 Rename .NET Aspire to Aspire in Aspire ServiceDefaults templat… by @thimok in https://github.com/dotnet/maui/pull/32626

  🔧 Fixes

  • Aspire template under wrong category in Visual Studio

• Add version 10.0.11 to bug report template by @PureWeen in https://github.com/dotnet/maui/pull/32844

TitleView

• Fix iOS 26 TitleView covering content in Shell and NavigationPage by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32341

  🔧 Fixes

  • Using custom TitleView in AppShell causes shell content to be covered in iOS 26
  • TitleView not showing in iOS 26 - .NET10

WebView

• Fix WebView.EvaluateJavaScriptAsync returning null on iOS for certain websites by @jfversluis via @Copilot in https://github.com/dotnet/maui/pull/31647

  🔧 Fixes

  • Evaluating javascript in MAUI WebView on IOS returns NULL

• Do not include the JS as Content by @mattleibow in https://github.com/dotnet/maui/pull/32783

  🔧 Fixes

  • [.Net 10] [Windows] Build failure when using Identity.Client.Desktop.WinUI3 nuget

• Fix iOS WebView Navigating event not triggered for target="_blank" links by @jfversluis via @Copilot in https://github.com/dotnet/maui/pull/32199

  🔧 Fixes

  • Clicking on a target="_blank" link in WebView on iOS does not do anything

Xaml

• Fix CS8603 error for nullable reference types in SourceGen binding paths by @simonrozsival via @Copilot in https://github.com/dotnet/maui/pull/32480

• [XSG] Add clr-namespace fallback for x:Static with unresolved types by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32630

  🔧 Fixes

  • x:Static on generated types

• [XSG] better AppThemeBinding by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32441

• Enable OnPlatform element simplification for InitializeComponent code generation by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32534

  🔧 Fixes

  • [net10, XSG] Named controls under OnPlatform are not recognized when compiling for different platform

• Fix infinite loop in ProvideValueForReferenceExtension with x:Reference by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32638

  🔧 Fixes

  • Building app gets stuck when MauiXamlInflator is set to SourceGen

• Fix #32670: Generate fully qualified Row/ColumnDefinition types in SourceGen by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32671

  🔧 Fixes

  • Row/Col definition aren't FQ

• Fix BindingSourceGen to detect inaccessible property setters by @simonrozsival via @Copilot in https://github.com/dotnet/maui/pull/32470