feat(java): ✨ added longPress and doubleTap support for mobile (#954)

Author: WasiqB

.github/workflows/test-core.yml

@@ -135,8 +135,8 @@ jobs:
       run-ios: false
       run-android: true
       emulator-name: Pixel_8_Pro
-      emulator-profile: pixel_7_pro
-      emulator-version: 34
+      emulator-profile: pixel_6_pro
+      emulator-version: 31
       # emulator-channel: canary
       emulator-arch: x86_64
       emulator-target: google_apis

core-java/pom.xml

@@ -34,7 +34,7 @@
         <okhttp.version>4.12.0</okhttp.version>
         <lombok.version>1.18.36</lombok.version>
         <google-gson.version>2.11.0</google-gson.version>
-        <google.guava.version>33.3.1-jre</google.guava.version>
+        <google.guava.version>33.4.0-jre</google.guava.version>
         <google-truth.version>1.4.4</google-truth.version>
         <apache-commons-text.version>1.13.0</apache-commons-text.version>
         <commons-io.version>2.18.0</commons-io.version>

core-java/src/main/java/io/github/boykaframework/actions/elements/FingerActions.java

@@ -29,6 +29,8 @@
 import static java.util.Optional.ofNullable;
 import static org.apache.logging.log4j.LogManager.getLogger;
 
+import java.util.List;
+
 import io.github.boykaframework.actions.interfaces.elements.IFingerActions;
 import io.github.boykaframework.actions.interfaces.listeners.elements.IFingerActionsListener;
 import io.github.boykaframework.builders.Locator;
@@ -82,6 +84,20 @@ public static IFingerActions withFinger () {
         }
     }
 
