.NET MAUI 10.0.0-rc1 Release Notes

Getting started

Install from command line:

dotnet workload install maui --version 10.0.100-rc.1.25458.2

What's Changed

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

.NET MAUI Product Fixes

.NET 10 Features

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

Android

• [Testing] Run UI tests with CoreCLR on Android by @rmarinho in #30842

  🔧 Fixes

  • [Testing] Run UI tests with CoreCLR on Android

• [release/10.0.1xx-rc1] Expose Android Activity and Modal Dialog OnKey* overrides via ConfigureLifecycleEvents with generalized context parameter by @github-actions[bot] in #31237

  🔧 Fixes

  • Expose Android Activity and Modal Dialog OnKey* overrides via ConfigureLifecycleEvents with generalized context parameter

• [release/10.0.1xx-rc1] [android] 20250820 net10.0 ecosystem updates by @github-actions[bot] in #31279

  🔧 Fixes

  • [android] 20250820 net10.0 ecosystem updates

• [release/10.0.1xx-rc1] Update sdk 25421.113 and android by @rmarinho in #31287

Collectionview

• Fixed CollectionView does not update layout correctly when ItemsSource changes by @Dhivya-SF4094 in #30978

  🔧 Fixes

  • CollectionView does not update layout correctly when ItemsSource changes

• [inflight/candidate] Update MauiRecyclerView.cs by @github-actions[bot] in #31050

  🔧 Fixes

  • Update MauiRecyclerView.cs

• [NET 10/ WinUI] Open item template context by @pictos in #30852

  🔧 Fixes

  • [NET 10] Open more APIs

• Update ui-tests.yml timeout to account for CollectionView by @PureWeen in #31233

Controls Contextmenu

• [Catalyst] Adding and Removing ContextMenus currently does not work - fix by @kubaflo in #30307

  🔧 Fixes

  • [Catalyst] Adding and Removing ContextMenus currently does not work

Controls Entry

• [Windows] Fixed the Pasted Password Becomes Visible When IsPassword Is Enabled by @Ahamed-Ali in #30353

  🔧 Fixes

  • MAUI Entry Control: Pasted Password Becomes Visible When IsPassword Is Enabled.

Controls Hybridwebview

• [HybridWebView] Add WebViewInitializing and WebViewInitialized Events by @tj-devel709 in #29531

  🔧 Fixes

  • Media Playback Customization in HybridWebView
  • HybridWebView needs a way to customize the platform webview settings/configuration/initialization

Core

• fix some incorrect casting using as by @SimonCropp in #30459

• Make more .NET MAUI Views public by @jsuarezruiz in #30872

  🔧 Fixes

  • [NET 10] Open more APIs

• [android] update AOT profile for .NET 10 RC 1 by @jonathanpeppers in #31187

Core Lifecycle

• Dispose IServiceScope when window is destroyed to prevent memory leaks by @Copilot in #30196

  🔧 Fixes

  • IServiceScope should get disposed when the associated window is destroyed or closed

DateTimePicker

• [Windows] Fixed the ArgumentOutOfRangeException when setting the null to MinimumDate property in DatePicker by @NanthiniMahalingam in #30973

  🔧 Fixes

  • DatePicker: Throws ArgumentOutOfRangeException on WinUI when setting MinimumDate to null

• Fix DatePicker displays today's date instead of blank state when Date is null by @prakashKannanSf3972 in #30657

  🔧 Fixes

  • [iOS] Fix DatePicker to default to Today's date when Date is null/MinimumDate
  • [iOS/Catalyst] If the user specifies NULL for the DatePicker then the picker should default to Todays date when it's opened

• Fixed DatePicker's DateSelected event not firing on Windows - NET 10 Preview 6 by @Dhivya-SF4094 in #30748

  🔧 Fixes

  • DatePicker's DateSelected event not firing on Windows - .NET 10 Preview 6

• [release/10.0.1xx-rc1] Add converters to DatePicker and TimePicker for DateOnly and TimeOnly by @github-actions[bot] in #31276

  🔧 Fixes

  • Add converters to DatePicker and TimePicker for DateOnly and TimeOnly

Docs

• Move externally linked XML API docs to inline source code documentation by @Copilot in #30313

  🔧 Fixes

  • Move externally linked XML API docs to source code

Drawing

• [Windows] Fixed CanvasDrawingSession Exception on Clipping Image by @SubhikshaSf4851 in #30028

  🔧 Fixes

  • [regression/8.0.0] Clipping not working on Windows

• Fixed GraphicsView event handlers are triggered even when IsEnabled is set to False by @Dhivya-SF4094 in #30755

  🔧 Fixes

  • GraphicsView event handlers are triggered even when IsEnabled is set to False

Essentials

