10.0.0 GA

What's Changed

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

Breaking Changes

• You might have to set your ContentPage to "SafeAreaEdges.Container" to restore .NET9 behavior on Android. In order to fully support edge to edge and make the behavior consistent with iOS we defaulted this to "SafeAreaEdges.None" on .NET 10. https://learn.microsoft.com/en-us/dotnet/maui/user-interface/safe-area?view=net-maui-10.0#android

.NET MAUI Product Fixes

.NET 10 Features

• [net10.0] Merge main to net10.0 by @rmarinho in #31792

• [net10.0] [housekeeping] Update maui net9 by @github-actions[bot] in #31856

  🔧 Fixes

  • [housekeeping] Update maui net9

• [net10] Move to rtm by @rmarinho in #31883

• [net10.0] Bumps Syncfusion.Maui.Toolkit dependency to version 1.0.7 by @github-actions[bot] in #31952

  🔧 Fixes

  • Bumps Syncfusion.Maui.Toolkit dependency to version 1.0.7

• [NET10.0] Change ContentPage SafeAreaEdges default to None for consistent edge-to-edge behavior by @Copilot in #31926

  🔧 Fixes

  • [NET10.0] Change all defaults of SafeAreaEdges so that they will return "None" as the default if the user hasn't set the value

Android

• Implement SafeAreaEdges property and per-edge safe area control for Android by @NirmalKumarYuvaraj in #31022

• [release/10.0.1xx] Remove Android environment variable file handling for Aspire by @github-actions[bot] in #32122

  🔧 Fixes

  • Remove Android environment variable file handling for Aspire

BlazorWebView

• Use the WebView2CompositionControl in Blazor WPF by @mattleibow in #31777

Collectionview

• [net10.0] [Testing] Fix for flaky test(CollectionViewHeaderShouldNotScroll) in CI by @github-actions[bot] in #31933

  🔧 Fixes

  • [Testing] Fix for flaky test(CollectionViewHeaderShouldNotScroll) in CI

• [release/10.0.1xx] [iOS, Catalyst] Fixed CollectionView items height appears larger in Developer Balance sample by @github-actions[bot] in #32046

  🔧 Fixes

  • [iOS, Catalyst] Fixed CollectionView items height appears larger in Developer Balance sample

Infrastructure

• Separate snapshot diffs artifacts in CI by @jfversluis in #31724

• [ci] Add internal release trigger by @rmarinho in #31809

• [main] Update dependencies from dotnet/xharness by @dotnet-maestro[bot] in #31741

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

• [ci] Update maui to 9.0.111 by @rmarinho in #31864

• [release/10.0.1xx] [net10.0] Update dependencies from dotnet/dotnet by @github-actions[bot] in #32058

  🔧 Fixes

  • [net10.0] Update dependencies from dotnet/dotnet

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

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

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

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

• [ci] build stable packages by @rmarinho in #32072

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

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

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

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

• [ci] Update release branch for internal builds by @rmarinho in #32202

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

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

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

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

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

Label

• [release/10.0.1xx] Update label for servicing by @rmarinho in #32098

Layout

• Fix appBarLayout so it extends correctly full screen by @PureWeen in #32060

Navigation

• [net10.0] Invert NavigationPage UseMauiHandler flag by @github-actions[bot] in #31873

  🔧 Fixes

  • Invert NavigationPage UseMauiHandler flag

Other

• LEGO: Pull request from lego/hb_aa4ddd3b-37ca-4d87-a058-1e95d9ca2d38_20251001194204838 to net10.0 by @csigs in #31841

• Sync .NET 9 SR12 with .NET 10 GA release by @PureWeen in #32012

• [release/10.0.1xx] Disable MAUI telemetry for Aspire ServiceDefaults by default by @github-actions[bot] in #32090

  🔧 Fixes

  • Disable MAUI telemetry for Aspire ServiceDefaults by default

• [release/10.0.1xx] [XSG] trim color by @github-actions[bot] in #32066

  🔧 Fixes

  • [XSG] trim color

• [release/10.0.1xx] [XSG] resolve xRefs through listnodes by @github-actions[bot] in #32154

  🔧 Fixes

  • [XSG] resolve xRefs through listnodes