+    @Override
+    public void doubleTap () {
+        LOGGER.traceEntry ();
+        LOGGER.info ("Double Tapping on the element...");
+        ofNullable (this.listener).ifPresent (l -> l.onDoubleTap (this.locator));
+        final var sequences = getElementAttribute (element -> FingerGestureBuilder.init ()
+            .sourceElement (this.locator)
+            .pause (ofMillis (this.delaySetting.getBeforeTap ()))
+            .build ()
+            .tapOn (), this.locator, null);
+        performMobileGestures (List.of (sequences, sequences));
+        LOGGER.traceExit ();
+    }
+
     @Override
     public void dragTo (final Locator destination) {
         LOGGER.traceEntry ();
@@ -96,6 +112,24 @@ public void dragTo (final Locator destination) {
         LOGGER.traceExit ();
     }
 
+    @Override
+    public void longPress (final long millis) {
+        LOGGER.traceEntry ();
+        LOGGER.info ("Long pressing on [{}] for [{}] ms.", this.locator.getName (), millis);
+        ofNullable (this.listener).ifPresent (l -> l.onLongPress (this.locator, millis));
+        final var dragSequence = getDriverAttribute (driver -> FingerGestureBuilder.init ()
+            .sourceElement (this.locator)
+            .build ()
+            .tapAndHold (millis), null);
+        performMobileGestures (singletonList (dragSequence));
+        LOGGER.traceExit ();
+    }
+
+    @Override
+    public void longPress () {
+        longPress (500);
+    }
+
     @Override
     public void swipe (final SwipeDirection direction) {
         LOGGER.traceEntry ();

core-java/src/main/java/io/github/boykaframework/actions/elements/FingerGestureBuilder.java

@@ -31,7 +31,6 @@
 import static io.github.boykaframework.utils.Validator.validateDelay;
 import static java.time.Duration.ZERO;
 import static java.time.Duration.ofMillis;
-import static java.time.Duration.ofSeconds;
 import static java.util.Objects.isNull;
 import static org.openqa.selenium.interactions.PointerInput.Kind.TOUCH;
 import static org.openqa.selenium.interactions.PointerInput.Origin.viewport;
@@ -89,9 +88,9 @@ Sequence swipe () {
         return singleFingerGesture (startPosition, endPosition);
     }
 
-    Sequence tapAndHold () {
+    Sequence tapAndHold (final long millis) {
         final var start = getElementCenter (this.sourceElement);
-        this.pause = ofSeconds (1);
+        this.pause = ofMillis (millis);
         return singleFingerGesture (start, null);
     }
 

core-java/src/main/java/io/github/boykaframework/actions/interfaces/elements/IFingerActions.java

@@ -26,13 +26,30 @@
  * @since 15-Feb-2023
  */
 public interface IFingerActions extends IElementActions {
+    /**
+     * Double tap on an element.
+     */
+    void doubleTap ();
+
     /**
      * Drag one element to another element.
      *
      * @param destination Target element
      */
     void dragTo (final Locator destination);
 
+    /**
+     * Long press on element for a particular duration.
+     *
+     * @param millis Duration of long press.
+     */
+    void longPress (long millis);
+
+    /**
+     * Long press on an element for 500 ms.
+     */
+    void longPress ();
+
     /**
      * Swipe on the Mobile screen starting from center of the screen to the direction mentioned
      *

core-java/src/main/java/io/github/boykaframework/actions/interfaces/listeners/elements/IFingerActionsListener.java

@@ -27,6 +27,15 @@
  * @since 09-Apr-2023
  */
 public interface IFingerActionsListener extends BoykaListener {
+    /**
+     * Handles double tap method.
+     *
+     * @param locator Locator of the element.
+     */
+    default void onDoubleTap (final Locator locator) {
+        // not implemented
+    }
+
     /**
      * Handle drag to method.
      *
@@ -37,6 +46,16 @@ default void onDragTo (final Locator source, final Locator destination) {
         // not implemented.
     }
 
+    /**
+     * Handles long press method with specified duration
+     *
+     * @param locator Locator of the element.
+     * @param millis Duration of long press.
+     */
+    default void onLongPress (final Locator locator, long millis) {
+        // not implemented
+    }
+
     /**
      * Handle swipe method.
      *

core-java/src/main/java/io/github/boykaframework/config/ui/mobile/device/DeviceSetting.java

@@ -42,6 +42,7 @@ public class DeviceSetting {
     private Map<String, Object>                  capabilities;
     private boolean                              clearFiles             = true;
     private boolean                              clearLogs              = true;
+    private int                                  commandTimeout         = 60;
     private boolean                              fullReset;
     private boolean                              ignoreUnimportantViews = true;
     private String                               name;

core-java/src/main/java/io/github/boykaframework/manager/AndroidManager.java

@@ -99,7 +99,8 @@ private void setLocalUiAutomatorOptions (final UiAutomator2Options options) {
         options.setClearSystemFiles (this.settings.isClearFiles ());
         options.setClearDeviceLogsOnStart (this.settings.isClearLogs ());
         options.setNoReset (this.settings.isNoReset ());
-        options.setAutoGrantPermissions (settings.isAutoGrantPermissions ());
+        options.setNewCommandTimeout (ofSeconds (this.settings.getCommandTimeout ()));
+        options.setAutoGrantPermissions (this.settings.isAutoGrantPermissions ());
         options.setFullReset (this.settings.isFullReset ());
         options.setUiautomator2ServerLaunchTimeout (ofSeconds (this.settings.getServerLaunchTimeout ()));
         options.setUiautomator2ServerInstallTimeout (ofSeconds (this.settings.getServerInstallTimeout ()));

core-java/src/main/java/io/github/boykaframework/manager/IOSManager.java

@@ -136,11 +136,12 @@ private void setupLocalSimulatorOptions (final XCUITestOptions options) {
         options.setClearSystemFiles (this.settings.isClearFiles ());
         options.setNoReset (this.settings.isNoReset ());
         options.setFullReset (this.settings.isFullReset ());
+        options.setNewCommandTimeout (ofSeconds (this.settings.getCommandTimeout ()));
         options.setWebviewConnectTimeout (ofSeconds (this.settings.getWebViewConnectTimeout ()));
         options.setWebviewConnectRetries (this.settings.getWebViewConnectRetries ());
         options.setMaxTypingFrequency (this.settings.getTypingSpeed ());
         setWdaOptions (this.settings.getWda (), options);
-        setPermissions (options, settings);
+        setPermissions (options, this.settings);
     }
 
     private void setupVirtualDeviceSetting (final DeviceType deviceType, final VirtualDeviceSetting virtualDevice,

core-java/src/test/resources/boyka-config.json

@@ -232,7 +232,7 @@
         },
         "device": {
           "os": "ANDROID",
-          "version": "14",
+          "version": "12",
           "name": "Pixel_8_Pro",
           "type": "VIRTUAL",
           "server_install_timeout": 60,