• Permissions (BT & WiFi): don't add AccessFineLocation to required permissions if NeverForLocation flag is present by @janusw in #20874

  🔧 Fixes

  • Permission bug: Bluetooth scanning without location permission on Android 12+

• [iOS] Support for bluetooth permission by @kubaflo in #30729

  🔧 Fixes

  • Permissions.CheckStatusAsync<Permissions.Bluetooth> on iOS returns Granted when don't allow is chosen

Frame

• [release/10.0.1xx-rc1] Use ToLowerInvariant().Contains(...) for .NET Framework by @github-actions[bot] in #31354

  🔧 Fixes

  • Use ToLowerInvariant().Contains(...) for .NET Framework

Gestures

• Fix for TapGestureRecognizer ButtonMask always return 0 by @HarishwaranVijayakumar in #30372

  🔧 Fixes

  • TapGestureRecognizer ButtonMask always return 0.

• [Windows]Fixed the PointerGestureRecognizer behaves incorrectly when multiple windows are open. by @Ahamed-Ali in #30537

  🔧 Fixes

  • [Windows] PointerGestureRecognizer behaves incorrectly when multiple windows are open.
  • False positives of PointerGestureRecognizer on Windows with a second minimized window

• [Android] Improve Keyboard Accessibility: Support Spacebar for Android Gesture recognisers by @kubaflo in #29649

  🔧 Fixes

  • [Android] Spacebar Key Does Not Trigger Gesture Recognizers
  • TapGestureRecognizer Controls Not Selectable with Physical Keyboard

Infrastructure

• [main] [release/9.0.1xx-sr8] Fix signing of fonts with arcade infra by @github-actions[bot] in #30938

  🔧 Fixes

  • [release/9.0.1xx-sr8] Fix signing of fonts with arcade infra

• [ci] Clean up some ci files by @rmarinho in #30983

• Add emulator process kill timeout with ADB restart and comprehensive timeout protection by @Copilot in #30941

• [ci] Enable api scan on dnceng by @rmarinho in #30984

• [android] Update gradle.properties by @rmarinho in #30543

• [ci] Allow to continue if error downloading packages by @rmarinho in #31032

• [ci] Update to more stable packages by @rmarinho in #31070

• [ci] Some fixes to clear the _tool project by @rmarinho in #31068

• Workaround Revocation Error by @PureWeen in #31074

• Delete .github/workflows/dotnet-format-pr.yml by @PureWeen in #31089

• Delete .github/workflows/dotnet-format-pr.yml by @PureWeen in #31090

• Better MSBuild log messages in DevOps by @mattleibow in #30281

• [ci] Add more keys by @rmarinho in #31130

• Update bug-report.yml 9.0.100 SR10 by @PureWeen in #31163

• Net10 merge main by @PureWeen in #31160

• [net10.0] Update to RC1 by @rmarinho in #31171

• [android] 20250618 net10.0 ecosystem updates by @jonathanpeppers in #30059

• Mark Performance and IPerformanceProvider types as obsolete and remove all usages by @Copilot in #30942

  🔧 Fixes

  • [Copilot] Set Microsoft.Maui.Controls.Internals.Performance and Microsoft.Maui.Controls.Internals.IPerformanceProvider to Obsolete with ISError set to true

• [ci] Update rc1 dependencies by @rmarinho in #31211

• [release/10.0.1xx-rc1] Fix Build NativeAOT stages on rc1 by @rmarinho in #31277

Layout

• [Windows] Fixed StackLayout crashes on Windows with HeightRequest as 0 by @Dhivya-SF4094 in #29926

  🔧 Fixes

  • StackLayout Throws Exception on Windows When Orientation Is Set with HeightRequest of 0, Padding, and Opposing Alignment

• Mark CompressedLayout API as obsolete and remove XML documentation by @Copilot in #31052

• Change ComputeConstraintForView to return LayoutConstraint instead of using side effects by @Copilot in #31091

  🔧 Fixes

  • Change ComputeConstraintForView to return constraint and set ComputedConstraint via return value (.NET 10.0)

Other

• Fixed the RealParent Warning shown issue by @Ahamed-Ali in #30156

  🔧 Fixes

  • Microsoft.Maui.Controls.Element: Warning: The RealParent on Microsoft.Maui.Controls.Shapes.RoundRectangle has been Garbage Collected. This should never happen. Please log a bug: https://github.com/dotnet/maui

