9.0.40 SR4 | MAUI Releases

Breaking Changes

Fix Android TextView being truncated under some conditions by Alberto Aldegheri in https://github.com/dotnet/maui/pull/27179
- We want to highlight a minor layout change: due to fixing some rounding errors, certain controls may now display with an additional pixel of space, though this is unlikely to cause breaking changes in your applications. In our testing process, we had to regenerate all reference images, but the visual differences are minimal (typically just a single pixel variance), which you can verify by reviewing the PR where the old and new images appear virtually identical.
Improve shadow rendering on Android, fix shadow clipping on iOS
- Prior to this PR, negative shadow offsets were not rendering correctly. If your app uses negative offsets for shadows, you may notice visual changes in how shadows are displayed after updating. Your shadows will now render as originally intended with the correct offset positioning.
Revert CollectionView, the footer moves to the bottom of the page when the empty view or empty view template is enabled
- This reverts a breaking change in 9.0.30 where EmptyView no longer occupied the entire screen

Highlights

Implement Mac TitleBar by @tj-devel709 in https://github.com/dotnet/maui/pull/25670

Improve shadow rendering on Android, fix shadow clipping on iOS
- It’s recommended to use solid backgrounds along with shadows on Android to enhance rendering performance.

What’s Changed

[iOS] Fixed a crash issue with CollectionView when configured with CollectionViewHandler2 on iOS 15 and iOS 16. by @Tamilarasan-Paranthaman in https://github.com/dotnet/maui/pull/27051
CollectionView Items display issue when Header is resized on iOS by Jakub Florkowski in https://github.com/dotnet/maui/pull/21812
[XAML] Avoid unnecessary steps by Stéphane Delcroix in https://github.com/dotnet/maui/pull/26671
Fix for CollectionView SelectedItem loses Background after opening and closing a Modal page by @Vignesh-SF3580 in https://github.com/dotnet/maui/pull/26694
Fix for unable to select a tab after backing out of a page and returning. by @BagavathiPerumal in https://github.com/dotnet/maui/pull/25011
Fix for [iOS] Use non-overridden traits in AppInfoImplementation.RequestTheme by @SuthiYuvaraj in https://github.com/dotnet/maui/pull/25497
Fix OnNavigatedTo not called when navigating back to a specific page by @devanathan-vaithiyanathan in https://github.com/dotnet/maui/pull/25552
Fixed #26769 - crash when iOS app is running on MacOS by @VitalyKnyazev in https://github.com/dotnet/maui/pull/26771
NullReference fix in ShellPageRendererTracker.UpdateTabBarVisibility() by @Marioo1357 in https://github.com/dotnet/maui/pull/26786
[HybridWebView] Always serialize the value in JS when invoking by Matthew Leibowitz in https://github.com/dotnet/maui/pull/27068
Fix up relevant CA1416 warnings - Set 4 by @Tamilarasan-Paranthaman in https://github.com/dotnet/maui/pull/26995
[XAML] CSS specificity by Stéphane Delcroix in https://github.com/dotnet/maui/pull/19335
[HybridWebView] Bubble up exceptions in JS into .NET by Matthew Leibowitz in https://github.com/dotnet/maui/pull/27129
[HybridWebView] Support calling void and “no return” functions in JS by Matthew Leibowitz in https://github.com/dotnet/maui/pull/27094
Fix the merge conflict in HybridWebViewHandler.cs by Matthew Leibowitz in https://github.com/dotnet/maui/pull/27307
[HybridWebView] Add support for async .NET methods by Matthew Leibowitz in https://github.com/dotnet/maui/pull/25967
[A11y] Add SemanticProperties.Description to the Toolbar Icon by @tj-devel709 in https://github.com/dotnet/maui/pull/27119
Title doesn’t visible when set IsVisible to true of ShellContent by @NirmalKumarYuvaraj in https://github.com/dotnet/maui/pull/26966
Enhanced Stepper to Support Dynamic Increment Mapping by @devanathan-vaithiyanathan in https://github.com/dotnet/maui/pull/24396
Fix iOS ScrollView content being measured with non-infinite constraints during LayoutSubviews pass by Alberto Aldegheri in https://github.com/dotnet/maui/pull/27298
[Binding SG] Removed deprecated InterceptsLocationAttribute by @jkurdek in https://github.com/dotnet/maui/pull/27145
Fixed On Platform=“Default” not working by Jakub Florkowski in https://github.com/dotnet/maui/pull/22148
ScrollX and ScrollY values at the ScrollView.Scrolled event are not consistent in ScrollOrientation.Both mode by @SuthiYuvaraj in https://github.com/dotnet/maui/pull/26931
[iOS] Fix for NullReferenceException in WillMoveToParentViewController When Removing Page During Navigation by @praveenkumarkarunanithi in https://github.com/dotnet/maui/pull/27275
Fix up relevant CA1416 warnings - Set 2 by @Tamilarasan-Paranthaman in https://github.com/dotnet/maui/pull/26724
Improve debugger experience by Pedro Jesus in https://github.com/dotnet/maui/pull/27017
Navigation from the ‘more’ tab by Jakub Florkowski in https://github.com/dotnet/maui/pull/26292
[Windows] Fix titlebar not persisting when page is swapped by @Foda in https://github.com/dotnet/maui/pull/27192
[Windows] Upgrade Windows App SDK from 1.6.3 to 1.6.4 by @MartyIX in https://github.com/dotnet/maui/pull/27172
Radio button’s default template improvements by Jakub Florkowski in https://github.com/dotnet/maui/pull/26719
[Windows] - Fixed Window Title Not Shown When Reverting from TitleBar to Default State by @prakashKannanSf3972 in https://github.com/dotnet/maui/pull/27148
[Windows] Fixed Margin Not Applied to Shell Flyout Template Items on First Display by @prakashKannanSf3972 in https://github.com/dotnet/maui/pull/27060
[iOS] Fix for Left SwipeView Items Conflict with Shell Menu Swipe Gesture by @Tamilarasan-Paranthaman in https://github.com/dotnet/maui/pull/26976
Fix color checking from blocking and add logging by Shane Neuville in https://github.com/dotnet/maui/pull/27400
[iOS]Fix for Character Spacing Not Updating Correctly in Editor for Dynamically Added Text by @devanathan-vaithiyanathan in https://github.com/dotnet/maui/pull/25347
Make ImageSource more async-friendly by @symbiogenesis in https://github.com/dotnet/maui/pull/22098
[XC] don’t call ProvideValue on compiled bindings by Stéphane Delcroix in https://github.com/dotnet/maui/pull/27509
[XC] trim x:Name values by Stéphane Delcroix in https://github.com/dotnet/maui/pull/27452
[Mac] TitleBar not always initally set by @tj-devel709 in https://github.com/dotnet/maui/pull/27487
[XAML] don’t expand types to Extension for x:Static by Stéphane Delcroix in https://github.com/dotnet/maui/pull/17276
Improve debugger display XP by Pedro Jesus in https://github.com/dotnet/maui/pull/27489
[Windows]Fixed Shell Navigating event issue when switching tabs by @Vignesh-SF3580 in https://github.com/dotnet/maui/pull/27197
[Windows] - Resolved FlyoutBehavior “Locked” State Reset Issue After Navigation by @prakashKannanSf3972 in https://github.com/dotnet/maui/pull/27379
Fixed the vertical orientation issue in the CarouselViewHandler2 on iOS by @Ahamed-Ali in https://github.com/dotnet/maui/pull/27273
[Android] Fixed the CarouselView Items overlap issue with PeekAreaInsets by @Ahamed-Ali in https://github.com/dotnet/maui/pull/27499
Fixed CollectionView’s HeaderTemplate is not rendering in iOS and MacCatalyst platform. by @KarthikRajaKalaimani in https://github.com/dotnet/maui/pull/27466
Fix for [Windows]ToolbarItem visibility until Page Disappearing by @SuthiYuvaraj in https://github.com/dotnet/maui/pull/26915
Fix for MenuFlyoutItem stops working after navigating away from and back to page by @BagavathiPerumal in https://github.com/dotnet/maui/pull/25170
[Android] Fix Flickering issue when calling Navigation.PopAsync by @devanathan-vaithiyanathan in https://github.com/dotnet/maui/pull/24887
Fix 19647 by Stéphane Delcroix in https://github.com/dotnet/maui/pull/20127
BindableLayout should disconnect handlers by Alberto Aldegheri in https://github.com/dotnet/maui/pull/27450
Improve shadow rendering on Android, fix shadow clipping on iOS by Alberto Aldegheri in https://github.com/dotnet/maui/pull/26789
26598 - Fix for Tabbar disappears when navigating back from page with hidden TabBar in iOS 18 by @SuthiYuvaraj in https://github.com/dotnet/maui/pull/27582
Avoid compiler error when using init properties with BindingSourceGenerator by @rabuckley in https://github.com/dotnet/maui/pull/27655

