dotnet/maui 10.0.40

10.0.40 SR4

on GitHub

What's Changed

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

AI

• Improve write-tests-agent with best practices by @sheiksyedm in #33860

• [Sample] Add Microsoft.Maui.Essentials.AI sample app with multi-agent workflow by @mattleibow in #33610

Ai Agents

• Add FileLoggingProvider for MacCatalyst UI test logging by @PureWeen in #33518

• Improve verify-tests-fail-without-fix Skill by @kubaflo in #33513

• Add find-reviewable-pr skill from existing PR by @PureWeen via @Copilot in #33349

• Add learn-from-pr agent and enhance skills framework structure by @PureWeen via @Copilot in #33579

• Fix PS1 scripts for Windows compatibility by @PureWeen in #33679

• Improve skills and scripts for better agent workflows by @PureWeen in #33699

• [XEXPR] Refactor test skills/agents to dispatcher pattern by @PureWeen via @Copilot in #33721

• [ai] Skill for running device tests by @rmarinho in #33484

• Add ai-summary-comment skill for automated PR review comments by @kubaflo in #33585

• Add PR label management to test verification skill by @kubaflo in #33739

• ai-summary-comment: Simplify PR finalize to two collapsible sections by @kubaflo in #33771

• Improve issue-triage skill: Add gh CLI checks and fix workflow by @PureWeen in #33750

• [ai] Add integration test runner skill by @rmarinho in #33654

• Improve PR Agent Gate verification to prevent result fabrication by @PureWeen in #33806

• Improve test report formatting and summary extraction by @kubaflo in #33793

• Improve try-fix comment parsing and summary by @kubaflo in #33794

• Enhance PR agent: multi-model workflow, blocker handling, shared rules extraction by @PureWeen in #33813

• Enhance pr-finalize skill with code review phase and safety rules by @PureWeen in #33861

• Remove Phase 2 (Tests) from PR agent workflow by @kubaflo in #33905

Blazor

• Fix for BlazorWebView Back Navigation Issues on Android 13+ After Predictive Back Gesture Changes by @SuthiYuvaraj in #33213

  🔧 Fixes

  • Back navigation different between .net 9 and .net 10 blazor hybrid

BlazorWebView

• Add doc comment explaining EnableDefaultCssItems in Blazor templates by @akoeplinger in #33845

Button

• [Testing] Fix flaky UI tests: retryTimeout and SwipeView button fix by @PureWeen in #33749

Checkbox

• [Android] Implement material3 support for CheckBox by @HarishwaranVijayakumar in #33339

  🔧 Fixes

  • Implement Material3 Support for CheckBox

CollectionView

• [Android] Fixed EmptyView doesn’t display when CollectionView is placed inside a VerticalStackLayout by @NanthiniMahalingam in #33134

• [Android] Fix for CollectionView.EmptyView does not remeasure its height when the parent layout changes dynamically, causing incorrect sizing. by @BagavathiPerumal in #33559

  🔧 Fixes

  • CollectionView.EmptyView does not remeasure its height when the parent layout changes dynamically, causing incorrect sizing.

• [Android] Fixed CollectionView reordering last item by @vitalii-vov in #17825

  🔧 Fixes

  • Android app crashes when dragging into CollectionView

Core Lifecycle

• [Android] Skip DisposeWindowScope on Destroying to prevent ObjectDisposedException by @praveenkumarkarunanithi in #33765

  🔧 Fixes

  • Crash when bringing app to foreground by tapping Android notification
  • NET10 - Crash when bringing app to foreground

DateTimePicker

• [iOS] Fix VoiceOver focus not shifting to Picker/DatePicker/TimePicker popups by @kubaflo in #33152

  🔧 Fixes

  • Voiceover does not automatically shift focus to the "Category" popup when it opens.: A11y_Developer balance version .NET 10_Project_ScreenReader

Dialogalert

• [iOS 26] Fix DisplayPromptAsync maxLength not enforced due to new multi-range delegate by @Shalini-Ashokan in #33616

  🔧 Fixes

  • [iOS 26.1] DisplayPromptAsync ignores maxLength and does not respect RTL FlowDirection

Docs

• Update build status badge in README.md by @rmarinho in #33503

• Update build status links in README.md by @rmarinho in #33548

• Migrate Core types API docs from external XML to inline by @jfversluis in #33631

• Migrate Shell namespace API docs from external XML to inline by @jfversluis in #33628

• Migrate Shapes namespace API docs from external XML to inline by @jfversluis in #33627

• Migrate PlatformConfiguration API docs from external XML to inline by @jfversluis in #33629

• Migrate Controls API docs from external XML to inline by @jfversluis in #33641

• Delete remaining external XML documentation files by @jfversluis in #33663

• Add API documentation to Maps and fix TimeChangedEventArgs placeholders by @jfversluis in #33666