• July 21st, 2025 Candidate by @PureWeen in #30696

  🔧 Fixes

  • Remove .NET 8 specific code from sample content template
  • Remove .NET 8 specific code for templates
  • [housekeeping] Automated PR to fix formatting errors on inflight/current
  • Permissions (BT & WiFi): don't add AccessFineLocation to required permissions if NeverForLocation flag is present
  • [Testing] Feature Matrix UITest Cases for SearchBar Control
  • [Catalyst] Adding and Removing ContextMenus currently does not work - fix
  • StackLayout Throws Exception on Windows When Orientation Is Set with HeightRequest of 0, Padding, and Opposing Alignment
  • [Android] Fix for Search Handler visual and functional bug in subtabs
  • [Testing] Feature Matrix UITest Cases for DatePicker Control
  • [Testing] Feature Matrix UITest Cases for TimePicker Control
  • [Windows] Fixed CanvasDrawingSession Exception on Clipping Image
  • fix some incorrect casting using as
  • [Testing] Feature matrix UITest Cases for ScrollView Control
  • [Catalyst] Fix Scrollbar does not align with FlowDirection change in ScrollView
  • [Testing] Add UITest for Issue30147 on iOS
  • [Windows] Fixed StackLayout crashes on Windows with HeightRequest as 0
  • [Android] Fix for OnSizeAllocated is not reported for Android AppShell Flyout content.
  • Permission bug: Bluetooth scanning without location permission on Android 12+
  • [Windows] Fixed the Pasted Password Becomes Visible When IsPassword Is Enabled
  • fix extention typo
  • [iOS/MacCatalyst] Setting SelectedItem Programmatically and Then Immediately Setting ItemsSource to Null Causes a Crash
  • Microsoft.Maui.Controls.Element: Warning: The RealParent on Microsoft.Maui.Controls.Shapes.RoundRectangle has been Garbage Collected. This should never happen. Please log a bug: https://github.com/dotnet/maui
  • [iOS/MacCatalyst] Fix: Setting SelectedItem Programmatically and Then Immediately Setting ItemsSource to Null Causes a Crash
  • Fixed the RealParent Warning shown issue
  • TapGestureRecognizer ButtonMask always return 0.
  • [regression/8.0.0] Clipping not working on Windows
  • Fix for TapGestureRecognizer ButtonMask always return 0
  • MAUI Entry Control: Pasted Password Becomes Visible When IsPassword Is Enabled.
  • [Catalyst] Scrollbar does not align with FlowDirection change in ScrollView

• .NET 9 SR 10 - August 11th, inflight/candidate by @PureWeen in #31014

  🔧 Fixes

  • iOS Picker Text not clearing when using SelectedIndex = -1
  • CollectionView does not update layout correctly when ItemsSource changes
  • GraphicsView event handlers are triggered even when IsEnabled is set to False

• [v3] Add Diagnostics Metrics Tracking to MAUI Applications by @mattleibow in #31058

  🔧 Fixes

  • Add performance logging and suggestions to .NET MAUI rendering

• Update Versions.props SR11 Versioning by @PureWeen in #31117

• Remove edge to edge from top level container by @PureWeen in #31193

  🔧 Fixes

  • Your app uses deprecated APIs or parameters for edge-to-edge (Android 15)
  • The status bar is blank when ManualMAUITests sample project debugging on the “Android16.0- API 36” emulator
  • [Android] EdgeToEdge does not work for Modal page

• [release/10.0.1xx-rc1] [net10.0] Add UnconditionalSuppressMessage attributes to fix NativeAOT by @github-actions[bot] in #31240

  🔧 Fixes

  • [net10.0] Add UnconditionalSuppressMessage attributes to fix NativeAOT

• [release/10.0.1xx-rc1] [XC|XSG] fix target resolution by @github-actions[bot] in #31235

  🔧 Fixes

  • [XC|XSG] fix target resolution

• [release/10.0.1xx-rc1] NET 10 - Added command and command parameter for CheckBox control by @rmarinho in #31253

• [release/10.0.1xx-rc1] Update rc1 versions by @rmarinho in #31261

• BYPASS_SECRET_SCANNING by @rmarinho in #31321

Picker

• [iOS, Mac] Fix for Picker title is not displayed again when SelectedIndex is set to -1 by @HarishwaranVijayakumar in #30486

  🔧 Fixes

  • iOS Picker Text not clearing when using SelectedIndex = -1
  • [iOS, Mac] Picker title is not displayed again when SelectedIndex is set to -1

RefreshView

• Add IsRefreshEnabled Property and Platform-Consistent IsEnabled Semantics to RefreshView by @Copilot in #30692

  🔧 Fixes

  • Proposal: Add IsRefreshEnabled Property and Platform-Consistent IsEnabled Semantics to RefreshView
  • [Android] Swapping out the content of a RefreshView breaks on Android

ScrollView

• [Catalyst] Fix Scrollbar does not align with FlowDirection change in ScrollView by @devanathan-vaithiyanathan in #30241

  🔧 Fixes

  • [Catalyst] Scrollbar does not align with FlowDirection change in ScrollView

