.NET MAUI 10.0.0-rc2 Release Notes

Getting started

Install from command line:

dotnet workload install maui --version 10.0.100-rc.2.25513.4

What's Changed

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

.NET MAUI Product Fixes

.NET 10 Features

• [net10.0] Move to net10 rc2 by @rmarinho in #31511

• [net10.0] Update net10 by @rmarinho in #31296

• [NET10] Make IPlatformMeasureInvalidationController public by @Copilot in #31133

• [net10.0] Update net10.0 with main by @PureWeen in #31699

Android

• [android] update AOT profile for .NET 10 RC 2 by @jonathanpeppers in #31768

• [release/10.0.1xx-rc2] Implement SafeAreaEdges property and per-edge safe area control for Android by @github-actions[bot] in #31798

  🔧 Fixes

  • Implement SafeAreaEdges property and per-edge safe area control for Android

Aspire

• Only enable Aspire functionality in non-optimized builds (i.e. Debug) by @jfversluis in #31494

BlazorWebView

• Replace UseStaticFiles() with MapStaticAssets() in Blazor Maui Web template by @Copilot in #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 #31676

  🔧 Fixes

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

• Reland "Replace UseStaticFiles() with MapStaticAssets() in Blazor Maui Web template" by @mattleibow in #31677

  🔧 Fixes

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

• [release/10.0.1xx-rc2] Use the WebView2CompositionControl in Blazor WPF by @github-actions[bot] in #31791

  🔧 Fixes

  • Use the WebView2CompositionControl in Blazor WPF

Button

• Radio Button Null Selection Fix by @asi-evin in #31175

  🔧 Fixes

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

Collectionview

• [iOS]CarouselView Position Not Respected When Changing From Hidden to Visible in CV2 - fix by @kubaflo in #29999

  🔧 Fixes

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

• [iOS] Flyout Menu CollectionView First Item Misaligned - fix by @kubaflo in #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 #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 #31104

  🔧 Fixes

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