• [release/10.0.1xx] Sync DeveloperBalance sample changes from the MAUI Samples repo to the .NET MAUI repo by @github-actions[bot] in #32175

  🔧 Fixes

  • Sync DeveloperBalance sample changes from the MAUI Samples repo to the .NET MAUI repo

• [release/10.0.1xx] [XSG] enable diagnostis by default on Debug by @github-actions[bot] in #32065

  🔧 Fixes

  • [XSG] enable diagnostics by default on Debug

• Update release ga by @rmarinho in #32160

• [release/10.0.1xx] Duplicated the Empty option for backwards compat by @github-actions[bot] in #32228

  🔧 Fixes

  • Duplicated the Empty option for backwards compat
  • [.NET 10] CLI - Creating new MAUI Blazor Sample App from CLI is .NET 9 by default

ProgressBar

• [Testing] Fix for the ProgressSpinnerWorksWhenReEnabled flaky test in CI by @TamilarasanSF4853 in #31951

Shapes

• [ci] Update with new pipelines by @rmarinho in #32264

• [ci] Update release pipelines by @rmarinho in #32268

Switch

• [release/10.0.1xx] Switch to using POST for .NET method invoke by @github-actions[bot] in #32246

  🔧 Fixes

  • Switch to using POST for .NET method invoke

Templates

• Update multi-project template to .NET 10 by @jfversluis in #31774

• Clean up Extensions.cs by removing TODO comments by @jfversluis in #31901

• Enable OpenTelemetry metrics and tracing for MAUI in Service Defaults by @jfversluis in #31900

  🔧 Fixes

  • Enable MAUI SDK diagnostics by default for Aspire

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

• [net10.0] Clean up template options for the CLI by @mattleibow in #31849

  🔧 Fixes

  • Blazor Hybrid & Web Solution Template: Template options need updating

• Remove DisableDevCertSecurityCheck method in Aspire Service Defaults template by @jfversluis in #31965

• [release/10.0.1xx] fix warnings in templates by @github-actions[bot] in #32195

  🔧 Fixes

  • fix warnings in templates

• [release/10.0.1xx] Improve templates for GA by @mattleibow in #32255

WebView

• [net10.0] Temporarily disable flaky WebView tests using FlakyTest attribute by @github-actions[bot] in #31882

  🔧 Fixes

  • Temporarily disable flaky WebView tests using FlakyTest attribute

Windows

• [release/10.0.1xx] Add longPathAware to Windows app manifest in templates by @github-actions[bot] in #32158

  🔧 Fixes

  • Add longPathAware to Windows app manifest in templates

Xaml

• [XSG] Simplify ColorConverter by @simonrozsival in #31660

iOS

• [iOS] Update net10 iOS to rc2 by @rmarinho in #31749

• [ci] Try better fix for iOS simulator by @rmarinho in #32108

🧪 Testing (5)

• [ci] Fix helix local by @rmarinho in #31796

• [tests] Try run device tests with CoreClr by @rmarinho in #30686

  🔧 Fixes

  • [Testing] Run Controls.DeviceTests with CoreCLR on Android

• [ci] Fix net10 UiTests by @rmarinho in #31837

• [testing] Update device testing by @rmarinho in #31909

• [release/10.0.1xx] [testing] Ignore sample tests for ga by @github-actions[bot] in #32152

  🔧 Fixes

  • [testing] Ignore sample tests for ga

🏠 Housekeeping (8)

• [housekeeping] Automated PR to fix formatting errors on main by @github-actions[bot] in #31802

• [ci] Fix branch classification by @rmarinho in #31811

• [net10.0] [ci] Fix branch classification by @github-actions[bot] in #31812

  🔧 Fixes

  • [ci] Fix branch classification

• [ci] Fix branch classification by @rmarinho in #31816

• LEGO: Pull request from lego/hb_aa4ddd3b-37ca-4d87-a058-1e95d9ca2d38_20251002185521508 to net10.0 by @csigs in #31851

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

• [net10.0] [c] Run apiscan on release branches and main by @github-actions[bot] in #31904

  🔧 Fixes

  • [c] Run apiscan on release branches and main

• [release/10.0.1xx] Try cleanup feeds by @rmarinho in #32142

**Full Changelog**: https://github.com/dotnet/maui/compare/release/10.0.1xx-rc2...10.0.0