[Testing] Rework Catalyst Test Runner to use startup arguments instead of UI navigation (dotnet#31673)

### Description of Change

#### This PR reopens the work from the closed
[dotnet#30651](dotnet#30651)

This pull request introduces functionality to streamline test execution
by allowing tests to be launched directly via startup arguments or
programmatically. Key changes include adding support for passing test
names as environment variables, introducing a `PageFactory` mechanism
for dynamic page creation, and enhancing test lifecycle management for
specific platforms like Mac Catalyst.

Note: This PR is an extension of the
PR(dotnet#30286) with a proper
implementation.

#### Test Execution Enhancements:

- **Startup Argument Support**: Added logic to retrieve test names from
environment variables and dynamically load the corresponding test page
in `CreateDefaultMainPage()` (`MauiProgram.cs`).

- **Dynamic Page Creation**: Introduced a `PageFactory` property in the
`IssueModel` class to enable dynamic test page instantiation
(`TestCases.cs`).

- **Direct Test Page Retrieval**: Implemented `TryToGetTestPage()` in
`TestCaseScreen` to retrieve test pages by description using
`PageFactory` (`TestCases.cs`).

#### Platform-Specific Test Lifecycle Improvements:

- **Mac Catalyst Test Configuration**: Enhanced `_IssuesUITest` to pass
test names as startup arguments and manage app launch/close lifecycle
specifically for Mac Catalyst (`_IssuesUITest.cs`).
[[1]](https://github.com/dotnet/maui/pull/30651/files#diff-6e8c0ea1f2979b5484d14facb1aa5b2ccef3ee748f1606eaf46220ac0936e3edR22-R46)
[[2]](https://github.com/dotnet/maui/pull/30651/files#diff-6e8c0ea1f2979b5484d14facb1aa5b2ccef3ee748f1606eaf46220ac0936e3edR58-R61)

- ** Appium Options for Mac Catalyst**: Updated `AppiumCatalystApp` to
include environment variables in Appium options for test execution
(`AppiumCatalystApp.cs`).

#### Helper Methods for Test Execution:

- **Parameterized App Launch**: Added a method to launch apps with
additional parameters, supporting test-specific configurations
(`HelperExtensions.cs`).

- **Mac-Specific App Closure**: Modified `FixtureOneTimeTearDown()` to
handle app closure for Mac Catalyst during test teardown
(`UITestBase.cs`).

 ### Output


https://github.com/user-attachments/assets/82fc12ad-b0d3-4bad-901f-0ab6b2bddda1



### Issues Fixed

Fixes dotnet#30285

Author: NafeelaNazhir

src/Controls/tests/TestCases.HostApp/CoreViews/CorePageView.cs

@@ -193,6 +193,25 @@ public Task<bool> NavigateToGalleryPage(string pageTitle)
 			return Task.FromResult(false);
 		}
 
+		/// <summary>
+		/// Attempts to retrieve a gallery page by title.
+		/// </summary>
+		/// <param name="pageTitle">The title of the gallery page to find.</param>
+		/// <returns>The Page instance if found; otherwise, null.</returns>
+		/// <remarks>
+		/// This method searches for a matching gallery page by title (case-insensitive).
+		/// If a match is found, it invokes the associated Realize factory to create the page.
+		/// </remarks>
+		public Page TryToGetGalleryPage(string pageTitle)
+		{
+			if (_titleToPage.TryGetValue(pageTitle.ToLowerInvariant(), out GalleryPageFactory pageFactory))
+			{
+				return pageFactory.Realize();
+			}
+
+			return null;
+		}
+
 		public async Task<bool> NavigateToTest(string pageTitle)
 		{
 			var testCaseScreen = new TestCases.TestCaseScreen();

src/Controls/tests/TestCases.HostApp/Issues/Bugzilla/Bugzilla53179.cs

@@ -22,7 +22,7 @@ class TestPage : ContentPage
 
 				public TestPage(int index)
 				{
-					nextBtn = new Button { AutomationId = "Next Page", Text = "Next Page" };
+					nextBtn = new Button { AutomationId = $"Next Page {index}", Text = $"Next Page {index}" };
 					rmBtn = new Button { AutomationId = "Remove previous pages", Text = "Remove previous pages" };
 					popBtn = new Button { AutomationId = "Back", Text = "Back" };
 

src/Controls/tests/TestCases.HostApp/Issues/Bugzilla/Bugzilla53834.cs

@@ -44,6 +44,7 @@ protected override void Init()
 			lstView = new ListView()
 			{
 				IsGroupingEnabled = true,
+				VerticalScrollBarVisibility = ScrollBarVisibility.Never,
 				HasUnevenRows = true,
 				ItemTemplate = new DataTemplate(typeof(MyViewCell)),
 				GroupHeaderTemplate = new DataTemplate(typeof(MyHeaderViewCell)),

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

@@ -13,6 +13,9 @@ async void Issue18161_Loaded(object sender, EventArgs e)
 		{
 			// https://github.com/dotnet/maui/issues/13496
 			await Task.Yield();
+#if MACCATALYST
+			await Task.Delay(500); // Add delay for MacCatalyst when page is loaded directly as window root
+#endif
 			this.IsPresented = true;
 		}
 

src/Controls/tests/TestCases.HostApp/Issues/Issue18161.xaml.cs

@@ -2,6 +2,7 @@
 <ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
              xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
              x:Class="Maui.Controls.Sample.Issues.Issue19657"
+             xmlns:local="clr-namespace:Maui.Controls.Sample"
              xmlns:ns="clr-namespace:Maui.Controls.Sample.Issues">
     <ScrollView>
         <Grid x:Name="contentGrid">
@@ -20,7 +21,7 @@
 
             <Label HorizontalOptions="Center" x:Name="WaitHere" Text="Check if the Carousel items all show up" AutomationId="WaitHere" Background="Red"/>
 
-            <CarouselView x:Name="carousel"
+            <local:CarouselView2 x:Name="carousel"
                          ItemTemplate="{StaticResource SampleItemTemplate}"
                          Loop="False"
                          HeightRequest="220"

src/Controls/tests/TestCases.HostApp/Issues/Issue19657.xaml

@@ -33,7 +33,7 @@ public Issue7144()
 			return image;
 		});
 
-		CarouselView carouselView = new CarouselView
+		CarouselView2 carouselView = new CarouselView2
 		{
 			ItemsSource = Items,
 			Loop = false,

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

@@ -57,7 +57,7 @@ async void FillResults(GroupedData results, int items, bool clear)
 		if (!clear)
 			return;
 
-		await Task.Delay(1000);
+		await Task.Delay(1500);
 
 		results.Clear();
 	}

src/Controls/tests/TestCases.HostApp/Issues/XFIssue/Issue1939.cs

@@ -68,6 +68,31 @@ public static Page CreateDefaultMainPage()
 		{
 			Page mainPage = null;
 			OverrideMainPage(ref mainPage);
+#if MACCATALYST
+			// Check for startup test argument from environment variables (passed by test runner)
+			var testName = System.Environment.GetEnvironmentVariable("test");
+
+			if (!string.IsNullOrEmpty(testName))
+			{
+				// Try to get the test page directly from issues/test cases
+				var testCaseScreen = new TestCases.TestCaseScreen();
+				var testPage = testCaseScreen.TryToGetTestPage(testName);
+				if (testPage is not null)
+				{
+					// Return the actual test page
+					return testPage;
+				}
+
+				// If not found in test cases, try to get gallery page
+				var corePageView = new CorePageView(null);
+				var galleryPage = corePageView.TryToGetGalleryPage(testName);
+				if (galleryPage is not null)
+				{
+					// Return the gallery page
+					return galleryPage;
+				}
+			}
+#endif
 			return mainPage ?? new CoreNavigationPage();
 		}
 	}

src/Controls/tests/TestCases.HostApp/MauiProgram.cs

@@ -1,5 +1,6 @@
 using System.Diagnostics.CodeAnalysis;
 using System.Reflection;
+using System.Linq;
 
 namespace Maui.Controls.Sample
 {
@@ -123,6 +124,7 @@ class IssueModel
 				public string Description { get; set; }
 				public bool IsInternetRequired { get; set; }
 				public Action Action { get; set; }
+				public Func<Page> PageFactory { get; set; }
 
 				public bool Matches(string filter)
 				{
@@ -195,7 +197,9 @@ public TestCaseScreen()
 						 Name = attribute.DisplayName,
 						 Description = attribute.Description,
 						 IsInternetRequired = attribute.IsInternetRequired,
-						 Action = ActivatePageAndNavigate(attribute, type)
+						 Action = ActivatePageAndNavigate(attribute, type),
+						 // PageFactory is used to retrieve the instance of the page.
+						 PageFactory = () => ActivatePage(type)
 					 }).ToList();
 #endif
 
@@ -238,6 +242,23 @@ public bool TryToNavigateTo(string name)
 				return true;
 			}
 
+
+			/// <summary>
+			/// Attempts to retrieve a test page by name or description.
+			/// </summary>
+			/// <param name="name">The name or description of the test page to find.</param>
+			/// <returns>The Page instance if found; otherwise, null.</returns>
+			/// <remarks>
+			/// This method first searches for a matching issue by name (case-insensitive),
+			/// then by description if no match is found by name. If a match is found,
+			/// it invokes the associated PageFactory to create the page.
+			/// </remarks>
+			public Page TryToGetTestPage(string name)
+			{
+				var issue = _issues.SingleOrDefault(x => string.Equals(x.Description, name, StringComparison.OrdinalIgnoreCase));
+				return issue?.PageFactory?.Invoke();
+			}
+
 			public void FilterIssues(string filter = null)
 			{
 				filter = filter?.Trim();