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 Rui Marinho in https://github.com/dotnet/maui/pull/31792

• [net10.0] [housekeeping] Update maui net9 by @github-actions[bot] in https://github.com/dotnet/maui/pull/31856

  🔧 Fixes

  • [housekeeping] Update maui net9

• [net10] Move to rtm by Rui Marinho in https://github.com/dotnet/maui/pull/31883

• [net10.0] Bumps Syncfusion.Maui.Toolkit dependency to version 1.0.7 by @github-actions[bot] in https://github.com/dotnet/maui/pull/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 https://github.com/dotnet/maui/pull/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 https://github.com/dotnet/maui/pull/31022

• [release/10.0.1xx] Remove Android environment variable file handling for Aspire by @github-actions[bot] in https://github.com/dotnet/maui/pull/32122

  🔧 Fixes

  • Remove Android environment variable file handling for Aspire

BlazorWebView

• Use the WebView2CompositionControl in Blazor WPF by Matthew Leibowitz in https://github.com/dotnet/maui/pull/31777

Collectionview

• [net10.0] [Testing] Fix for flaky test(CollectionViewHeaderShouldNotScroll) in CI by @github-actions[bot] in https://github.com/dotnet/maui/pull/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 https://github.com/dotnet/maui/pull/32046

  🔧 Fixes

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

Infrastructure

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

• [ci] Add internal release trigger by Rui Marinho in https://github.com/dotnet/maui/pull/31809

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

• Localized file check-in by OneLocBuild Task: Build definition ID 13330: Build ID 12504892 by @dotnet-bot in https://github.com/dotnet/maui/pull/31845

• [ci] Update maui to 9.0.111 by Rui Marinho in https://github.com/dotnet/maui/pull/31864

• [release/10.0.1xx] [net10.0] Update dependencies from dotnet/dotnet by @github-actions[bot] in https://github.com/dotnet/maui/pull/32058

  🔧 Fixes

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

• [release/10.0.1xx] Update dependencies from dotnet/android by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/32062

• [release/10.0.1xx] Update dependencies from dotnet/macios by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/32063

• [release/10.0.1xx] Update dependencies from dotnet/dotnet by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/32078

• [release/10.0.1xx] Update dependencies from dotnet/macios by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/32076

• [ci] build stable packages by Rui Marinho in https://github.com/dotnet/maui/pull/32072

• [release/10.0.1xx] Update dependencies from dotnet/android by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/32157

• [release/10.0.1xx] Update dependencies from dotnet/macios by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/32165

• [release/10.0.1xx] Update dependencies from dotnet/macios by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/32177

• [release/10.0.1xx] Update dependencies from dotnet/macios by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/32190

• [ci] Update release branch for internal builds by Rui Marinho in https://github.com/dotnet/maui/pull/32202

• [release/10.0.1xx] Update dependencies from dotnet/android by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/32206

• [release/10.0.1xx] Update dependencies from dotnet/macios by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/32231

• [release/10.0.1xx] Update dependencies from dotnet/macios by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/32234

• [release/10.0.1xx] Update dependencies from dotnet/android by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/32235

• [release/10.0.1xx] Update dependencies from dotnet/android by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/32250

Label

• [release/10.0.1xx] Update label for servicing by Rui Marinho in https://github.com/dotnet/maui/pull/32098

Layout

• Fix appBarLayout so it extends correctly full screen by Shane Neuville in https://github.com/dotnet/maui/pull/32060

Navigation

• [net10.0] Invert NavigationPage UseMauiHandler flag by @github-actions[bot] in https://github.com/dotnet/maui/pull/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 https://github.com/dotnet/maui/pull/31841

• Sync .NET 9 SR12 with .NET 10 GA release by Shane Neuville in https://github.com/dotnet/maui/pull/32012

• [release/10.0.1xx] Disable MAUI telemetry for Aspire ServiceDefaults by default by @github-actions[bot] in https://github.com/dotnet/maui/pull/32090

  🔧 Fixes

  • Disable MAUI telemetry for Aspire ServiceDefaults by default

• [release/10.0.1xx] [XSG] trim color by @github-actions[bot] in https://github.com/dotnet/maui/pull/32066

  🔧 Fixes

  • [XSG] trim color

• [release/10.0.1xx] [XSG] resolve xRefs through listnodes by @github-actions[bot] in https://github.com/dotnet/maui/pull/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 https://github.com/dotnet/maui/pull/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 https://github.com/dotnet/maui/pull/32065

  🔧 Fixes

  • [XSG] enable diagnostics by default on Debug