• [Android] Set FillViewport to true to MauiHorizontalScrollView by @kubaflo in #26904

  🔧 Fixes

  • StackLayout inside Scrollview with horizontal orientation not expanding
  • StackLayout inside Scrollview with horizontal orientation not expanding
  • Fill ScrollView when content is smaller than viewport (Horizontal)

• [iOS] Fix extra bottom space in ScrollView when using SafeAreaEdges by @Tamilarasan-Paranthaman in #30976

• [main] [release/10.0.1xx-preview7] [iOS] Fix extra bottom space in ScrollView when using SafeAreaEdges by @github-actions[bot] in #31026

  🔧 Fixes

  • [release/10.0.1xx-preview7] [iOS] Fix extra bottom space in ScrollView when using SafeAreaEdges

• [iOS] ScrollView content offset RTL - fix by @kubaflo in #30724

Shapes

• [ci] Update baseline by @rmarinho in #31008

Shell

• Fix: Null Reference Exception in ShellContentFragment.Destroy by @postalservice14 in #29713

  🔧 Fixes

  • NullReferenceException in ShellContentFragment.Destroy When _shellContext Is Null

• [Android] Fix for OnSizeAllocated is not reported for Android AppShell Flyout content. by @BagavathiPerumal in #30069

  🔧 Fixes

  • [Android] OnSizeAllocated not reported for Android AppShell Flyout content

• [Android] Fix for Search Handler visual and functional bug in subtabs by @BagavathiPerumal in #30467

  🔧 Fixes

  • Search Handler visual and functional bug in subtabs

• Check if tab bar hidden value actually changed for Shell by @jfversluis in #31149

• [main] Check if tab bar hidden value actually changed for Shell by @github-actions[bot] in #31170

  🔧 Fixes

  • Check if tab bar hidden value actually changed for Shell

• [iOS] Auto Resize chrome icons on iOS to make it more consistent with other platforms - Toolbar items by @kubaflo in #30995

  🔧 Fixes

  • [iOS] Auto Resize chrome icons on iOS to make it more consistent with other platforms - Toolbar items

• [release/10.0.1xx-rc1] Fix modal and Shell edge to edge scenarios by @github-actions[bot] in #31236

  🔧 Fixes

  • Fix modal and Shell edge to edge scenarios

Single Project

• Fix duplicate app icon resizing by @jeremy-visionaid in #30920

  🔧 Fixes

  • [Windows] Resizetizer occasionally fails on Azure DevOps pipelines

Templates

• Remove .NET 8 specific code for templates by @jfversluis in #30342

  🔧 Fixes

  • Remove .NET 8 specific code from sample content template

• Changed Syncfusion toolkit version from 1.0.5 to 1.0.6 by @PaulAndersonS in #30960

• Removed ListView styles from the default project template by @sheiksyedm in #31155

  🔧 Fixes

  • The warning of XLS1111 appears once open MAUI App file Resources\Styles\Styles.xaml

• Update .NET Bot for .NET 10 by @jfversluis in #31161

• [net10.0] Fix DeveloperBalance ProjectList page fails to load correctly by @SuthiYuvaraj in #31158

  🔧 Fixes

  • [net10.0] DeveloperBalance ProjectList page fails to load correctly

Toolbar

• [Reverted] ToolbarItem behavior with ImageSource iOS - fix by @kubaflo in #28833

  🔧 Fixes

  • ToolbarItem behavior with ImageSource iOS

Window

• Make IsActivated property public in Window.cs by @pictos in #30987

  🔧 Fixes

  • [NET 10] Open more APIs

Windows

• Revert "Expose DispatcherExtensions so it could be used outside of Maui as well" by @jfversluis in #31184

  🔧 Fixes

  • [net10.0] MAUI no longer marshalls bindable updates to the UI thread
  • Expose DispatcherExtensions so it could be used outside of Maui as well

Xaml

• Fix XAML compiled binding warnings in DeviceTests.Runners by adding x:DataType attributes by @Copilot in #30219

  🔧 Fixes

  • Fix warnings on DeviceTests.Runners

• [release/10.0.1xx-rc1] Xaml Inflator parameters by @github-actions[bot] in #31260

  🔧 Fixes

  • Xaml Inflator parameters

• [release/10.0.1xx-rc1] Always use dot separators in XAML SG converters by @github-actions[bot] in #31270

  🔧 Fixes

  • Always use dot separators in XAML SG converters

iOS

• [iOS/MacCatalyst] Fix: Setting SelectedItem Programmatically and Then Immediately Setting ItemsSource to Null Causes a Crash by @bhavanesh2001 in #29940

  🔧 Fixes

  • [iOS/MacCatalyst] Setting SelectedItem Programmatically and Then Immediately Setting ItemsSource to Null Causes a Crash

• [Testing] Add UITest for Issue30147 on iOS by @devanathan-vaithiyanathan in #30506