Automated GUI tests with Appium 📱🤖

This project is part of my Appium learning.
For my tests, I used Sauce Labs demo app on Android OS. This app is open source, and you can check it here: https://github.com/saucelabs/my-demo-app-android/releases
Feel free to fork this project and create additional tests. Don't forget to leave a star ⭐

👨🏻‍💻 Technology Stack:

Programming language - Java (JDK 19)
Automation framework - Appium 2.1.3
Testing framework - TestNG
Project management tool - Maven

🎨 Design Patterns:

Page Object Model (through Page Factory)
Fluent Page

🧪 Tests:

Login functionality
S1: Login using valid credentials should succeed
S2: Login using invalid credentials should fail
S3: Logout should redirect to the login page
Catalog's filter functionality
Verify that the sort filter...
S1: Name - Ascending sort the searched product list alphabetically
S2: Name - Descending sort the searched product list in reverse alphabetical order
S3: Price - Ascending sort the searched product list in ascending price order
S4: Price - Descending sort the searched product list in descending price order
Cart functionality
S1: Verify information on the Cart page is correct after adding products to the cart
S2: Verify remove item button works
S3: Verify product is removed from the cart after decreasing its quantity to zero
Product's page
S1: Verify the add to cart button is disabled after decreasing the product's quantity to zero

🤖 Example:

Catalog's filter functionality:

appium.-.note.screen.mp4

📜 Instructions:

Appium instalation on Windows OS

You can learn how to install Appium step by step here: https://www.youtube.com/watch?v=KiWIb0HhwRw
Anyway, here's the resume:

Install Java, Maven and Node/Npm
Install Appium through Node: npm i -g appium@next. If you don't get the latest version, try npm install --location=global appium@latest. You can check the version running appium -v
Install Appium Android uiautomator2 driver: appium driver install uiautomator2. Feel free to install the drivers you want
Install Android Studio and create a virtual device
Configure Android Path in your environment variables.
- ANDROID_HOME: root android sdk directory
- PATH: ANDROID_HOME + the following paths = platform-tools, tools, platforms, build-tools
- Check it for a visual explanation (PT-BR): https://youtu.be/yuKlc-a5z5k?si=7E9sJydltJ9_9Bqe&t=73
Install Appium doctor: npm install -g appium-doctor. Run it: appium-doctor --android
- Check the "manual fixes needed" and fix them
If Appium Doctor tells you apkanalyzer.bat is not found, maybe it exists, but you need to rename it putting .bat at the end of the file name. This was my case. Probable apkanalyzer location: C:\Users\YOUR_USER_NAME\AppData\Local\Android\Sdk\tools\bin
Install Appium inspector or run it on the web: https://inspector.appiumpro.com/
Configure the Appium Inspector. Below is the image of my configuration:

To know the device's name, first you need to run the device. Then run this command on cmd: adb devices
Run adb shell dumpsys window | find "mCurrentFocus" to see the app package name and the app activity that is currently on focus in your device
Run adb shell getprop ro.build.version.release to see the android version of the device. You can check the version in the Android Studio also

Uff, now everything seems good, right? Time to run the tests!

Executing the tests:

Run appium command. If you're executing Appium inspector on the web, run appium --allow-cors
Launch your virtual device
Run appium inspector
Finally, execute the tests! 😀

danielandrioli / appiumSauceLabsApp