Template

Fixed scrolling issue on ProjectListPage by @Vignesh-SF3580 in https://github.com/dotnet/maui/pull/27005
Improve accessibility task overview sample content template by Gerald Versluis in https://github.com/dotnet/maui/pull/26921
[Templates] Make the Project Section accessible using the keyboard by Javier Suárez in https://github.com/dotnet/maui/pull/27222
[Templates] Make Project Section from MainPage accessible using the keyboard by Javier Suárez in https://github.com/dotnet/maui/pull/27224

Testing

[Testing] Fix flaky UITests failing sometimes 2 by Javier Suárez in https://github.com/dotnet/maui/pull/27154
[Testing] Updated Appium.WebDriver to v7.0.0 by Javier Suárez in https://github.com/dotnet/maui/pull/27184
[Testing] Disable system animations to save test execution time by Javier Suárez in https://github.com/dotnet/maui/pull/27370
[Testing] Fix for MacCatalyst flaky tests in CI which fails due window position below the dock layer by @anandhan-rajagopal in https://github.com/dotnet/maui/pull/27279
[Testing] UITest to measure layout passes on a common scenario by Alberto Aldegheri in https://github.com/dotnet/maui/pull/25671
[Testing] Enabling some UITests from Issues folder in Appium-13 by @HarishKumarSF4517 in https://github.com/dotnet/maui/pull/27257
Remove ControlGallery by Gerald Versluis in https://github.com/dotnet/maui/pull/27039
[Testing] Fix flaky UITests failing sometimes 3 by Javier Suárez in https://github.com/dotnet/maui/pull/27277
Fix Issue13551 to use WaitForElement by Shane Neuville in https://github.com/dotnet/maui/pull/27644
[Testing] Implement ContextMenu UITest extension methods by Javier Suárez in https://github.com/dotnet/maui/pull/26204
[Testing] Fix flaky test 4 by Javier Suárez in https://github.com/dotnet/maui/pull/27607
[testing] Update tests demands by Rui Marinho in https://github.com/dotnet/maui/pull/27560
[housekeeping] Automated PR to fix formatting errors by @github-actions in https://github.com/dotnet/maui/pull/27571
[Testing] Implement Appium swipe action on Catalyst using the Mac Driver by Javier Suárez in https://github.com/dotnet/maui/pull/27441
[Testing] Implement PressEnter Appium action on Windows by Javier Suárez in https://github.com/dotnet/maui/pull/27602
Fix UITest screenshot taking on MacCatalyst by Alberto Aldegheri in https://github.com/dotnet/maui/pull/27531
Simplify tests by extracting boilerplate by Matthew Leibowitz in https://github.com/dotnet/maui/pull/27072
[Testing] Resolved bunch of Android UI Test random failures in CI. by @anandhan-rajagopal in https://github.com/dotnet/maui/pull/27066
[Testing] Enabling some UITests from Issues folder in Appium-3 by @nivetha-nagalingam in https://github.com/dotnet/maui/pull/27065
[Testing] Enabling some UITests from Issues folder in Appium-1 by @LogishaSelvarajSF4525 in https://github.com/dotnet/maui/pull/27036
[Testing] Enabling some UITests from Issues folder in Appium-5 by @nivetha-nagalingam in https://github.com/dotnet/maui/pull/27100
[Testing] Enabling some UITests from Issues folder in Appium-4 by @LogishaSelvarajSF4525 in https://github.com/dotnet/maui/pull/27067
[Testing] Resolved flaky UITests failed due to image differences on Catalyst by @anandhan-rajagopal in https://github.com/dotnet/maui/pull/26967
[Testing] Enabling some UITests from Issues folder in Appium-2 by @HarishKumarSF4517 in https://github.com/dotnet/maui/pull/27064
[Testing] Fix flaky UITests failing sometimes 1 by Javier Suárez in https://github.com/dotnet/maui/pull/27091
[Testing] Enabling some UITests from Issues folder in Appium-8 by @LogishaSelvarajSF4525 in https://github.com/dotnet/maui/pull/27182
[Testing] Fix for WebView flaky tests in CI which fails due to network connectivity. by @anandhan-rajagopal in https://github.com/dotnet/maui/pull/27178
[Testing] Enabling some UITests from Issues folder in Appium-7 by @nivetha-nagalingam in https://github.com/dotnet/maui/pull/27181
[Testing] Implement ScrollDownTo and ScrollUpTo methods in Appium by Javier Suárez in https://github.com/dotnet/maui/pull/25601
[Testing] Enabling some UITests from Issues folder in Appium-9 by @HarishKumarSF4517 in https://github.com/dotnet/maui/pull/27232
[Testing] Enabling some UITests from Issues folder in Appium-10 by @nivetha-nagalingam in https://github.com/dotnet/maui/pull/27233
[Testing] Enabling some UITests from Issues folder in Appium-11 by @NafeelaNazhir in https://github.com/dotnet/maui/pull/27255* [Testing] Written UI test for the issue reported in PR 27200 by @Tamilarasan-Paranthaman in https://github.com/dotnet/maui/pull/27244
[Testing] Enabling some UITests from Issues folder in Appium-12 by @LogishaSelvarajSF4525 in https://github.com/dotnet/maui/pull/27256
[Testing] Enabling some UITests from Issues folder in Appium-6 by @HarishKumarSF4517 in https://github.com/dotnet/maui/pull/27102

