Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sadabnepal/webdriverioappiummochajs
Mobile Test framework using WebdriverIO and Appium with mocha framework
https://github.com/sadabnepal/webdriverioappiummochajs
appium mobile-testing mocha webdriverio webdriverio-boilerplate-framework
Last synced: about 1 month ago
JSON representation
Mobile Test framework using WebdriverIO and Appium with mocha framework
- Host: GitHub
- URL: https://github.com/sadabnepal/webdriverioappiummochajs
- Owner: sadabnepal
- Created: 2022-01-21T18:07:07.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2022-02-20T05:51:23.000Z (almost 3 years ago)
- Last Synced: 2023-03-09T05:12:14.366Z (almost 2 years ago)
- Topics: appium, mobile-testing, mocha, webdriverio, webdriverio-boilerplate-framework
- Language: JavaScript
- Homepage:
- Size: 4.04 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Mobile Test Automation Framework | WebdriverIO | Appium
### Requirements:
[](https://nodejs.org/en/download/)
[](https://github.com/appium/appium-inspector/releases)
[](https://appiumpro.com/editions/122-installing-appium-20-and-the-driver-and-plugins-cli)
[](https://developer.android.com/studio)
[](https://www.oracle.com/java/technologies/downloads/)
[](https://code.visualstudio.com/download)
### Getting Started:
#### Installing Appium on a local machine
> There are several documents and instructions on the internet to install Appium on your local machine.
This is just one of the many ;-)
To setup the local test environment the following needs to be installed:
- [appium](https://github.com/appium/appium) with `npm install appium@next -g`
- [appium-doctor](https://github.com/appium/appium-doctor) with `npm install appium-doctor -g`
- [appium-desktop](https://github.com/appium/appium-desktop) This one needs to be downloaded from [here](https://github.com/appium/appium-desktop/releases) and pick the latest stable releases
#### Setup Android SDK path environment variable
```
- ANDROID_HOME =
- %ANDROID_HOME%\tools [path variable]
- %ANDROID_HOME%\tools\bin [path variable]
- %ANDROID_HOME%\platform-tools [path variable]
```
#### Setup/Create virtual device on Android studio:
```
1] Open Android Studio
2] Click on More Actions
--> AVD Manager
--> Create Virtual Device
--> Select the device and OS version (from below device details)
--> Finish
3] Once Virtual device is created, click on Launch this AVD in the emulator.
4] Command to view the list of devices attached `adb devices`
```
```
Device 1: Pixel 3 - version 11
Device 2: Nexus 6 - version 10 [ if you want to run tests in parallel ]
```
#### Clone repository:
```bash
git clone https://github.com/sadabnepal/WebdriverIOAppiumMochaJS.git
Navigate to `WebdriverIOAppiumMochaJS`
```
Note: all npm command should be executed from root project folder.
#### Install dependencies:
```bash
npm install
```
#### Verify appium drivers:
```
appium driver list
Sample output log of driver
-----------------------------
✔ Listing available drivers
- [email protected] [installed (NPM)]
- xcuitest [not installed]
```
> If drivers are not installed then run below commnad as required:
```
appium driver install uiautomator2 [ android driver ]
appium driver install xcuitest [ ios driver ]
```
#### Verify all pre-requisite for android:
> appium-doctor is used to diagnose and fix common Node, iOS and Android configuration issues before starting Appium. You only run it once to check your local machine. See an example output below.
```
appium-doctor
Sample output log of configuration [ all option should be green checked]
-----------------------------
info AppiumDoctor Appium Doctor v.1.16.0
info AppiumDoctor ### Diagnostic for necessary dependencies starting ###
info AppiumDoctor ✔ The Node.js binary was found at: C:\Program Files\nodejs\node.EXE
info AppiumDoctor ✔ Node version is 14.17.3
info AppiumDoctor ✔ ANDROID_HOME is set to:\Android\Sdk
info AppiumDoctor ✔ JAVA_HOME is set to:
info AppiumDoctor Checking adb, android, emulator
info AppiumDoctor 'adb' is in \Android\Sdk\platform-tools\adb.exe
info AppiumDoctor 'android' is in \Android\Sdk\tools\android.bat
info AppiumDoctor 'emulator' is in \Android\Sdk\emulator\emulator.exe
info AppiumDoctor ✔ adb, android, emulator exist: \Android\Sdk
info AppiumDoctor ✔ 'bin' subfolder exists under '\jdk-11.0.12.7-hotspot'
```
#### .env file data update
Note: create .env file in root project folder, update required details
```
RUN_MODE=parallel # Add this only when you want to run test in both devices
EMULATOR_DEVICE1_ID=Pixel_3
EMULATOR_DEVICE1_NAME=Pixel 3
EMULATOR_DEVICE1_VERSION=11
EMULATOR_DEVICE2_ID=Nexus 6
EMULATOR_DEVICE2_NAME=Nexus_6
EMULATOR_DEVICE2_VERSION=10
BROWSERSTACK_USERNAME=
BROWSERSTACK_ACCESS_KEY=
BROWSERSTACK_ANDROID_APP_ID=
BROWSERSTACK_ANDROID_DEVICE=
BROWSERSTACK_ANDROID_VERSION=
BROWSERSTACK_IOS_APP_ID=
BROWSERSTACK_IOS_DEVICE=
BROWSERSTACK_IOS_VERSION=
```
#### SetUp BrowserStack
```
- Create account
- Find username, access key
- Upload Android (.apk) and IOS (.ipa) files used in project
- Note down app id for both
- Select device for both android and ios
- Update all details in .env file
```
### Run Test:
```
npm test
```
### Generate Report:
```
npm run report
```
### Sample Report
