[UI Testing] Implement PressEnter method (#22112)

* Implement PressEnter method on appium

* IsKeyboardShown not implemented on Windows

* Updated test

Author: jsuarezruiz

src/Controls/tests/UITests/Tests/Issues/Issue16386.cs

@@ -1,5 +1,4 @@
 using NUnit.Framework;
-using OpenQA.Selenium;
 using UITest.Appium;
 using UITest.Core;
 
@@ -20,13 +19,12 @@ public void HittingEnterKeySendsDone()
 			this.IgnoreIfPlatforms(new[]
 			{
 				TestDevice.Mac,
-				TestDevice.iOS,
-				TestDevice.Windows,
+				TestDevice.Windows
 			});
 
 			App.WaitForElement("HardwareEnterKeyEntry");
 			App.Tap("HardwareEnterKeyEntry");
-			App.SendKeys(66);
+			App.PressEnter();
 			App.WaitForElement("Success");
 		}
 	}

src/TestUtils/src/UITest.Appium/Actions/AppiumAndroidVirtualKeyboardActions.cs

@@ -19,6 +19,19 @@ protected override CommandResponse DismissKeyboard(IDictionary<string, object> p
 			return CommandResponse.SuccessEmptyResponse;
 		}
 
+		protected override CommandResponse PressEnter(IDictionary<string, object> parameters)
+		{
+			if (_app.Driver is AndroidDriver android)
+			{
+				// 66 - KEYCODE_ENTER
+				// More information: https://developer.android.com/reference/android/view/KeyEvent.html
+				android.PressKeyCode(66);
+				return CommandResponse.SuccessEmptyResponse;
+			}
+
+			return CommandResponse.FailedEmptyResponse;
+		}
+
 		protected override CommandResponse PressVolumeDown(IDictionary<string, object> parameters)
 		{
 			if (_app.Driver is AndroidDriver android)

src/TestUtils/src/UITest.Appium/Actions/AppiumIOSVirtualKeyboardActions.cs

@@ -27,6 +27,23 @@ protected override CommandResponse DismissKeyboard(IDictionary<string, object> p
 			return CommandResponse.SuccessEmptyResponse;
 		}
 
+		protected override CommandResponse PressEnter(IDictionary<string, object> parameters)
+		{
+			try
+			{
+				if (_app.Driver.IsKeyboardShown())
+				{
+					_app.Driver.SwitchTo().ActiveElement().SendKeys(Keys.Return);
+				}
+			}
+			catch (InvalidElementStateException)
+			{
+				return CommandResponse.FailedEmptyResponse;
+			}
+
+			return CommandResponse.SuccessEmptyResponse;
+		}
+
 		protected override CommandResponse PressVolumeDown(IDictionary<string, object> parameters)
 		{
 			try

src/TestUtils/src/UITest.Appium/Actions/AppiumVirtualKeyboardActions.cs

@@ -6,6 +6,7 @@ public class AppiumVirtualKeyboardActions : ICommandExecutionGroup
 	{
 		const string IsKeyboardShownCommand = "isKeyboardShown";
 		const string HideKeyboardCommand = "dismissKeyboard";
+		const string PressEnterCommand = "pressEnter";
 		const string PressVolumeDownCommand = "pressVolumeDown";
 		const string PressVolumeUpCommand = "pressVolumeUp";
 
@@ -14,6 +15,7 @@ public class AppiumVirtualKeyboardActions : ICommandExecutionGroup
 		{
 			IsKeyboardShownCommand,
 			HideKeyboardCommand,
+			PressEnterCommand,
 			PressVolumeDownCommand,
 			PressVolumeUpCommand,
 		};
@@ -34,6 +36,7 @@ public CommandResponse Execute(string commandName, IDictionary<string, object> p
 			{
 				IsKeyboardShownCommand => IsKeyboardShown(parameters),
 				HideKeyboardCommand => DismissKeyboard(parameters),
+				PressEnterCommand => PressEnter(parameters),
 				PressVolumeDownCommand => PressVolumeDown(parameters),
 				PressVolumeUpCommand => PressVolumeUp(parameters),
 				_ => CommandResponse.FailedEmptyResponse,
@@ -50,6 +53,11 @@ protected virtual CommandResponse DismissKeyboard(IDictionary<string, object> pa
 			return CommandResponse.SuccessEmptyResponse;
 		}
 
+		protected virtual CommandResponse PressEnter(IDictionary<string, object> parameters)
+		{
+			return CommandResponse.SuccessEmptyResponse;
+		}
+
 		protected virtual CommandResponse PressVolumeDown(IDictionary<string, object> parameters)
 		{
 			return CommandResponse.SuccessEmptyResponse;

src/TestUtils/src/UITest.Appium/AppiumWindowsApp.cs

@@ -10,6 +10,7 @@ public class AppiumWindowsApp : AppiumApp, IWindowsApp
 		public AppiumWindowsApp(Uri remoteAddress, IConfig config)
 			: base(new WindowsDriver(remoteAddress, GetOptions(config)), config)
 		{
+
 		}
 
 		public override ApplicationState AppState

src/TestUtils/src/UITest.Appium/HelperExtensions.cs

@@ -358,6 +358,15 @@ public static void PressVolumeDown(this IApp app)
 			app.CommandExecutor.Execute("pressVolumeDown", ImmutableDictionary<string, object>.Empty);
 		}
 
+		/// <summary>
+		/// Presses the enter key in the app.
+		/// </summary>
+		/// <param name="app">Represents the main gateway to interact with an app.</param>
+		public static void PressEnter(this IApp app)
+		{
+			app.CommandExecutor.Execute("pressEnter", ImmutableDictionary<string, object>.Empty);
+		}
+
 		/// <summary>
 		/// Performs a left to right swipe gesture on the screen. 
 		/// </summary>