• Fix for Preventing Incorrect TalkBack Announcements During CollectionView Deselection on Android by @praveenkumarkarunanithi in #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 #31537

  🔧 Fixes

  • [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
  • [iOS] CarouselView with CarouselViewHandler2 make app crash when Loop="False" and user scroll to the last position - fix

• Fix Customised CollectionView inherited from does not ScrollTo and display selection correctly by @SuthiYuvaraj in #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 #29995

  🔧 Fixes

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

Controls Entry

• [Android] Editor and Entry don't update placeholder and text color on theme change - fix by @kubaflo in #30603

• [Android, iOS, MacOS] Fixed Entry ClearButton Color Not Updating on AppThemeBinding Change by @NanthiniMahalingam in #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 #29197

  🔧 Fixes

  • Unstable order of FlyoutItems with conditional visibility

Controls Hybridwebview

• HybridWebView Bi-Directional Exception Handling by @Copilot in #31521

  🔧 Fixes

  • HybridWebView needs a consistent and usable story for handling C# methods that throw exceptions

Controls Radiobutton

• [.NET 10] Fix RadioButton Test Failure by @Tamilarasan-Paranthaman in #31772

Controls Searchbar

• [iOS] SearchBar placeholder color is not updating on theme change - fix by @kubaflo in #30597

  🔧 Fixes

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

• Fix SearchBar IsTextPredictionEnabled false functionality by @Shalini-Ashokan in #31255

  🔧 Fixes

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

• [Android] Fix SearchBar FlowDirection Property Not Working by @devanathan-vaithiyanathan in #30431

  🔧 Fixes

  • [Android] SearchBar FlowDirection Property Not Working on Android

• [Android] SearchBar does not update colors on theme change - fix by @kubaflo in #30601

  🔧 Fixes

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

Controls Titleview

• [iOS] Shell/navigation page title view - respect the margin property by @kubaflo in #31701

  🔧 Fixes

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

Drawing

• [Windows] Allow to remove clip at runtime by @MartyIX in #31488

  🔧 Fixes

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

• [Android] Sort gradient stops by offset by @kubaflo in #31318

  🔧 Fixes

  • LinearGradientBrush can not work

Essentials

• [Essentials] Add microphone permission handling on Windows and tests by @morning4coffe-dev in #31451

  🔧 Fixes

  • Permissions.Microphone returns Granted on Windows (partial trust) even when denied

Essentials Texttospeech

• [Essentials: Text to speech] Overwrite system default voice by @yeelut in #31105

  🔧 Fixes

  • Text-To-Speech unable to override system's default voices

Flyout

• 30985:Fix FlyoutPage Navigating args to not reach down into the NavigationPage by @SuthiYuvaraj in #31232

  🔧 Fixes

  • [NET10.0] Fix FlyoutPage Navigating args to not reach down into the NavigationPAge
  • [Enhancement] Changes in navigation events parameters

Gestures

• Align OnDoubleTap behavior on Windows and Android by @MartyIX in #20870

  🔧 Fixes

  • TapGestureRecognizer NumberOfTapsRequired=2 Handled Differently on Windows and Android

• Implement PointerGestureRecognizer Buttons by @morning4coffe-dev in #31214

  🔧 Fixes

  • Differentiate Left/Right click in PointerGestureRecognizer

• [Windows] Test inclusion for the PointerGestureRecognizer issue in MultiWindow. by @Ahamed-Ali in #31143

  🔧 Fixes

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

Image

• [Windows] Fixed Image clipping not working by @SubhikshaSf4851 in #30684

  🔧 Fixes

  • [Windows] Image Clipping not working correctly

• [Windows] Fix ImageHandler Vertical&Horizontal Options with AspectFit by @morning4coffe-dev in #30936

  🔧 Fixes

  • Image under WinUI does not respect VerticalOptions and HorizontalOptions

Infrastructure

• Localized file check-in by OneLocBuild Task: Build definition ID 13330: Build ID 12341555 by @dotnet-bot in #31479

• [ci] Run xharness DeviceTests on dnceng-public Helix by @rmarinho in #30544

  🔧 Fixes

  • Run device tests on dnceng/helix

• [ci] Inventory start by @rmarinho in #31593

• [net10.0] Update dependencies from dotnet/android by @dotnet-maestro[bot] in #31594

• [ci] Fix find simulator with new Xcode on the machine by @rmarinho in #31586

• [net10.0] Update dependencies from dotnet/android by @dotnet-maestro[bot] in #31613

• [net10.0] Update dependencies from dotnet/android by @dotnet-maestro[bot] in #31635

• [net10.0] Update dependencies from dotnet/android by @dotnet-maestro[bot] in #31678

• [net10.0] Update dependencies from dotnet/macios by @dotnet-maestro[bot] in #31679

• [net10.0] Update dependencies from dotnet/android by @dotnet-maestro[bot] in #31690

• [net10.0] Update dependencies from dotnet/android by @dotnet-maestro[bot] in #31698

• [net10.0] Update dependencies from dotnet/android by @dotnet-maestro[bot] in #31767

• [net10.0] Update dependencies from dotnet/dotnet by @dotnet-maestro[bot] in #31600

• [ci] Update to latest rc2 by @rmarinho in #31771

• [release/10.0.1xx-rc2] Update dependencies from dotnet/android by @dotnet-maestro[bot] in #31788

• [release/10.0.1xx-rc2] Update dependencies from dotnet/macios by @dotnet-maestro[bot] in #31795

• [release/10.0.1xx-rc2] Update dependencies from dotnet/dotnet by @dotnet-maestro[bot] in #31783

• [release/10.0.1xx-rc2] Update dependencies from dotnet/macios by @dotnet-maestro[bot] in #31801

• [release/10.0.1xx-rc2] [ci] Add internal release trigger by @github-actions[bot] in #31810

  🔧 Fixes

  • [ci] Add internal release trigger

• [release/10.0.1xx-rc2] [net10.0] [ci] Fix branch classification by @github-actions[bot] in #31813

  🔧 Fixes

  • [net10.0] [ci] Fix branch classification

• [release/10.0.1xx-rc2] Localized file check-in by OneLocBuild Task: Build definition ID 13330: Build ID 12504892 by @github-actions[bot] in #31847

  🔧 Fixes

  • Localized file check-in by OneLocBuild Task: Build definition ID 13330: Build ID 12504892

• [release/10.0.1xx-rc2] [ci] Update maui to 9.0.111 by @github-actions[bot] in #31865

  🔧 Fixes

  • [ci] Update maui to 9.0.111

• [release/10.0.1xx-rc2] Update dependencies from dotnet/macios by @dotnet-maestro[bot] in #31884

Layout

• Fixed System.ArgumentException when setting FlyoutLayoutBehavior dynamically [Windows] by @Dhivya-SF4094 in #31491

  🔧 Fixes

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

• [Android] Create a Java layer for LayoutViewGroup by @albyrock87 in #31601

  🔧 Fixes

  • Reduce layout pass java to dotnet jni calls

Mediapicker

• Fix wrongful closing modal when using MediaPicker by @jfversluis in #31500

  🔧 Fixes

  • [iOS] Fix MediaPicker modal dismissal issue in CapturePhotoAsync/CaptureVideoAsync
  • [iOS] MAUI Essentials MediaPicker.CapturePhotoAsync / CaptureVideoAsync causes modal page to dismiss unexpectedly

Navigation

• [Net10] [iOS] Set NavigationBar.Translucent based on NavigationPage BarBackgroundColor transparency by @Tamilarasan-Paranthaman in #30981

• [iOS] Fix Navigation Page BackButtonTitle Not Updating by @devanathan-vaithiyanathan in #31583

  🔧 Fixes

  • [iOS, macOS] Navigation Page BackButtonTitle Not Updating

• [Android,Windows] Fix NavigatingFrom event order inconsistency with PushAsync by @Vignesh-SF3580 in #31536

  🔧 Fixes

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

• [release/10.0.1xx-rc2] [iOS] Fix added for Navigation.SetTitleView does not work in ios 26. by @github-actions[bot] in #31832

  🔧 Fixes

  • [iOS] Fix added for Navigation.SetTitleView does not work in ios 26.

Other

• August 25th, 2025 Candidate by @PureWeen in #31507

  🔧 Fixes

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

• .NET 9 Release Branding by @PureWeen in #31545

• Enhance maui-mobile developer sample with recent updates by @Vignesh-SF3580 in #31489

• Add DisplayRotationStateTrigger for granular device rotation control by @Copilot in #31297

• [inflight/candidate] September 15th - Fix null reference in ItemsViewController flow direction by @kubaflo in #31603

• [Testing] Fixed Test case failure in Update main net10 by @TamilarasanSF4853 in #31592

• remove IElementNode interface by @StephaneDelcroix in #31559

• [Testing] Fixed Test case failure in PR 31525 - [09/15/2025] Candidate by @TamilarasanSF4853 in #31611

• [Testing] Fixed Test case failure in Update main net10 - 2 by @TamilarasanSF4853 in #31632

• Revert PR #30501 by @sheiksyedm in #31643

• avoid enumerating 3 times by @StephaneDelcroix in #31622

  🔧 Fixes

  • [NET10.0] Performance Regression related to XAML Parsing

• [SG] generated code behind for RD in global xmlns by @StephaneDelcroix in #31623

  🔧 Fixes

  • Build succeeds with bad XAML - source gen

• [XSG] make sure RD are properly inflated, and loaded by @StephaneDelcroix in #31482

  🔧 Fixes

  • .NET10-rc1 - XamlSourceGen - Partial method XXX.InitializeComponent()' must have an implementation part because it has accessibility modifiers.

• [inflight/candidate] September 15th, 2025 by @PureWeen in #31525

• Revert PR - 30526 by @Ahamed-Ali in #31692

  🔧 Fixes

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

• Candidate Branch September 22nd by @PureWeen in #31681

• [XSG] support xClassModifier by @StephaneDelcroix in #31754

  🔧 Fixes

  • .NET10-rc1 The type or namespace name 'XamlProcessingAttribute' could not be found

• [release/10.0.1xx-rc2] LEGO: Pull request from lego/hb_aa4ddd3b-37ca-4d87-a058-1e95d9ca2d38_20251001194204838 to net10.0 by @github-actions[bot] in #31844

  🔧 Fixes

  • LEGO: Pull request from lego/hb_aa4ddd3b-37ca-4d87-a058-1e95d9ca2d38_20251001194204838 to net10.0

• [release/10.0.1xx-rc2] LEGO: Pull request from lego/hb_aa4ddd3b-37ca-4d87-a058-1e95d9ca2d38_20251002185521508 to net10.0 by @github-actions[bot] in #31852

  🔧 Fixes

  • LEGO: Pull request from lego/hb_aa4ddd3b-37ca-4d87-a058-1e95d9ca2d38_20251002185521508 to net10.0

Picker

• [MacOS] Fixed the picker items do not appear when tapping on the picker after navigating through PushModalAsync by @NanthiniMahalingam in #28003

  🔧 Fixes

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

Refreshview

• [Windows] Fix RefreshView Command executes multiple times when IsRefreshing is set to True by @devanathan-vaithiyanathan in #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 #31524

• [XSG] Correct lineinfo for expanded markups by @StephaneDelcroix in #31641

  🔧 Fixes

  • [XSG] fix line and position error reporting

• [Windows] Fix LineHeight values <1 having no effect by setting LineStackingStrategy to BlockLineHeight by @MartyIX in #31289

  🔧 Fixes

  • [Windows] Fix LineHeight values < 1 having no effect by setting LineStackingStrategy to BlockLineHeight
  • [Windows] Change the LineStackingStrategy to BlockLineHeight for Labels on Windows

Shell

• [iOS] Shell/NavigationPage TitleView by @kubaflo in #20959

  🔧 Fixes

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

• Shell - Propagate BackButtonBehaviorProperty by @kubaflo in #28615

  🔧 Fixes

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

• Fix for exception thrown when disconnecting page handlers in the Unloaded event while navigating on MacCatalyst and iOS by @KarthikRajaKalaimani in #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 #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 #31385

  🔧 Fixes

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

• [Android] Fixed incorrect tab content display in TabbedPage by @Vignesh-SF3580 in #27294

  🔧 Fixes

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

Templates

• Fix Aspire ServiceDefaults project template naming by @jfversluis in #31616

  🔧 Fixes

  • Aspire ServiceDefaults project name doesn't use provided name

• Update the Blazor project templates by @mattleibow in #31721

  🔧 Fixes

  • Keep Blazor Hybrid templates in sync with Blazor & MAUI

• [net10.0] Delete GlobalXmlns.cs from maui-mobile template by @github-actions[bot] in #31744

  🔧 Fixes

  • Delete GlobalXmlns.cs from maui-mobile template

• [release/10.0.1xx-rc2] Update multi-project template to .NET 10 by @github-actions[bot] in #31784

  🔧 Fixes

  • Update multi-project template to .NET 10

Theming

• Fix NRE on GetSystemResources by @drasticactions in #31605

WebView

• [Windows] Fix for FlowDirection="RightToLeft" causes mirrored content in WebView and HybridWebView by @HarishwaranVijayakumar in #30709

  🔧 Fixes

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

• [release/10.0.1xx-rc2] [Testing] Fix for flaky UITests CookiesCorrectlyLoadWithMultipleWebViews in CI by @github-actions[bot] in #31835

  🔧 Fixes

  • [Testing] Fix for flaky UITests CookiesCorrectlyLoadWithMultipleWebViews in CI

• [release/10.0.1xx-rc2] [net10.0] Temporarily disable flaky WebView tests using FlakyTest attribute by @github-actions[bot] in #31886

  🔧 Fixes

  • [net10.0] Temporarily disable flaky WebView tests using FlakyTest attribute

Windows

• [Windows] Upgrade Windows App SDK from 1.7.3 to 1.7.4 by @MartyIX in #31667

• [Windows] Optimize TextHighlighters use by @MartyIX in #31429

  🔧 Fixes

  • [WinUI] Creating a complex grid is very slow

• Misc nativeAOT Windows stability adjustments by @morning4coffe-dev in #31274

  🔧 Fixes

  • [Windows] Improve NativeAOT support

• [Windows] Revert cleanup of AccessibilityExtensions by @MartyIX in #31608

  🔧 Fixes

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

Xaml

• [XSG] Use absolute file paths when generating #line by @simonrozsival in #31519

  🔧 Fixes

  • [XG] XamlG generates invalid #line paths

• Refactor XAML SourceGen TypeConverters by @jfversluis in #31467

• [templates] do not use 'required' in xaml controls by @StephaneDelcroix in #31564

• [XSG] Fix enum converter by @simonrozsival in #31702

• [X|C] only use a single GridLengthTypeConverter by @StephaneDelcroix in #29376

  🔧 Fixes

  • OnIdiom throws an not implemented Exception (in GridLengthTypeConverter)

• Delete GlobalXmlns.cs from maui-mobile template by @jfversluis in #31730

  🔧 Fixes

  • add global xmlns in template

iOS

• Avoid useless measure passes on iOS by @albyrock87 in #31485

  🔧 Fixes

  • [Testing] UITest to measure layout passes on a common scenario

• [NET10] [iOS] Fix SafeArea does not correctly account for the view area under the soft input by @Tamilarasan-Paranthaman in #31352

  🔧 Fixes

  • [iOS] SafeArea doesn't properly account for how much of a view is under the soft input

• [release/10.0/1xx-rc2] Update net10 ios rc2 by @rmarinho in #31781

macOS

• [ci] Move back to 15.6 for catalyst UITests by @rmarinho in #31807

New Contributors

• @thisisthekap made their first contribution in #31474
• @CathyZhu0110 made their first contribution in #31548
• @yeelut made their first contribution in #31105

Full Changelog: 10.0.0-rc.1.25424.2...10.0.0-rc.2.25504.7