[Testing] Added methods to set the device orientation from UITests

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

@@ -0,0 +1,48 @@
+using UITest.Core;
+
+namespace UITest.Appium
+{
+	public class AppiumOrientationActions : ICommandExecutionGroup
+	{
+		const string SetOrientationPortraitCommand = "setOrientationPortrait";
+		const string SetOrientationLandscapeCommand = "setOrientationLandscape";
+
+		protected readonly AppiumApp _app;
+
+		readonly List<string> _commands = new()
+		{
+			SetOrientationPortraitCommand,
+			SetOrientationLandscapeCommand,
+		};
+
+		public AppiumOrientationActions(AppiumApp app)
+		{
+			_app = app;
+		}
+
+		public bool IsCommandSupported(string commandName)
+		{
+			return _commands.Contains(commandName, StringComparer.OrdinalIgnoreCase);
+		}
+
+		public CommandResponse Execute(string commandName, IDictionary<string, object> parameters)
+		{
+			return commandName switch
+			{
+				SetOrientationPortraitCommand => SetOrientationPortrait(parameters),
+				SetOrientationLandscapeCommand => SetOrientationLandscape(parameters),
+				_ => CommandResponse.FailedEmptyResponse,
+			};
+		}
+
+		CommandResponse SetOrientationPortrait(IDictionary<string, object> parameters)
+		{
+			return new CommandResponse(_app.Driver.Orientation = OpenQA.Selenium.ScreenOrientation.Portrait, CommandResponseResult.Success);
+		}
+
+		CommandResponse SetOrientationLandscape(IDictionary<string, object> parameters)
+		{
+			return new CommandResponse(_app.Driver.Orientation = OpenQA.Selenium.ScreenOrientation.Landscape, CommandResponseResult.Success);
+		}
+	}
+}

src/TestUtils/src/UITest.Appium/AppiumApp.cs

@@ -21,6 +21,7 @@ public AppiumApp(AppiumDriver driver, IConfig config)
 			_commandExecutor.AddCommandGroup(new AppiumTextActions());
 			_commandExecutor.AddCommandGroup(new AppiumGeneralActions());
 			_commandExecutor.AddCommandGroup(new AppiumVirtualKeyboardActions(this));
+			_commandExecutor.AddCommandGroup(new AppiumOrientationActions(this));
 		}
 
 		public abstract ApplicationState AppState { get; }

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

@@ -174,6 +174,24 @@ public static bool WaitForTextToBePresentInElement(this IApp app, string automat
 			}
 		}
 
+		/// <summary>
+		/// Changes the device orientation to landscape mode.
+		/// </summary>
+		/// <param name="app">Represents the main gateway to interact with an app.</param>
+		public static void SetOrientationLandscape(this IApp app)
+		{
+			app.CommandExecutor.Execute("setOrientationLandscape", ImmutableDictionary<string, object>.Empty);
+		}
+
+		/// <summary>
+		/// Changes the device orientation to portrait mode.
+		/// </summary>
+		/// <param name="app">Represents the main gateway to interact with an app.</param>
+		public static void SetOrientationPortrait(this IApp app)
+		{
+			app.CommandExecutor.Execute("setOrientationPortrait", ImmutableDictionary<string, object>.Empty);
+		}
+
 		static IUIElement Wait(Func<IUIElement> query,
 			Func<IUIElement, bool> satisfactory,
 			string? timeoutMessage = null,