Skip to content

README.md

Latest commit

 

History

History
89 lines (66 loc) · 3.37 KB

README.md

File metadata and controls

89 lines (66 loc) · 3.37 KB

Appium Server Side + Webdriver.io

This directory contains simple test scenario using Appium + Webdriver.io + Mocha.

Structure

.
├── package.json
├── package-lock.json
├── run-tests.sh
├── test
│   └── specs
│       ├─── android.js
│       └─── ios.js
├─── android.conf.js
├─── ios.conf.js
└─── create-zip.sh
  • package.json and package-lock.json is obvious for everyone familiar with Node.js. Shortly for those who doesn't know: it contains information about project and what's more important - dependenencies.
  • run-tests.sh - starting point for BitBar Cloud executor
  • test/specs/android.js or test/specs/ios.js - Test itself
  • android.conf.js - Config for android Webdriver.io Testrunner
  • ios.conf.js - Config for ios Webdriver.io Testrunner
  • create-zip.sh - script creating zip file needed to run tests on BitBar

Dependencies

  • @wdio/appium-service - Appium Service
  • @wdio/cli - Webdriver.io (and Testrunner)
  • @wdio/junit-reporter - JUnit reporter, because Bitbar Cloud reads JUnit reports to fetch information about i.a. test cases
  • @wdio/local-runner - To run test "locally" (because from server perspective it's locally)
  • @wdio/mocha-framework - Mocha support
  • @wdio/spec-reporter - Default spec reporter
  • chai - Chai for Mocha (because I wanted to use should [BDD style])

Usage

Prepare package

As always for server side execution you need to create zip package. Zip all files mentioned in Structure section above.

You can do it either manually (with your OS file explorer) or by command line. Linux example:

zip "sample-test.zip" \
    "package.json" \
    "package-lock.json" \
    "run-tests.sh" \
    "test/specs/android.js" \
    "test/specs/ios.js" \
    "android.conf.js" \
    "ios.conf.js"

We've prepared script to make running that command easier. Just run create-zip.sh with output file name passed as parameter.

./create-zip.sh "sample-test"

Upload Test and Create Test Run

The simplest way to do that would be using Bitbar Cloud UI. Especially if you don't know your API key. Click here to check out documentation.

This test is using for Android bitbar-sample-app.apk and for iOS bitbar-ios-sample.ipa. Download it and use it with prepared test package.

FAQ

To use Chai's should you need to run proper code. Where it's done?

It's in *.conf.js's before hook.

There is global function takeScreenshot in test - where it came from?

It's in *.conf.js's before hook.

Links