• Add API documentation to Controls.Foldable and enable CS1591 by @jfversluis in #33667

• Add XML documentation to Controls.Xaml and enable CS1591 by @jfversluis in #33669

• Enable CS1591 enforcement on projects with 100% doc coverage by @jfversluis in #33675

• Add XML documentation to Controls.Core.Design and enable CS1591 by @jfversluis in #33680

• readme tweaks by @davidortinau in #33830

Essentials

• [Windows]Fix NullReferenceException in OpenReadAsync for FileResult created with full path by @devanathan-vaithiyanathan in #28238

  🔧 Fixes

  • [Windows] FileResult(string fullPath) not initialized properly

Flyout

• [iOS] Shell: Account for SafeArea when positioning flyout footer by @kubaflo in #32891

  🔧 Fixes

  • [IOS] Footer not displaying in iOS when StackOrientation.Horizontal is set on FlyoutFooter

Fonts

• Hide obsolete FontSize values from IDE autocomplete by @noiseonwires in #33694

Gestures

• Fix CustomSwipeControl sample - add missing event handler by @StephaneDelcroix in #33880

  🔧 Fixes

  • [XSG] SwipeItem.Invoked event handler not found

• Android pan fixes by @BurningLights in #21547

  🔧 Fixes

  • Flickering occurs while updating the width of ContentView through PanGestureRecognizer.

Image

• Fix Glide IllegalArgumentException in MauiCustomTarget.clear() for destroyed activities by @jfversluis via @Copilot in #29780

  🔧 Fixes

  • java.lang.IllegalArgumentException: You cannot start a load for a destroyed activity - glide

Label

• [Android] Fix for Label WordWrap width issue causing HorizontalOptions misalignment by @praveenkumarkarunanithi in #33281

  🔧 Fixes

  • [Android] Unexpected Line Breaks in Android, Label with WordWrap Mode Due to Trailing Space.
  • Label not sized correctly on Android

• Fix to Improve Flyout Accessibility by Adjusting UITableViewController Labels by @SuthiYuvaraj in #31619

  🔧 Fixes

  • Navigation section present under hamburger are programmatically define as table :A11y_.NET maui_User can get all the insights of Dashboard_Devtools

• Update PreReleaseVersionLabel to 'servicing' by @PureWeen in #34001

Mediapicker

• [Regression][iOS] Fix MediaPicker PickPhotosAsync getting file name in contentType property by @devanathan-vaithiyanathan in #33390

  🔧 Fixes

  • [iOS] MediaPicker PickPhotosAsync getting file name in contentType property

Navigation

• Fix handler not disconnected when removing non visible pages using RemovePage() by @Vignesh-SF3580 in #32289

  🔧 Fixes

  • NavigationPage.Navigation.RemovePage() fails to disconnect handlers when removing pages, unlike ContentPage.Navigation.RemovePage()

• Shell: Add duplicate route validation for sibling elements by @SubhikshaSf4851 in #32296

  🔧 Fixes

  • OnNavigatedTo is not called when navigating from a specific page

Packaging

• Fix release net11 to workload set by @rmarinho in #33844

• Fix comment and stabilize package version condition by @PureWeen in #34003

Picker

• [Android] Fix Picker IsOpen not reset when picker is dismissed by @devanathan-vaithiyanathan in #33332

  🔧 Fixes

  • [Android] Picker IsOpen not reset when picker is dismissed

• Improved Unfocus support for Picker on Mac Catalyst by @kubaflo in #33127

  🔧 Fixes

  • When using voiceover unable to access expanded list of project combo box: A11y_.NET maui_user can creat a tak_Screen reader
  • Task and Project controls are not accessible with keyboard:A11y_.NET maui_User can create a new task_Keyboard

SafeArea