New Contributors

@HarishKumarSF4517 made their first contribution in https://github.com/dotnet/maui/pull/27064
@Marioo1357 made their first contribution in https://github.com/dotnet/maui/pull/26786
@NafeelaNazhir made their first contribution in https://github.com/dotnet/maui/pull/27255
@praveenkumarkarunanithi made their first contribution in https://github.com/dotnet/maui/pull/27275
@prakashKannanSf3972 made their first contribution in https://github.com/dotnet/maui/pull/27148
@Ahamed-Ali made their first contribution in https://github.com/dotnet/maui/pull/27273
@KarthikRajaKalaimani made their first contribution in https://github.com/dotnet/maui/pull/27466
@rabuckley made their first contribution in https://github.com/dotnet/maui/pull/27655

Docs

Move some absolute layout api docs directly in code by @DianaSoltani in https://github.com/dotnet/maui/pull/24332

Localization

[Localization] Simply Logic for Localization Handoff & Handback by @tj-devel709 in https://github.com/dotnet/maui/pull/27508
[Localization] Fix blocking typo by @tj-devel709 in https://github.com/dotnet/maui/pull/27566
Localized file check-in by OneLocBuild Task: Build definition ID 13330: Build ID 10953111 by @dotnet-bot in https://github.com/dotnet/maui/pull/27569

Full Changelog: https://github.com/dotnet/maui/compare/9.0.30…9.0.40