.NET Multi-platform App UI Files

What's Changed

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

.NET 10 Features

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

CollectionView

• Fixed the NRE in CarouselViewController on iOS 15.5 & 16.4 by @Ahamed-Ali in https://github.com/dotnet/maui/pull/30838
  

  🔧 Fixes

  - [NRE in CarouselViewController on iOS 15.5 & 16.4](https://github.com/dotnet/maui/issues/28557)

• [iOS, macOS] Fixed CollectionView group header size changes with ItemSizingStrategy by @NanthiniMahalingam in https://github.com/dotnet/maui/pull/33161
  

  🔧 Fixes

  - [[NET 10] I6_Grouping - Grouping_with_variable_sized_items changing the 'ItemSizingStrategy' also changes the header size.](https://github.com/dotnet/maui/issues/33130)

• [iOS][CV2] Fix page can be dragged down, and it would cause an extra space between Header and EmptyView text by @devanathan-vaithiyanathan in https://github.com/dotnet/maui/pull/31840
  

  🔧 Fixes

  - [I8_Header_and_Footer_Null - The page can be dragged down, and it would cause an extra space between Header and EmptyView text.](https://github.com/dotnet/maui/issues/31465)

• [iOS] Fixed the Items not displayed properly in CarouselView2 by @Ahamed-Ali in https://github.com/dotnet/maui/pull/31336
  

  🔧 Fixes

  - [[iOS] Items are not updated properly in CarouselView2.](https://github.com/dotnet/maui/issues/31148)

Docs

• Add comprehensive README to Microsoft.Maui.Controls NuGet package by @jfversluis via @Copilot in https://github.com/dotnet/maui/pull/32835
  

  🔧 Fixes

  - [Improve the MAUI Nuget readme.md file](https://github.com/dotnet/maui/issues/31969)

• Improve Controls Core API docs 2 by @jfversluis in https://github.com/dotnet/maui/pull/33243

• Update investigations docs by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/32949

• Improve agent workflow documentation by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/33434

• Add comprehensive API documentation for GradientStop class by @jfversluis via @Copilot in https://github.com/dotnet/maui/pull/33477

• Add default value documentation for Label.LineBreakMode property by @jfversluis via @Copilot in https://github.com/dotnet/maui/pull/33490

• Improve Controls Core API docs 3 by @jfversluis in https://github.com/dotnet/maui/pull/33391

• Fix build errors for API docs changes by @jfversluis in https://github.com/dotnet/maui/pull/33506

• Improve Controls Core API docs by @jfversluis in https://github.com/dotnet/maui/pull/33240

Editor

• [iOS] Fixed an issue where an Editor with a small height inside a ScrollView would cause the entire page to scroll by @Tamilarasan-Paranthaman in https://github.com/dotnet/maui/pull/27948
  
  🔧 Fixes

  - [[iOS][Editor] An Editor that has not enough height and resides inside a ScrollView/CollectionView will scroll the entire page](https://github.com/dotnet/maui/issues/27750)

Flyout

• Add unit tests for TabBar and FlyoutItem navigation ApplyQueryAttributes (#25663) by @StephaneDelcroix in https://github.com/dotnet/maui/pull/33006

Flyoutpage

• Fixed the FlyoutPage.Flyout Disappearing When Maximizing the Window on Mac Platform by @NanthiniMahalingam in https://github.com/dotnet/maui/pull/26701
  
  🔧 Fixes

  - [FlyoutPage.Flyout - navigation corrupted when running om mac , on window ok](https://github.com/dotnet/maui/issues/22719)

Gestures

• Add UseMaterial3 build property to Sandbox, HostApp and Controls.Sample Projects by @NirmalKumarYuvaraj in https://github.com/dotnet/maui/pull/33282

Image

• [ci[ Fix old image by @rmarinho in https://github.com/dotnet/maui/pull/33422

• [Android] Image control crashes on Android when image width exceeds height by @KarthikRajaKalaimani in https://github.com/dotnet/maui/pull/33045
  

  🔧 Fixes

  - [Image control crashes on Android when image width exceeds height](https://github.com/dotnet/maui/issues/32869)

• Revert PR [#33045]: [Android] Image control crashes on Android when image width exceeds height by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/33413

Label

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

Map

• Add packaged README for Microsoft.Maui.Controls.Maps with quick start guidance by @jfversluis via @Copilot in https://github.com/dotnet/maui/pull/33196

Mediapicker

• [Windows] Fix for PickPhotosAsync throws exception if image is modified by @HarishwaranVijayakumar in https://github.com/dotnet/maui/pull/32952
  

  🔧 Fixes

  - [PickPhotosAsync throws exception if image is modified.](https://github.com/dotnet/maui/issues/32408)

• [Android 🤖] Add a log telling why the request is cancelled by @pictos in https://github.com/dotnet/maui/pull/33295
  

  🔧 Fixes

  - [MediaPicker.PickPhotosAsync throwing TaskCancelledException in net10-android](https://github.com/dotnet/maui/issues/33283)

Navigation

• Fix for TabBar Navigation does not invoke its IQueryAttributable.ApplyQueryAttributes(query) by @SuthiYuvaraj in https://github.com/dotnet/maui/pull/25663
  

  🔧 Fixes

  - [Tabs defined in AppShell.xaml does not invoke its view model's IQueryAttributable.ApplyQueryAttributes(query) implementaion](https://github.com/dotnet/maui/issues/13537) - [`ShellContent` routes do not call `ApplyQueryAttributes`](https://github.com/dotnet/maui/issues/28453)

• [Android] Fix for App Hang When PopModalAsync Is Called Immediately After PushModalAsync with Task.Yield() by @BagavathiPerumal in https://github.com/dotnet/maui/pull/32479
  

  🔧 Fixes

  - [App hangs if PopModalAsync is called after PushModalAsync with single await Task.Yield()](https://github.com/dotnet/maui/issues/32310)

• [iOS 26] Navigation hangs after rapidly open and closing new page using Navigation.PushAsync - fix by @kubaflo in https://github.com/dotnet/maui/pull/32456
  

  🔧 Fixes

  - [[iOS 26] Navigation hangs after rapidly open and closing new page using Navigation.PushAsync](https://github.com/dotnet/maui/issues/32425)

Pages

• [iOS] Fix ContentPage BackgroundImageSource not working by @Shalini-Ashokan in https://github.com/dotnet/maui/pull/33297
  
  🔧 Fixes

  - [.Net MAUI- Page.BackgroundImageSource not working for iOS](https://github.com/dotnet/maui/issues/21594)

RadioButton

• [Issue-Resolver] Fix [#33264] - RadioButtonGroup not working with Collection View by @kubaflo in https://github.com/dotnet/maui/pull/33343
  
  🔧 Fixes

  - [RadioButtonGroup not working with CollectionView](https://github.com/dotnet/maui/issues/33264)

SafeArea

• [Android] Fixed Label Overlapped by Android Status Bar When Using SafeAreaEdges="Container" in .NET MAUI by @NirmalKumarYuvaraj in https://github.com/dotnet/maui/pull/33285
  
  🔧 Fixes

  - [SafeAreaEdges works correctly only on the first tab in Shell. Other tabs have content colliding with the display cutout in the landscape mode.](https://github.com/dotnet/maui/issues/33034) - [Label Overlapped by Android Status Bar When Using SafeAreaEdges="Container" in .NET MAUI](https://github.com/dotnet/maui/issues/32941) - [[MAUI 10] Layout breaks on first navigation (Shell // route) until soft keyboard appears/disappears (Android + iOS)](https://github.com/dotnet/maui/issues/33038)

ScrollView

• Fix ScrollToPosition.Center behavior in ScrollView on iOS and MacCatalyst by @devanathan-vaithiyanathan in https://github.com/dotnet/maui/pull/26825
  

  🔧 Fixes

  - [ScrollToPosition.Center Centers the First Item too in iOS and Catalyst](https://github.com/dotnet/maui/issues/26760) - [On iOS - ScrollView.ScrollToAsync Element, ScrollToPosition.MakeVisible shifts view to the right, instead of just scrolling vertically](https://github.com/dotnet/maui/issues/28965)

• [Windows, Android] Fix ScrollView Content Not Removed When Set to Null by @devanathan-vaithiyanathan in https://github.com/dotnet/maui/pull/33069
  

  🔧 Fixes

  - [[Windows, Android] ScrollView Content Not Removed When Set to Null](https://github.com/dotnet/maui/issues/33067)

Searchbar

• [iOS, Mac, Windows] Fixed CharacterSpacing for SearchBar text and placeholder text by @Dhivya-SF4094 in https://github.com/dotnet/maui/pull/30407
  

  🔧 Fixes

  - [[iOS, Mac, Windows] SearchBar CharacterSpacing property is not working as expected](https://github.com/dotnet/maui/issues/30366)

• Fix Android crash when changing shared Drawable tint on Searchbar by @tritter in https://github.com/dotnet/maui/pull/33071
  

  🔧 Fixes

  - [[Android] Crash on changing Tint of Searchbar](https://github.com/dotnet/maui/issues/33070)

• [Testing] Fixed Test case failure in PR 33363 - [01/05/2026] Candidate - 1 by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/33384

Shapes

• Add inflight/* branch trigger to UI tests pipeline by @PureWeen in https://github.com/dotnet/maui/pull/33447

Shell

• Update logic for large title display mode on iOS - shell by @kubaflo in https://github.com/dotnet/maui/pull/33039

• [iOS] - Fix Custom FlyoutIcon from Being Overridden to Default Color in Shell by @prakashKannanSf3972 in https://github.com/dotnet/maui/pull/27580
  

  🔧 Fixes

  - [Change the flyout icon color](https://github.com/dotnet/maui/issues/6738)

• [iOS] Fix Shell NavBarIsVisible updates when switching ShellContent by @Vignesh-SF3580 in https://github.com/dotnet/maui/pull/33195
  

  🔧 Fixes

  - [[iOS] Shell NavBarIsVisible is not updated when changing ShellContent](https://github.com/dotnet/maui/issues/33191)

Slider

• [C] Fix Slider and Stepper property order independence by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32939
  
  🔧 Fixes

  - [Slider Binding Initialization Order Causes Incorrect Value Assignment in XAML](https://github.com/dotnet/maui/issues/32903) - [Slider is very broken, Value is a mess when setting Minimum](https://github.com/dotnet/maui/issues/14472) - [Slider is buggy depending on order of properties](https://github.com/dotnet/maui/issues/18910) - [Stepper Value is incorrectly clamped to default min/max when using bindableproperties in MVVM pattern](https://github.com/dotnet/maui/issues/12243) - [[Issue-Resolver] Fix [#32903] - Sliderbinding initialization order issue](https://github.com/dotnet/maui/issues/32907)

Stepper

• [Windows] Maui Stepper: Clamp minimum and maximum value by @OomJan in https://github.com/dotnet/maui/pull/33275
  

  🔧 Fixes

  - [[Windows] Maui Stepper is not clamped to minimum or maximum internally](https://github.com/dotnet/maui/issues/33274)

• [iOS] Fixed the UIStepper Value from being clamped based on old higher MinimumValue - Candidate PR test failure fix- 33363 by @Ahamed-Ali in https://github.com/dotnet/maui/pull/33392

TabbedPage

• [windows] Fixed Rapid change of selected tab results in crash. by @praveenkumarkarunanithi in https://github.com/dotnet/maui/pull/33113
  
  🔧 Fixes

  - [Rapid change of selected tab results in crash on Windows.](https://github.com/dotnet/maui/issues/32824)

Templates

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

Theming

• Disable AppThemeBinding source generation for .NET 10 by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/33219

• [Android] Implemented UseMaterial3 build property and provided basic M3 styles by @NirmalKumarYuvaraj in https://github.com/dotnet/maui/pull/33074
  

  🔧 Fixes

  - [Implement `UseMaterial3` MSBuild property to enable M3 at build time](https://github.com/dotnet/maui/issues/33073)

Titlebar

• [Mac] Fix TitleBar Content Overlapping with Traffic Light Buttons on Latest macOS Version by @devanathan-vaithiyanathan in https://github.com/dotnet/maui/pull/33157
  
  🔧 Fixes

  - [TitleBar Content Overlapping with Traffic Light Buttons on Latest macOS Version](https://github.com/dotnet/maui/issues/33136)

TitleView

• [iOS] Fixed memory leak with PopToRootAsync when using TitleView by @Vignesh-SF3580 in https://github.com/dotnet/maui/pull/28547
  
  🔧 Fixes

  - [NavigationPage.TitleView causes memory leak with PopToRootAsync](https://github.com/dotnet/maui/issues/28201)

Xaml

• [C] Fix binding to interface-inherited properties like IReadOnlyList<T>.Count by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32912
  

  🔧 Fixes

  - [Compiled Binding to Array.Count provides no result](https://github.com/dotnet/maui/issues/13872)

• Fix [#31939]: CommandParameter TemplateBinding lost during reparenting by @StephaneDelcroix in https://github.com/dotnet/maui/pull/32961
  

  🔧 Fixes

  - [CommandParameter TemplateBinding Lost During ControlTemplate Reparenting](https://github.com/dotnet/maui/issues/31939)

• [XSG] Skip compiled binding when RelativeSource is used by @StephaneDelcroix in https://github.com/dotnet/maui/pull/33248
  

  🔧 Fixes

  - [[XSG] RelativeSource binding with Path=. returns null when x:DataType is set](https://github.com/dotnet/maui/issues/33247)

• Fix OnPlatform SourceGen for abstract types and protected constructors by @StephaneDelcroix in https://github.com/dotnet/maui/pull/33214

• Revert "Fix ApplyToDerivedTypes not working for implicit styles (#9648)" by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/33397
  

  🔧 Fixes

  - [10.0.20 breaks implicit styles](https://github.com/dotnet/maui/issues/33203)

• Fix for Control does not update from binding anymore after MultiBinding.ConvertBack is called by @BagavathiPerumal in https://github.com/dotnet/maui/pull/33128
  

  🔧 Fixes

  - [Control does not update from binding anymore after MultiBinding.ConvertBack is called](https://github.com/dotnet/maui/issues/24969) - [The issue with the MultiBinding converter with two way binding mode does not work properly when changing the values.](https://github.com/dotnet/maui/issues/20382)

🔧 Infrastructure (10)

- [ci] Remove references to yaml-templates by @rmarinho in https://github.com/dotnet/maui/pull/33089 - [ci] Don t batch runs on public ci by @rmarinho in https://github.com/dotnet/maui/pull/33120 - [ci] Update arcade on main by @rmarinho in https://github.com/dotnet/maui/pull/33100 - [ci] try build tests with coreclr by @rmarinho in https://github.com/dotnet/maui/pull/33212 - [ci] Try use netcore public by @rmarinho in https://github.com/dotnet/maui/pull/33236 - [ci] Use windows pool to queue device tests by @rmarinho in https://github.com/dotnet/maui/pull/33250 - Add pr-build-status skill for querying Azure DevOps builds by @PureWeen in https://github.com/dotnet/maui/pull/33325 - [main] Update dependencies from dotnet/xharness by @dotnet-maestro[bot] in https://github.com/dotnet/maui/pull/33492 - Avoid KVO on CALayer by introducing an Apple PlatformInterop by @albyrock87 in https://github.com/dotnet/maui/pull/30861 - `dotnet-maui` CLI specification by @jonathanpeppers in https://github.com/dotnet/maui/pull/32757

🧪 Testing (20)

- Convert Maui27202 and Maui28711 tests from NUnit to XUnit by @PureWeen in https://github.com/dotnet/maui/pull/33061 - [windows] Workaround for EmitCompilerGeneratedFiles issue by @rmarinho in https://github.com/dotnet/maui/pull/32981

🔧 Fixes

- [Intermittent build error - CS0016: Could not write to output file (path not found)](https://github.com/dotnet/maui/issues/32503)

- [Testing] Fix for flaky UITests in CI - 2 by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/31763 - [Testing] Fix for flaky test(TwoPaneView_Pane1Priority) in CI by @NafeelaNazhir in https://github.com/dotnet/maui/pull/33001 - [Testing] Fix for flaky UITests in CI - 3 by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/33178 - [Testing] Fix for flaky test(VerifyEditorFocusedEvent) in CI by @HarishKumarSF4517 in https://github.com/dotnet/maui/pull/31895 - [Testing] Fix for flaky UITests in CI - 4 by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/33215 - [Testing] Rework Catalyst Test Runner to use startup arguments instead of UI navigation by @NafeelaNazhir in https://github.com/dotnet/maui/pull/31673

🔧 Fixes

- [[Testing] Rework the Catalyst Test Runner so that it will pass in the next test as a startup argument vs navigating by keyboard](https://github.com/dotnet/maui/issues/30285)

- [Testing] Fix for flaky UITests in CI - 5 by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/33259 - [Testing] Fixed Test case failure in PR 33185 - [12/22/2025] Candidate by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/33257 - [Testing] Re-saved ShouldFlyoutBeVisibleAfterMaximizingWindow test case images in PR 33185 - [12/22/2025] Candidate by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/33271 - [Testing] Fixed Test case failure in PR 33185 - [12/22/2025] Candidate - 2 by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/33299 - [Testing] Fixed Test case failure in PR 33185 - [12/22/2025] Candidate - 3 by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/33311 - [Testing] Fix for flaky UITests in CI - 7 by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/33313 - Enforce exactly one Category attribute per UI test by @jfversluis in https://github.com/dotnet/maui/pull/33242 - Fix unit test failures not failing the build by @jfversluis in https://github.com/dotnet/maui/pull/33423 - [ci] Build and run on ARM platforms for iOS UITests and device tests by @rmarinho in https://github.com/dotnet/maui/pull/33474 - [Testing] Enable UITest Issue18193 on MacCatalyst by @NafeelaNazhir in https://github.com/dotnet/maui/pull/31653

🔧 Fixes

- [Test Issue18193 was disabled on Mac Catalyst](https://github.com/dotnet/maui/issues/27206)

- Set the CV2 handlers as the default by @Ahamed-Ali in https://github.com/dotnet/maui/pull/33177 - [iOS] Fix Shell long-press back button not triggering navigation events by @kubaflo in https://github.com/dotnet/maui/pull/33380

🔧 Fixes

- [[Inflight Candidate] - failing test - Issue23892](https://github.com/dotnet/maui/issues/33379)

🏠 Housekeeping (1)

- Make (most) GitHub Actions run only for dotnet org by @jfversluis in https://github.com/dotnet/maui/pull/33046

📦 Other (20)

- Avoid UITest snapshot artifact name collisions across stages by @jfversluis via @Copilot in https://github.com/dotnet/maui/pull/33122 - Update PatchVersion from 20 to 30 by @PureWeen in https://github.com/dotnet/maui/pull/33186 - Add gitignore for TypeScript source map artifacts by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/33222 - Split iOS device tests by category in Helix by @PureWeen in https://github.com/dotnet/maui/pull/33263 - [XSG][BindingSourceGen] Add support for RelayCommand to compiled bindings by @simonrozsival via @Copilot in https://github.com/dotnet/maui/pull/32954

🔧 Fixes

- [Issue [#25818]](https://github.com/dotnet/maui/issues/25818)

- December 22nd, Candidate by @PureWeen in https://github.com/dotnet/maui/pull/33185 - Introduce consolidated 5-phase PR agent workflow with try-fix skill by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/33398 - Replace redundant UITests with unit tests by @StephaneDelcroix in https://github.com/dotnet/maui/pull/33408 - Add weekly branch merge workflow and script by @PureWeen in https://github.com/dotnet/maui/pull/33321 - Add issue-triage skill from PureWeen/maui PR [#9] by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/33327 - Add pr-finalize skill by @PureWeen in https://github.com/dotnet/maui/pull/33453 - Remove debug output from VisualStateManager by @mattleibow in https://github.com/dotnet/maui/pull/33455 - Fix iOS integration tests on Apple Silicon and add individual test lanes by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/33251 - Add MacCatalyst platform support to local UI testing scripts by @PureWeen in https://github.com/dotnet/maui/pull/33486 - Update WindowsAppSDK to 1.8 by @mattleibow in https://github.com/dotnet/maui/pull/32174

🔧 Fixes

- [Update to WindowsAppSDK](https://github.com/dotnet/maui/issues/30858)

- Fix command dependency reentrancy by @simonrozsival in https://github.com/dotnet/maui/pull/33129 - Fix SafeArea AdjustPan handling and add AdjustNothing mode tests by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/33354 - Revert PR [#31653] : [Testing] Enable UITest Issue18193 on MacCatalyst by @TamilarasanSF4853 in https://github.com/dotnet/maui/pull/33393 - January 5th, Candidate by @PureWeen in https://github.com/dotnet/maui/pull/33363 - Revert "Update WindowsAppSDK to 1.8 (#32174)" by @PureWeen via @Copilot in https://github.com/dotnet/maui/pull/33537

Full Changelog: https://github.com/dotnet/maui/compare/10.0.20...release/10.0.1xx-sr3