❗️ This guide is mainly intended to be used as an Android User.

✨ Pre-requisites

• Install Node (https://nodejs.org/en/download/)

• Install Java (https://www.java.com/en/)

• Setup ANDROID_HOME & JAVA_HOME

• Install Android Studio (If you want to test using an emulator)

• In order to get your app selectors I recommend you to install Appium Inspector, it can be found here.

  1. Open the application you've just installed.

  2. Type 0.0.0.0 in Remote Host.

  3. Type 4723 in Remote Port.

  4. Type '/wd/hub' in Remote Path.

  5. Configure your "Desired Capabilities": There are tons of options but you only need this to start.

     {
       "platformName": "Android",
       "appium:platformVersion": "12",
       "appium:deviceName": "Android Emulator",
       "appium:app": "{PATH TO APK OR IPA FILE}",
       "appium:automationName": "UiAutomator2" // Default option
     }

     Read more about desired capabilities here.

You're almost done, at this point you just need to run Appium Desktop by clicking the "startServer" button and then go to the Appium Inspector application and click the "Start session" button. Now that your session has started you will see your application at the left and elements TREE at the right. Click an element to see the selectors to use in your tests. Always try to set accessibility ids! 🫡

🚀 Install & Run boilerplate

Install it locally and run in easy steps

1- cd appium-webdriverio
2- npm install
3- npm test

📊 Run tests with allure reports

Pre-requisites:

brew install allure

Generate & Open

npm run test-allure