• [Android] Fixed SafeAreaEdges issue during Shell Navigation Transition by @NirmalKumarYuvaraj in #33788

  🔧 Fixes

  • SafeAreaEdges works correctly only on the first tab in Shell. Other tabs have content colliding with the display cutout in the landscape mode.
  • Label Overlapped by Android Status Bar When Using SafeAreaEdges="Container" in .NET MAUI
  • [MAUI 10] Layout breaks on first navigation (Shell // route) until soft keyboard appears/disappears (Android + iOS)
  • Continuous GC logs on TabbedPage in MAUI 10.0.30

• [iOS] SafeArea: Return Empty for non-ISafeAreaView views (opt-in model) by @praveenkumarkarunanithi in #33526

  🔧 Fixes

  • [iOS] SafeArea is not applied when a ContentPage uses a ControlTemplate

Shapes

• [XSG] Fix inline StyleSheet CSS content with quotes by @StephaneDelcroix in #33874

  🔧 Fixes

  • [XSG] Inline StyleSheet with CDATA sections not parsed correctly

Shell

• [iOS & Catalyst ] Fixed IsEnabled property should work on Tabs by @SubhikshaSf4851 in #33369

  🔧 Fixes

  • [Catalyst] TabBarBackgroundColor, TabBarUnselectedColor, and IsEnabled Not Working as Expected in Shell

• [iOS,Windows] Fix navigation bar colors not resetting when switching ShellContent by @Vignesh-SF3580 in #33228

  🔧 Fixes

  • [iOS, Windows] Shell Navigation bar colors are not updated correctly when switching ShellContent

• [iOS] Fixed Shell navigation on search handler suggestion selection by @SubhikshaSf4851 in #33406

  🔧 Fixes

  • [iOS] Clicking on search suggestions fails to navigate to detail page correctly

• [iOS 26 & Catalyst 26] [Follow-up PR] Fixed IsEnabled behavior on Tabs by @SubhikshaSf4851 in #33337

  🔧 Fixes

  • [Catalyst] TabBarBackgroundColor, TabBarUnselectedColor, and IsEnabled Not Working as Expected in Shell

• [iOS] Fix ObjectDisposedException in TraitCollectionDidChange on window disposal by @jeremy-visionaid in #33353

  🔧 Fixes

  • Intermittent crash on exit on MacCatalyst - ObjectDisposedException

• [Issue-Resolver] Explicit fallback for BackButtonBehavior lookup by @kubaflo in #33204

  🔧 Fixes

  • Setting BackButtonBehavior to not visible or not enabled does not work
  • BackButtonBehavior not bound

Templates

• Update PatchVersion and Bug Report template by @PureWeen in #33521

• [Templates] Add semantic description to CategoryChart for accessibility by @kubaflo in #33617

  🔧 Fixes

  • Talkback Users are unable to access Pie chart: A11y_.NET 9 template_Home screen_Chart Section_Screen reader.

• Fix VoiceOver doesnot announces the State of the ComboBox by @SuthiYuvaraj in #32286

• [Templates] Remove redundant SemanticProperties.Description attribute by @kubaflo in #33621

  🔧 Fixes

  • Task and Project controls are not accessible with keyboard:A11y_.NET maui_User can create a new task_Keyboard
  • Unable to select "Tags" when Voiceover is turned on.: A11y_Developer balance version .NET 10_Project_ScreenReader

Theme

• [Windows] Fix runtime theme update for controls and TitleBar by @Tamilarasan-Paranthaman in #31714

  🔧 Fixes

  • [Windows][MacOS?] Change title bar color when switching light/dark theme at runtime
  • OS system components ignore app theme
  • [Mac Catalyst][Windows] TitleBar not reacting on UserAppTheme changes
  • In dark theme "Back" and "hamburger" button icon color contrast with background color is less than 3:1: A11y_.NET maui_User can get all the insights of Dashboard_Non text Contrast
  • Switch is invisible on PointOver when theme has changed

Theming

• Fix SourceGen missing diagnostic for keyless ResourceDictionary items by @rmarinho in #33708

• [XSG] Fix Style Setters referencing source-generated bindable properties by @simonrozsival in #33562

Titlebar

• [Windows] Fix TitleBar.IsVisible = false the caption buttons become unresponsive by @devanathan-vaithiyanathan in #33256

  🔧 Fixes

  • When TitleBar.IsVisible = false the caption buttons become unresponsive on Windows

WebView

• Fix WebView JavaScript string escaping for backslashes and quotes by @StephaneDelcroix in #33726

• Skip HybridWebView interception test on iOS/MacCatalyst by @rmarinho via @Copilot in #33981

Xaml

• [XSG][BindingSourceGen] Add support for CommunityToolkit.Mvvm ObservablePropertyAttribute by @simonrozsival via @Copilot in #33028

  🔧 Fixes

  • [XSG] Add heuristic to support bindable properties generated by other source generators

• [XSG] Fix invalid code generation for Setter with OnPlatform without Default by @StephaneDelcroix in #33681

  🔧 Fixes

  • [XSG] Setter with OnPlatform without Default generates invalid code when platform doesn't match

• [XEXPR] [Experimental] XAML C# Expressions by @StephaneDelcroix in #33693

• [XSG] Fix NaN value in XAML generating invalid code by @StephaneDelcroix in #33533

  🔧 Fixes

  • [XSG] NaN value in XAML generates invalid code

• Enable XAML Source Generator on ManualTests project by @StephaneDelcroix in #33036

• [XSG] Fix expression binding TProperty type resolution for mismatched source/target types by @StephaneDelcroix in #33994

  🔧 Fixes

  • [XSG] Expression bindings use wrong TProperty type when source and target types differ

• Fix XSG crash when Style Setter uses markup extension with source-generated BindableProperty by @simonrozsival in #33836

  🔧 Fixes

  • [XSG] XSG throws NotImplementedException when Style Setter targets partial property with [BindableProperty] attribute