Skip to content

dotnet/maui

v10.0.20 Breaking

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

Published 5mo 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

Summary

AI summary

Improvements across AI agents, CollectionView layout handling, SafeArea insets, and numerous bug fixes spanning Animation, Button, DateTimePicker, Entry, Drawing, Gestures, Navigation, Picker, RadioButton, Layout, Essentials, Mediapicker, Modal, Testing infrastructure.

Full changelog

What's Changed

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

AI

  • PR Reviewer Agent by @PureWeen in https://github.com/dotnet/maui/pull/32340

  • [AI] Moved PR Reviewer Agent to File-Based Instruction System by @kubaflo in https://github.com/dotnet/maui/pull/32659

  • Improved pr-reviewer AI agent and modified the usage instructions in README by @kubaflo in https://github.com/dotnet/maui/pull/32718

  • Add checkpoint/resume system for PR review agent by @kubaflo in https://github.com/dotnet/maui/pull/32774

  • [AI] The Issue-Resolver agent by @kubaflo in https://github.com/dotnet/maui/pull/32804

  • [AI] Fixed links for agents by @kubaflo in https://github.com/dotnet/maui/pull/32818

  • Agents scripts by @PureWeen in https://github.com/dotnet/maui/pull/32819

  • Add Git workflow rules for Copilot CLI by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32873

  • Simplify agent instructions and consolidate sandbox testing workflow by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32950

Animation

Button

CollectionView

DateTimePicker

  • [iOS] Fix DatePicker to consistently display 4-digit years by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32451

Dialogalert

  • Return stub IAlertManagerSubscription for standard AlertManager by @drasticactions in https://github.com/dotnet/maui/pull/32646

Docs

  • Add README-AI.md file by @PureWeen in https://github.com/dotnet/maui/pull/32502

  • Improve AI agent documentation and testing instructions by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32485

  • [release/10.0.1xx-sr2] Add comprehensive README to Microsoft.Maui.Controls NuGet package by @github-actions[bot] in https://github.com/dotnet/maui/pull/33059

Drawing

Entry

Essentials

Essentials Securestorage

  • Remove use of storage account read tokens by @mmitche in https://github.com/dotnet/maui/pull/32779

General

Gestures

Label

  • 10.0.20 Update PreReleaseVersionLabel and StabilizePackageVersion by @PureWeen in https://github.com/dotnet/maui/pull/33057

Layout

Localization

  • LEGO: Pull request from lego/hb_7241b85a-f216-4d55-a9fa-d8030c736df5_20251107204636959 to main by @csigs in https://github.com/dotnet/maui/pull/32449

Map

Mediapicker

Modal

  • [iOS] Fix modal page crash during app snapshot creation by @jfversluis via @Copilot in https://github.com/dotnet/maui/pull/31866

Navigation

Picker

RadioButton

SafeArea

  • [Android] Refactor WindowInsetListener to per-view registry with MauiWindowInsetListener by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32278

  • Fix SafeAreaEdges.SoftInput applying bottom padding when keyboard is hidden and inset consumption issue by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32064

  • Fix AppBarLayout insets when FlyoutPage is pushed modally on Android by @NirmalKumarYuvaraj via @Copilot in https://github.com/dotnet/maui/pull/32379

    🔧 Fixes

  • Fix content page title clipping on Android API < 30 with window insets compatibility by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32537

    🔧 Fixes

SearchBar

Shapes

  • Add demands for Darwin OS in UI tests pipeline by @mattleibow in https://github.com/dotnet/maui/pull/32532

  • [ci] Add a new pipeline for uitests by @rmarinho in https://github.com/dotnet/maui/pull/32592

  • [XSG] add XmlLineInfoProvider by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32530

  • Refactor device test stages in pipeline configuration by @mattleibow in https://github.com/dotnet/maui/pull/32712

  • Add XAML unit testing guidelines by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32788

Shell

Slider

SwipeView

TabbedPage

Templates

  • #32624 Rename .NET Aspire to Aspire in Aspire ServiceDefaults templat… by @thimok in https://github.com/dotnet/maui/pull/32626

    🔧 Fixes

  • Add version 10.0.11 to bug report template by @PureWeen in https://github.com/dotnet/maui/pull/32844

TitleView

WebView

Xaml

