Execute script and Android startActivity action +semver: feature (#52)

* Update to Appium 9.5.0 and Selenium 4.33.0 +semver:feature

* Execute script and Android startActivity action +semver: feature
Update Selenium reference to v.4.34.0
Update license year

Author: mialeska

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2024 Aquality Automation
+   Copyright 2025 Aquality Automation
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

azure-pipelines.yml

@@ -9,37 +9,39 @@ jobs:
   displayName: Analyse code with SonarQube
 
   steps:
-    - task: SonarCloudPrepare@1
+    - task: SonarCloudPrepare@3
       displayName: 'Prepare SonarCloud analysis'
       inputs:
         SonarCloud: 'SonarCloud'
         organization: 'aqualityautomation'
         scannerMode: 'CLI'
         configMode: 'file'
-        extraProperties: |
-            sonar.coverage.exclusions=**/**
+        extraProperties: 'sonar.coverage.exclusions=**/**'
 
-    - task: Maven@3
+    - task: Maven@4
       displayName: 'Compile project'
       inputs:
         mavenPomFile: 'pom.xml'
-        goals: 'clean compile'
+        goals: 'clean'
         publishJUnitResults: true
         testResultsFiles: '**/surefire-reports/TEST-*.xml'
         javaHomeOption: 'JDKVersion'
-        jdkVersionOption: '11'
+        jdkVersionOption: '1.11'
         mavenVersionOption: 'Default'
         mavenAuthenticateFeed: false
         effectivePomSkip: false
         sonarQubeRunAnalysis: false
-      continueOnError: true
 
-    - task: SonarCloudAnalyze@1
+    - task: SonarCloudAnalyze@3
+      inputs:
+        jdkversion: 'JAVA_HOME_21_X64'
       displayName: 'Run SonarCloud code analysis'
       continueOnError: true
 
-    - task: SonarCloudPublish@1
+    - task: SonarCloudPublish@3
       displayName: 'Publish SonarCloud quality gate results'
+      inputs:
+        pollingTimeoutSec: '300'
 
 - job: tests
   displayName: Run tests

pom.xml

@@ -184,7 +184,7 @@
         <dependency>
             <groupId>com.github.aquality-automation</groupId>
             <artifactId>aquality-selenium-core</artifactId>
-            <version>4.6.0</version>
+            <version>4.7.0</version>
         </dependency>
 
         <dependency>
@@ -203,7 +203,7 @@
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-lang3</artifactId>
-            <version>3.17.0</version>
+            <version>3.18.0</version>
             <scope>test</scope>
         </dependency>
 

src/main/java/aquality/appium/mobile/actions/AndroidActions.java

@@ -0,0 +1,22 @@
+package aquality.appium.mobile.actions;
+
+import aquality.appium.mobile.application.AqualityServices;
+import io.appium.java_client.android.AndroidDriver;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public class AndroidActions implements IAndroidActions {
+    @Override
+    public void startActivity(String appPackage, String appActivity, boolean stopApp) {
+        AqualityServices.getLocalizedLogger().info("loc.application.android.activity.start", appPackage, appActivity);
+        Map<String, Object> args = new HashMap<>();
+        args.put("intent", String.format("%s/%s", appPackage, appActivity));
+        args.put("package", appPackage);
+        args.put("stop", stopApp);
+        AqualityServices.getApplication().executeScript("mobile: startActivity", args);
+        AqualityServices.getConditionalWait().waitFor(
+                driver -> appActivity.equals(((AndroidDriver)driver).currentActivity()),
+                String.format("Activity %s was not started", appActivity));
+    }
+}

src/main/java/aquality/appium/mobile/actions/IActionsModule.java

@@ -13,4 +13,11 @@ public interface IActionsModule extends IConfigurationsModule {
     default Class<? extends ITouchActions> getTouchActionsImplementation() {
         return TouchActions.class;
     }
+
+    /**
+     * @return class which implements {@link IAndroidActions}
+     */
+    default Class<? extends IAndroidActions> getAndroidActionsImplementation() {
+        return AndroidActions.class;
+    }
 }

src/main/java/aquality/appium/mobile/actions/IAndroidActions.java

@@ -0,0 +1,36 @@
+package aquality.appium.mobile.actions;
+
+import io.appium.java_client.android.Activity;
+
+/**
+ * Extensions for Android applications.
+ */
+public interface IAndroidActions {
+
+    /**
+     * Starts application activity.
+     * @param activity Activity to start.
+     * @param stopApp True if you need to stop currently running application, false otherwise.
+     */
+    default void startActivity(Activity activity, boolean stopApp) {
+        startActivity(activity.getAppPackage(), activity.getAppActivity(), stopApp);
+    }
+
+    /**
+     * Starts application activity.
+     * Currently running application will be stopped.
+     * @param appPackage Package of the target application.
+     * @param appActivity Target activity.
+     */
+    default void startActivity(String appPackage, String appActivity) {
+        startActivity(appPackage, appActivity, true);
+    }
+
+    /**
+     * Starts application activity.
+     * @param appPackage Package of the target application.
+     * @param appActivity Target activity.
+     * @param stopApp True if you need to stop currently running application, false otherwise.
+     */
+    void startActivity(String appPackage, String appActivity, boolean stopApp);
+}

src/main/java/aquality/appium/mobile/application/Application.java

@@ -105,14 +105,27 @@ protected void doWithRetry(Runnable function) {
                 .doWithRetry(function, Collections.singletonList(WebDriverException.class));
     }
 
+    @Override
+    public <T> T executeScript(String script, Map<String, Object> params) {
+        return doWithRetry(() -> {
+            String argsString = params == null || params.isEmpty() ? "" : ", " + params;
+            localizedLogger.info("loc.application.execute.script", script + argsString);
+            T result = CommandExecutionHelper.executeScript(getDriver().assertExtensionExists(script), script, params);
+            if (result != null) {
+                localizedLogger.info("loc.application.script.result", result);
+            }
+            return result;
+        });
+    }
+
     @Override
     public String getId() {
         final String iosExtName = "mobile: activeAppInfo";
         return doWithRetry(() -> {
             if (PlatformName.ANDROID == getPlatformName()) {
                 return ((AndroidDriver) getDriver()).getCurrentPackage();
             }
-            Map<String, Object> result = CommandExecutionHelper.executeScript(getDriver().assertExtensionExists(iosExtName), iosExtName);
+            Map<String, Object> result = executeScript(iosExtName, null);
             return String.valueOf(Objects.requireNonNull(result).get("bundleId"));
         });
     }

src/main/java/aquality/appium/mobile/application/AqualityServices.java

@@ -1,5 +1,6 @@
 package aquality.appium.mobile.application;
 
+import aquality.appium.mobile.actions.IAndroidActions;
 import aquality.appium.mobile.actions.ITouchActions;
 import aquality.appium.mobile.configuration.IApplicationProfile;
 import aquality.appium.mobile.configuration.IConfiguration;
@@ -200,4 +201,13 @@ public static IConfiguration getConfiguration() {
     public static ITouchActions getTouchActions() {
         return get(ITouchActions.class);
     }
+
+    /**
+     * Gets the utility used to perform Android-specific actions.
+     *
+     * @return instance of Android actions.
+     */
+    public static IAndroidActions getAndroidActions() {
+        return get(IAndroidActions.class);
+    }
 }

src/main/java/aquality/appium/mobile/application/IMobileApplication.java

@@ -8,6 +8,8 @@
 import org.openqa.selenium.remote.service.DriverService;
 
 import java.time.Duration;
+import java.util.Collections;
+import java.util.Map;
 
 public interface IMobileApplication extends IApplication {
     /**
@@ -63,6 +65,23 @@ default InteractsWithApps appManagement() {
      */
     ApplicationState getState(String appId);
 
+    /**
+     * Execute application script
+     * @param script script
+     * @param params parameters
+     * @return result of the script execution.
+     */
+    <T> T executeScript(String script, Map<String, Object> params);
+
+    /**
+     * Execute application script
+     * @param script script
+     * @return result of the script execution.
+     */
+    default <T> T executeScript(String script) {
+        return executeScript(script, Collections.emptyMap());
+    }
+
     /**
      * Installs an application.
      *

src/main/java/aquality/appium/mobile/application/MobileModule.java

@@ -1,6 +1,7 @@
 package aquality.appium.mobile.application;
 
 import aquality.appium.mobile.actions.IActionsModule;
+import aquality.appium.mobile.actions.IAndroidActions;
 import aquality.appium.mobile.actions.ITouchActions;
 import aquality.appium.mobile.configuration.IApplicationProfile;
 import aquality.appium.mobile.configuration.IConfiguration;
@@ -31,5 +32,6 @@ protected void configure() {
         bind(IScreenFactory.class).to(getScreenFactoryImplementation());
         bind(ITouchActionsConfiguration.class).to(getTouchActionsConfigurationImplementation());
         bind(ITouchActions.class).to(getTouchActionsImplementation());
+        bind(IAndroidActions.class).to(getAndroidActionsImplementation());
     }
 }