• Update release ga by Rui Marinho in https://github.com/dotnet/maui/pull/32160

• [release/10.0.1xx] Duplicated the Empty option for backwards compat by @github-actions[bot] in https://github.com/dotnet/maui/pull/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 https://github.com/dotnet/maui/pull/31951

Shapes

• [ci] Update with new pipelines by Rui Marinho in https://github.com/dotnet/maui/pull/32264

• [ci] Update release pipelines by Rui Marinho in https://github.com/dotnet/maui/pull/32268

Switch

• [release/10.0.1xx] Switch to using POST for .NET method invoke by @github-actions[bot] in https://github.com/dotnet/maui/pull/32246

  🔧 Fixes

  • Switch to using POST for .NET method invoke

Templates

• Update multi-project template to .NET 10 by Gerald Versluis in https://github.com/dotnet/maui/pull/31774

• Clean up Extensions.cs by removing TODO comments by Gerald Versluis in https://github.com/dotnet/maui/pull/31901

• Enable OpenTelemetry metrics and tracing for MAUI in Service Defaults by Gerald Versluis in https://github.com/dotnet/maui/pull/31900

  🔧 Fixes

  • Enable MAUI SDK diagnostics by default for Aspire

• Enhance maui-mobile developer sample with recent updates by @Vignesh-SF3580 in https://github.com/dotnet/maui/pull/31646

• [net10.0] Clean up template options for the CLI by Matthew Leibowitz in https://github.com/dotnet/maui/pull/31849

  🔧 Fixes

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

• Remove DisableDevCertSecurityCheck method in Aspire Service Defaults template by Gerald Versluis in https://github.com/dotnet/maui/pull/31965

• [release/10.0.1xx] fix warnings in templates by @github-actions[bot] in https://github.com/dotnet/maui/pull/32195

  🔧 Fixes

  • fix warnings in templates

• [release/10.0.1xx] Improve templates for GA by Matthew Leibowitz in https://github.com/dotnet/maui/pull/32255

WebView

• [net10.0] Temporarily disable flaky WebView tests using FlakyTest attribute by @github-actions[bot] in https://github.com/dotnet/maui/pull/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 https://github.com/dotnet/maui/pull/32158

  🔧 Fixes

  • Add longPathAware to Windows app manifest in templates

Xaml

• [XSG] Simplify ColorConverter by @simonrozsival in https://github.com/dotnet/maui/pull/31660

iOS

• [iOS] Update net10 iOS to rc2 by Rui Marinho in https://github.com/dotnet/maui/pull/31749

• [ci] Try better fix for iOS simulator by Rui Marinho in https://github.com/dotnet/maui/pull/32108

🧪 Testing (5)

• [ci] Fix helix local by Rui Marinho in https://github.com/dotnet/maui/pull/31796

• [tests] Try run device tests with CoreClr by Rui Marinho in https://github.com/dotnet/maui/pull/30686

  🔧 Fixes

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

• [ci] Fix net10 UiTests by Rui Marinho in https://github.com/dotnet/maui/pull/31837

• [testing] Update device testing by Rui Marinho in https://github.com/dotnet/maui/pull/31909

• [release/10.0.1xx] [testing] Ignore sample tests for ga by @github-actions[bot] in https://github.com/dotnet/maui/pull/32152

  🔧 Fixes

  • [testing] Ignore sample tests for ga

🏠 Housekeeping (8)

• [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 Rui Marinho in https://github.com/dotnet/maui/pull/31811

• [net10.0] [ci] Fix branch classification by @github-actions[bot] in https://github.com/dotnet/maui/pull/31812

  🔧 Fixes

  • [ci] Fix branch classification

• [ci] Fix branch classification by Rui Marinho in https://github.com/dotnet/maui/pull/31816

• LEGO: Pull request from lego/hb_aa4ddd3b-37ca-4d87-a058-1e95d9ca2d38_20251002185521508 to net10.0 by @csigs in https://github.com/dotnet/maui/pull/31851

• Localized file check-in by OneLocBuild Task: Build definition ID 13330: Build ID 12507670 by @dotnet-bot in https://github.com/dotnet/maui/pull/31854

• [net10.0] [c] Run apiscan on release branches and main by @github-actions[bot] in https://github.com/dotnet/maui/pull/31904

  🔧 Fixes

  • [c] Run apiscan on release branches and main

• [release/10.0.1xx] Try cleanup feeds by Rui Marinho in https://github.com/dotnet/maui/pull/32142

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