🕸️ Appium with Selenium Grid 4

In this tutorials, you will learn how to run Appium tests on Selenium Grid 4 (traditional Hub and Node) using Boyka framework.

Start Appium Servers

First step is to start 2 instances of Appium server, one for Android and one for iOS.

To start Appium server for Android, run the following command:

appium server --config core-java/src/test/resources/grid/appium-android.yml

Note that we are using Appium config file located at core-java/src/test/resources/grid/appium-android.yml in the Boyka framework repository.

Now, we will start another instance of Appium server for iOS on another terminals by running the following command:

appium server --config core-java/src/test/resources/grid/appium-ios.yml

Here also we are using another Appium config file located at core-java/src/test/resources/grid/appium-ios.yml in the Boyka framework repository.

Start Selenium Grid 4

Now start Selenium Grid Hub by running the following command on a new terminal window:

java -jar core-java/libs/selenium-server-4.12.0.jar hub

Here you can download the Selenium server JAR file from the Selenium Website or you can use the one available at core-java/libs/selenium-server-4.12.0.jar in Boyka framework repository.

Now, on a new terminal window, run the following command to connect the Android Appium server session node to the Selenium Grid Hub:

java -jar core-java/libs/selenium-server-4.12.0.jar node --config core-java/src/test/resources/grid/appium-node-android.toml

Here we are using Android Node config file located at core-java/src/test/resources/grid/appium-node-android.toml in the framework repository.

Same way, we will start another node for iOS by running the following command on a new terminal window:

java -jar core-java/libs/selenium-server-4.12.0.jar node --config core-java/src/test/resources/grid/appium-node-ios.toml

Here we are using iOS node config file located at core-java/src/test/resources/grid/appium-node-ios.toml in the framework repository.

Boyka config for Selenium Grid

We will be using the following Boyka config file for running our tests on Android and iOS platforms:

{
  "ui": {
    "timeout": {
      "implicit_wait": 10,
      "explicit_wait": 30,
      "page_load_timeout": 30,
      "script_timeout": 10,
      "highlight_delay": 100
    },
    "screenshot": {
      "enabled": true,
      "path": "./screenshots",
      "extension": "jpeg",
      "prefix": "SCR"
    },
    "mobile": {
      "test_grid_wdio_android": {
        "server": {
          "target": "LOCAL",
          "port": 4444,
          "driver": "UI_AUTOMATOR",
          "external": true
        },
        "device": {
          "os": "ANDROID",
          "version": "11",
          "name": "Pixel_7_Pro",
          "type": "VIRTUAL",
          "server_install_timeout": 60,
          "server_launch_timeout": 60,
          "ignore_unimportant_views": true,
          "full_reset": true,
          "swipe": {
            "max_swipe_until_found": 5
          },
          "application": {
            "path": "/apps/android/wdio-demo.apk",
            "wait_activity": "com.wdiodemoapp.MainActivity",
            "type": "HYBRID",
            "install_timeout": 180,
            "wait_timeout": 120
          },
          "virtual_device": {
            "name": "Pixel_7_Pro",
            "headless": true
          }
        }
      },
      "test_grid_wdio_ios": {
        "server": {
          "target": "LOCAL",
          "port": 4444,
          "driver": "XCUI",
          "external": true
        },
        "device": {
          "os": "IOS",
          "version": "16.2",
          "name": "iPhone 14",
          "type": "VIRTUAL",
          "server_install_timeout": 60,
          "server_launch_timeout": 60,
          "connect_keyboard": false,
          "typing_speed": 35,
          "swipe": {
            "max_swipe_until_found": 5
          },
          "virtual_device": {
            "headless": true,
            "launch_timeout": 180
          },
          "wda": {
            "launch_timeout": 120,
            "connection_timeout": 120
          },
          "application": {
            "path": "/apps/ios/wdio-demo.app.zip",
            "type": "HYBRID",
            "install_timeout": 180
          }
        }
      }
    }
  }
}

tip

In this example Boyka config, you must use the correct device details like, device name, platform version, virtual device name, etc.

Now, when you run your tests using these config keys, your test will get executed on the Android and iOS platform with Selenium Grid 4.