appiumx-helios-driver

Appiumx Helios Driver

Appiumx Helios Driver is a test automation tool for Helios apps

Installation

npm install appiumx-helios-driver

Usage

Import Helios Driver, set desired capabilities and create a session:

import { HeliosDriver } from `appiumx-helios-driver`

let defaultCaps = {
  platformName: 'Mac'
};

let driver = new HeliosDriver();
await driver.createSession(defaultCaps);

Watch code for changes, re-transpile and run unit tests:

npm run test

Test

You can run unit and e2e tests:

// unit tests:
npm run test

// e2e tests
npm run e2e-test

Opt-In Features (With Security Risk)

These can be enabled when running this driver through Appium, via the --allow-insecure or --relaxed-security flags.

Feature Name	Description
system_shell	Allows to execute shell scripts on the same machine. Read appiumx-helios-driver#38 for more details on the implementation

Desired Capabilities

Should be same for Appiumx

Differences are noted here:

Handling Appiumx for Helios

Capability	Description	Values
a4hHost	Specify the host name to the app for helios application. Defaults to 127.0.0.1	e.g., localhost
a4hPort	Specify the port to the app for helios application. Defaults to 4622	e.g, 4622, 8080
cookies	Set propertires for appiumx-for-helios. Please read this section for more details.	[{'name': 'implicit_timeout', 'value': 20.5}]

Customize the port of AppiumForHelios / Run tests in parallel

You can launch multiple AppiumForHelios on a same machine to run tests in parallel. Please consider to set a4hPort and a4hAppPath as their capabilities to handle multiple Appiumx sessions on the same machine. You must modify the port number in appiumx-for-helios and build the app to coordinate the port number on AppiumForHelios. Appiumx-helios-driver tries to establish a session to the host/port referencing a4hPort and a4hAppPath. Do not forget to handle your test scenarios properly not to conflict each other since scenarios run on the same machine.