Skip to content

dotnet/maui

v10.0.0 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

Published 6mo Build & Package
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

android desktop .net ios maccatalyst maui
+6 more
microsoft mobile multi-platform user-interface winui winui3

Affected surfaces

breaking_upgrade

Summary

AI summary

.NET MAUI 10.0.0 updates Android safe‑area defaults, improves WebView2 handling in Blazor WPF, adds iOS rc2 and Windows manifest changes, refreshes templates for .NET 10, and upgrades many infrastructure dependencies.

Full changelog

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

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

BlazorWebView

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

Collectionview

Infrastructure

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

  • [ci] Add internal release trigger by @rmarinho 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 @rmarinho 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

  • [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 @rmarinho 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 @rmarinho 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 @rmarinho in https://github.com/dotnet/maui/pull/32098

Layout

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

Navigation

Other

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 @rmarinho in https://github.com/dotnet/maui/pull/32264

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

Switch

Templates

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

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

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

    🔧 Fixes

  • 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 @mattleibow in https://github.com/dotnet/maui/pull/31849

    🔧 Fixes

  • Remove DisableDevCertSecurityCheck method in Aspire Service Defaults template by @jfversluis 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

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

WebView

Windows

Xaml

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

iOS

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

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

🧪 Testing (5)

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

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

    🔧 Fixes

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

  • [testing] Update device testing by @rmarinho 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
🏠 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 @rmarinho 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 by @rmarinho 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

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

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

Breaking Changes

  • ContentPage.SafeAreaEdges default changed to SafeAreaEdges.None on .NET 10 (Android); set to SafeAreaEdges.Container to restore .NET 9 behavior.
View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track dotnet/maui

Get notified when new releases ship.

Sign up free

About dotnet/maui

All releases →

Related context

Beta — feedback welcome: [email protected]