feat: added the ability to activate the app with timeout (#570)

Author: agentran

src/Appium.Net/Appium/AppiumDriver.cs

@@ -241,6 +241,12 @@ public void RemoveApp(string appId) =>
 
         public void ActivateApp(string appId) =>
             Execute(AppiumDriverCommand.ActivateApp, AppiumCommandExecutionHelper.PrepareArgument("appId", appId));
+        
+        public void ActivateApp(string appId, TimeSpan timeout) =>
+            Execute(AppiumDriverCommand.ActivateApp,
+                    AppiumCommandExecutionHelper.PrepareArguments(new string[] {"appId", "options"},
+                        new object[]
+                            {appId, new Dictionary<string, object>() {{"timeout", (long) timeout.TotalMilliseconds}}}));
 
         public bool TerminateApp(string appId) =>
             Convert.ToBoolean(Execute(AppiumDriverCommand.TerminateApp,

test/integration/Android/Device/AppTests.cs

@@ -43,6 +43,16 @@ public void CanActivateAppTest()
             //Verify the expected app was activated
             Assert.DoesNotThrow(() => _driver.FindElementById(IntentAppElement));
         }
+        
+        [Test]
+        public void CanActivateAppWithTimeoutTest()
+        {
+            //Activate an app to foreground
+            Assert.DoesNotThrow(() => _driver.ActivateApp(IntentAppPackageName, TimeSpan.FromSeconds(20)));
+
+            //Verify the expected app was activated
+            Assert.DoesNotThrow(() => _driver.FindElementById(IntentAppElement));
+        }
 
         [Test]
         public void CanActivateAppFromBackgroundTest()

test/integration/IOS/Device/AppTests.cs

@@ -45,7 +45,17 @@ public void CanActivateAppTest()
             //Verify the expected app was activated
             Assert.DoesNotThrow(() => _driver.FindElementByAccessibilityId(IosTestAppElement));
         }
+        
+        [Test]
+        public void CanActivateAppWithTimeoutTest()
+        {
+            //Activate an app to foreground
+            Assert.DoesNotThrow(() => _driver.ActivateApp(IosTestAppBundleId, TimeSpan.FromSeconds(20)));
 
+            //Verify the expected app was activated
+            Assert.DoesNotThrow(() => _driver.FindElementById(IosTestAppBundleId));
+        }
+        
         [Test]
         public void CanActivateViaScriptAppTest()
         {