Fix AppBarLayout insets when FlyoutPage is pushed modally on Android (#32379)

* Initial plan

* Fix FlyoutPage modal AppBarLayout inset issue by enhancing recursive search

Co-authored-by: NirmalKumarYuvaraj <[email protected]>

# Conflicts:
#	src/Core/src/Platform/Android/GlobalWindowInsetListener.cs

* Apply code formatting to GlobalWindowInsetListener and test

Co-authored-by: NirmalKumarYuvaraj <[email protected]>

* Address code review feedback: use named constant and proper using statement

Co-authored-by: NirmalKumarYuvaraj <[email protected]>

* Replace DeviceTest with UI Test for Issue32277

Co-authored-by: NirmalKumarYuvaraj <[email protected]>

* Use VerifyScreenshot() instead of WaitForElement for visual verification

Co-authored-by: NirmalKumarYuvaraj <[email protected]>

* added pending snapshots

* - fixed UItest to reproduce the problem

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: NirmalKumarYuvaraj <[email protected]>
Co-authored-by: Shane Neuville <[email protected]>

Author: 3 people

src/Controls/tests/TestCases.Android.Tests/snapshots/android/FlyoutPageModalAppBarLayoutGetsInsets.png

@@ -0,0 +1,73 @@
+namespace Maui.Controls.Sample.Issues;
+
+[Issue(IssueTracker.Github, 32277, "When a FlyoutPage is pushed Modally it doesn't inset the AppBarLayout", PlatformAffected.Android)]
+public partial class Issue32277 : NavigationPage
+{
+	public Issue32277()
+	{
+		PushAsync(new Issue32277_ContentPage());
+	}
+}
+
+public class Issue32277_ContentPage : ContentPage
+{
+	public Issue32277_ContentPage()
+	{
+		Title = "Issue 32277";
+		
+		Button button = new Button
+		{
+			Text = "Push Modal Flyout Page",
+			AutomationId = "PushModalFlyoutButton"
+		};
+		button.Clicked += async (s, e) =>
+		{
+			await Navigation.PushModalAsync(new Issue32277_FlyoutPage());
+		};
+		Content = new StackLayout
+		{
+			Children =
+			{
+				button
+			}
+		};
+	}
+}
+
+public class Issue32277_FlyoutPage : FlyoutPage
+{
+	public Issue32277_FlyoutPage()
+	{
+		Flyout = new ContentPage
+		{
+			Title = "Flyout",
+			Content = new StackLayout
+			{
+				Children =
+				{
+					new Label 
+					{ 
+						Text = "This is the flyout page.",
+						AutomationId = "FlyoutLabel"
+					}
+				}
+			}
+		};
+
+		Detail = new NavigationPage(new ContentPage
+		{
+			Title = "Detail",
+			Content = new StackLayout
+			{
+				Children =
+				{
+					new Label 
+					{ 
+						Text = "This is the detail page.",
+						AutomationId = "DetailLabel"
+					}
+				}
+			}
+		});
+	}
+}

src/Controls/tests/TestCases.HostApp/Issues/Issue32277.cs

@@ -0,0 +1,33 @@
+#if ANDROID || IOS // Exclude desktop platforms (Windows, MacCatalyst)
+using NUnit.Framework;
+using UITest.Appium;
+using UITest.Core;
+
+namespace Microsoft.Maui.TestCases.Tests.Issues;
+
+public class Issue32277 : _IssuesUITest
+{
+	public Issue32277(TestDevice device) : base(device)
+	{
+	}
+
+	public override string Issue => "When a FlyoutPage is pushed Modally it doesn't inset the AppBarLayout";
+
+	[Test]
+	[Category(UITestCategories.FlyoutPage)]
+	public void FlyoutPageModalAppBarLayoutGetsInsets()
+	{
+		// Tap the button to push the FlyoutPage modally
+		App.WaitForElement("PushModalFlyoutButton");
+		App.Tap("PushModalFlyoutButton");
+
+		// Wait for the modal FlyoutPage to appear
+		App.WaitForElement("DetailLabel");
+
+		// Verify the detail page is visible and properly positioned
+		// If the AppBarLayout insets are not applied correctly, the navigation bar
+		// would render behind system UI elements
+		VerifyScreenshot();
+	}
+}
+#endif