🔧 Infrastructure (29)

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

  • [ci] Add dnceng-public UI tests by @rmarinho in https://github.com/dotnet/maui/pull/32229

  • Update main SR version and Github Issues by @PureWeen in https://github.com/dotnet/maui/pull/32499

  • [ci] Remove x64 demands by @rmarinho in https://github.com/dotnet/maui/pull/32070

  • Move to slnx and slnf by @mattleibow in https://github.com/dotnet/maui/pull/32514

  • [ci] Device tests using MAUI pool for build by @rmarinho in https://github.com/dotnet/maui/pull/32533

  • [ci] Clean nuget.config by @rmarinho in https://github.com/dotnet/maui/pull/32501

  • Update default solution file in settings by @PureWeen in https://github.com/dotnet/maui/pull/32572

  • [ci] Update net10 arcade by @rmarinho in https://github.com/dotnet/maui/pull/32574

  • [ci] Bump to new Xcode to 26.0.1 and .NET default version by @rmarinho in https://github.com/dotnet/maui/pull/32621

  • [main] Bump MicrosoftMauiPreviousDotNetReleasedVersion to 9.0.120 by @github-actions[bot] in https://github.com/dotnet/maui/pull/32613

  • Disable AzDO dependabot by @mmitche in https://github.com/dotnet/maui/pull/32631

  • Add Android emulator startup pattern to common testing patterns by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32615

  • [ci] Try fix RuniOS tests by @rmarinho in https://github.com/dotnet/maui/pull/32633

  • revert moving to slnx by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32619

  • [ci] Add variable group MAUI by @rmarinho in https://github.com/dotnet/maui/pull/32610

  • Change DotNetFeedUrl to internal CI feed by @jfversluis in https://github.com/dotnet/maui/pull/32694

  • [ci] Revert changes setting Creator by @rmarinho in https://github.com/dotnet/maui/pull/32743

  • [Testing] Fail iOS builds fast when Xcode setup fails by @simonrozsival via @Copilot in https://github.com/dotnet/maui/pull/32746

  • November 17th, Inflight Candidate by @PureWeen in https://github.com/dotnet/maui/pull/32509

  • Fix XC0022 and XC0023 warnings by adding x:DataType for compiled bindings by @simonrozsival via @Copilot in https://github.com/dotnet/maui/pull/32444

    🔧 Fixes

  • December 1st, Inflight Candidate by @PureWeen in https://github.com/dotnet/maui/pull/32841

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

  • [ci] Fix format of pipeline by @rmarinho in https://github.com/dotnet/maui/pull/33024

  • December 8th, Candidate by @PureWeen in https://github.com/dotnet/maui/pull/32982

  • Add PR dogfooding script + automatic comment by @jfversluis in https://github.com/dotnet/maui/pull/33043

  • [release/10.0.1xx-sr2] Convert Maui27202 and Maui28711 tests from NUnit to XUnit by @github-actions[bot] in https://github.com/dotnet/maui/pull/33064

  • Sync PR #32835 platform requirements to release/10.0.1xx-sr2 by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/33125

  • [net10.0] Merge main to net10.0 by @rmarinho in https://github.com/dotnet/maui/pull/32959

🧪 Testing (16)

  • [ci] Update Integration tests with $(_MauiDotNetTfm) by @rmarinho in https://github.com/dotnet/maui/pull/32570

  • [ci] Don t push the device tests results by @rmarinho in https://github.com/dotnet/maui/pull/32611

  • [Testing] Feature Matrix UITest Cases for App Themes by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/31458

  • [Testing] Feature Matrix UITest Cases for FlexLayout by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/32036

  • [Testing] Fix Bugzilla41842 test by replacing raw Page with ContentPage by @Shalini-Ashokan in https://github.com/dotnet/maui/pull/31862

    🔧 Fixes

  • [CI] Pre-authorize AVD with ADB keys before starting the emulator by @simonrozsival in https://github.com/dotnet/maui/pull/32730

    🔧 Fixes

  • [Testing] Ignore failure HybridWebViewFeatureTests on Mac by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/32703

    🔧 Fixes

  • [Testing] Fixed DoesNotCrash Test case failure by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/32776

    🔧 Fixes

  • Fix race condition in RemoveInnerPage unit test by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32787

  • Add VisualTestUtils source to replace deprecated NuGet package by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32607

    🔧 Fixes

  • [Testing] Add Appium capabilities to speed up tests by @jsuarezruiz in https://github.com/dotnet/maui/pull/27371

  • Re-enable ConnectivityChanged test after resolving previous issues by @jfversluis in https://github.com/dotnet/maui/pull/32875

  • [Testing] Fixed Test case failure in PR 32841 - [12/01/2025] Candidate by @LogishaSelvarajSF4525 in https://github.com/dotnet/maui/pull/32868

  • [Testing] Additional Feature Matrix Test Cases for ScrollView by @LogishaSelvarajSF4525 in https://github.com/dotnet/maui/pull/32617

  • [Testing] Fixed Test case failure in PR 32982 - [08/12/2025] Candidate by @HarishKumarSF4517 in https://github.com/dotnet/maui/pull/33019

  • Optimize UITest category groups: split, combine, and remove Visual category by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32990

🏠 Housekeeping (2)
  • Added capabilities to get Xcode logs in the Appium server output by @jsuarezruiz in https://github.com/dotnet/maui/pull/32149
  • Use net*.0 wildcard pattern for CI branch triggers by @jfversluis in https://github.com/dotnet/maui/pull/33002
📦 Other (2)
  • No duplicate comments in https://github.com/dotnet/maui/commit/d45dcd2
  • disable appthemebinding on XSG for good in https://github.com/dotnet/maui/commit/f492f7b
**Full Changelog**: https://github.com/dotnet/maui/compare/10.0.11...10.0.20
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]