Project and documentation based on
- https://webdriver.io/docs/gettingstarted/
- https://appium.io/docs/en/latest/
- https://github.com/webdriverio/appium-boilerplate/
- https://allurereport.org/docs/features-overview/
- https://github.com/appium/appium-inspector (usefull for dev can target specifics device and tests)
Boilerplate project to run Appium tests together with WebdriverIO for:
- iOS/Android Native Apps
- iOS/Android Hybrid Apps
- Android Chrome and iOS Safari browser
Note
This boilerplate is for Webdriver V8 where the tests are written with async/await and TypeScript.
This boilerplate only handles local execution on 1 em/simulator at a time, not parallel execution.
For more info about that Google on setting up a grid with Appium.
Important
This boilerplate uses the WebdriverIO native demo app which can be found here.
This boilerplate is currently based on:
- WebdriverIO:
8.x - Appium:
2.x
- Clone this project
gh repo clone Izocel/Appium-Boilerplate- Install all dependencies
npm installTip
When running test in a cloud, you don't need Appium installed on you local machine.
Use the appium-installer package:
- Setup Appium on your local machine.
install appium server - If you've already a react-native environement setup (recommended) skip next step.
- Configure Android Emulators/ iOS Simulators.
install environements
-
Import the application files (
.apk/.ipa) insideapps/WdioDemoApp/respective folders. -
Copy and asjust the configuration file (
configs/configs.ts) regarding the simulator or real device you are using. -
Running tests locally
- Android App:
npm run test-android - iOS App:
npm run test-ios
- Android App: