[2025/05/12] Candidate - In Flight Branch

[PureWeen]

For more information about inflight process check
https://github.com/dotnet/maui/wiki/Inflight-Branch-Process

.NET MAUI Release Notes - inflight/candidate

This document contains release notes for changes from main branch to inflight/candidate branch.

MAUI Product Fixes

• [iOS] Fix: FlyoutPage memory leak by @bhavanesh001 in [iOS]Fix: FlyoutPage memory leak #28769
• [Windows] Fix for CarouselView IsSwipeEnabled=False Prevents Visual Navigation by @SubhikshaSF4852 in [Windows] Fix for CarouselView IsSwipeEnabled=False Prevents Visual Navigation #29286
• [Windows] Fix for Argument Exception raised when the GetStringSize method of ICanvas called with default font by @SyedAbdulAzeemSF4852 in [Windows] Fix for Argument Exception raised when the GetStringSize method of ICanvas called with default font #29048
• Removed frame styles by @Vignesh-SF3580 in Removed Frame styles from the default project template #29222
• [Android] Fixed the CollectionView Header and Footer Do Not Align with Horizontal ItemsLayout When EmptyView is Displayed by @Ahamed-Ali in [Android] Fixed the CollectionView Header and Footer Do Not Align with Horizontal ItemsLayout When EmptyView is Displayed" #28779
• Add global xmlns in template by @StephaneDelcroix in add global xmlns in template #29203
• Fixed - On iOS GestureRecognizers don't work on Span in a Label, which doesn't get IsVisible (=true) update from its parent by @KarthikRajaKalaimani in Fixed - On iOS GestureRecognizers don't work on Span in a Label, which doesn't get IsVisible (=true) update from its parent #29024
• Fixed Footer not displayed at the Bottom When EmptyView in CV2 by @Dhivya-SF4094 in Fixed Footer not displayed at the Bottom When EmptyView in CV2 #28681
• Fixed typo in Connectivity.shared.cs by @corvinsz in fixed typo in Connectivity.shared.cs #29213

Testing

• Re-enabled flaky UI test TextInEditorShouldScroll by @NirmalKumarYuvaraj in Re-enabled flaky UI test TextInEditorShouldScroll #29167
• [Testing] Re-Enabled UI Test - Issue10222Test by @TamilarasanSF4853 in [Testing] Re-Enabled UI Test - Issue10222Test #29226
• [Testing] Feature Matrix UITest Cases for CollectionView Selection Feature by @LogishaSelvarajSF4525 in [Testing] Feature Matrix UITest Cases for CollectionView Selection Feature  #29165

Dependency Updates

No dependency updates in this release

Docs

No documentation changes in this release

Housekeeping

No housekeeping changes in this release

New Contributors

• @corvinsz made their first contribution in fixed typo in Connectivity.shared.cs #29213

Full Changelog: main...inflight/candidate

[Copilot]

Pull Request Overview

This PR introduces several new test cases and feature enhancements to improve the handling and selection capabilities in CollectionView as well as to address various platform-specific UI adjustments. Key changes include:

• Addition of new test cases for issues and bug fixes (Issue19500, Issue10222, Bugzilla31255, and FlyoutPageTests).
• Enhancements and new properties in the CollectionView view model to support selection modes and events.
• Updates to various platform-specific handlers (iOS, Windows, Android) for improved UI behavior and performance.

Reviewed Changes

Copilot reviewed 56 out of 61 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
src/Controls/tests/TestCases.HostApp/Issues/Issue19500.cs	Added test case for iOS Editor scrolling when IsReadOnly is true.
src/Controls/tests/TestCases.HostApp/Issues/Issue10222.cs	Added tap gesture handling for CarouselView test.
src/Controls/tests/TestCases.HostApp/Issues/Bugzilla/Bugzilla31255.cs	Updated UI elements and page navigation logic for bug fix.
src/Controls/tests/TestCases.HostApp/FeatureMatrix/CollectionView/Selection/*.cs	Introduced new pages and view model improvements for CollectionView selection features.
src/Controls/tests/DeviceTests/Elements/FlyoutPage/FlyoutPageTests.cs	Added test to ensure FlyoutPage does not leak as a modal.
src/Controls/src/Core/Platform/iOS/Extensions/FormattedStringExtensions.cs & Label.iOS.cs	Updated method signatures and calls to include explicit size parameters.
src/Controls/src/Core/Handlers/Items2/iOS/* & ItemsViewController2.cs	Adjusted empty view layout logic and return types for better UI consistency.
src/Controls/src/Core/Handlers/Items/CarouselViewHandler.Windows.cs	Modified scrollbar visibility settings when swipe is disabled.
src/Controls/src/Core/Handlers/Items/Android/MauiRecyclerView.cs	Updated layout manager selection to use a helper method.
src/Controls/src/Core/Compatibility/Handlers/FlyoutPage/iOS/PhoneFlyoutPageRenderer.cs	Changed element storage from a strong reference to a weak reference to improve memory management.

Files not reviewed (5)

• src/Controls/samples/Controls.Sample.Embedding/Resources/Styles/Styles.xaml: Language not supported
• src/Controls/tests/TestCases.HostApp/FeatureMatrix/CollectionView/CollectionViewFeaturePage.xaml: Language not supported
• src/Controls/tests/TestCases.HostApp/FeatureMatrix/CollectionView/Selection/CollectionViewSelectionPage.xaml: Language not supported
• src/Controls/tests/TestCases.HostApp/FeatureMatrix/CollectionView/Selection/SelectionOptionsPage.xaml: Language not supported
• src/Controls/tests/TestCases.HostApp/Issues/Issue19500.xaml: Language not supported

Comments suppressed due to low confidence (3)

src/Controls/src/Core/Compatibility/Handlers/FlyoutPage/iOS/PhoneFlyoutPageRenderer.cs:78

• Using a WeakReference for _element is a good approach to avoid memory leaks. Please ensure that downstream consumers of the Element property can safely handle a null value returned from GetTargetOrDefault().

public VisualElement Element => _viewHandlerWrapper.Element ?? _element?.GetTargetOrDefault();

src/Controls/src/Core/Handlers/Items/CarouselViewHandler.Windows.cs:238

• The change to use WScrollBarVisibility.Hidden instead of Disabled may alter the visual feedback for users. It would be helpful to document this UI behavior change to inform maintainers and consumers.

ScrollViewer.SetHorizontalScrollBarVisibility(ListViewBase, ItemsView.IsSwipeEnabled ? WScrollBarVisibility.Auto : WScrollBarVisibility.Hidden);

src/Controls/src/Core/Handlers/Items/Android/MauiRecyclerView.cs:579

• Ensure that the SelectLayoutManager method reliably returns the appropriate layout manager for all supported ItemsLayout cases, so that no layout issues occur in various scenarios.

SetLayoutManager(SelectLayoutManager(ItemsLayout));