This repo contains all of the examples that will be covered in the "Getting started with the Robotframework-AppiumLibrary" online workshop (click here to watch a walkthrough on YouTube). The core audience for this workshop are beginners but there's also content mentioned below that could be interesting to more advanced testers as well. A lot of the examples kept in this repo were heavily influenced by the Robot-Framework-Lone-Tester-Strategies-RoboCon-2019 and Tool-Strategies-Lone-Testers-Test-Leadership-Congress-2019 work and experiments I have done in the past. More information about this RoboCon 2021 workshop can be found here... https://robocon.io/#workshops
Bonus Content: There are some possibly interesting extras in the repo that I did not mention in the original workshop bio. They are...
- Parallel running Appium + Grahpwalker example (written in a single
.robotfile) uing PaBot. - Parallel running Android adb shell CPU monitoring example using PaBot and the top Linux CLI tool.
- Several adb shell + Robotframework-AppiumLibrary examples.
- Some video capture examples.
Updated Content: Everything in this repo will be used in the Getting started with the Robotframework-AppiumLibrary - RoboCon 2022 In-person Workshop, and will be combined with the following...
- There is a new real Android device app installation test that was demonstrated at the In-person Workshop. Before running this test, you need to set up a real Android device connected by USB and listed by the
adb devicescommand.- This command runs the app installation test,
bash ./start-specific-appium-example-workflows-for-workshop.sh Robot-Framework-Android-Apps-And-Adb-Tests Robot-Framework-Android-Apps-And-Adb-Tests.
- This command runs the app installation test,
- There is now a new graph visualization feature added to the Android Monitoring example.
- New GraphMakerExample.py library utlilizing Bokeh graphs.
- After running the
bash ./start-specific-appium-example-workflows-for-workshop.sh Robot-Framework-Parallel-IOS-Android-Testscommand a memory usage graph is generated. - The new graph visualization feature can also run in standalone mode using this command
bash ./start-specific-appium-example-workflows-for-workshop.sh Robot-Framework-Parallel-IOS-Android-Tests, but it needs to run after thebash ./start-specific-appium-example-workflows-for-workshop.sh Robot-Framework-Parallel-IOS-Android-Testscommand has finished running at least once.
- After running the
The following are the basic technical requirements to run the examples during the workshop.
- Python 3 (this workshop was created using Python 3.9.2) -> https://www.python.org/downloads/
- NodeJS 14 (this workshop was created using Node 14.16.0) -> https://nodejs.org/en/ or use https://github.com/nvm-sh/nvm
- Java 11 (this workshop was created using OpenJDK 11.0.10) -> https://www.java.com/en/
- Appium (the server, found on NPM) -> http://appium.io/docs/en/about-appium/getting-started/?lang=en#getting-started
- Android Studio (available for Windows, MacOS, Linux users etc.) - https://developer.android.com/studio
- XCode (only available for MacOS users) - https://developer.apple.com/xcode/
- Robot Framework and Robotframework-AppiumLibrary -> https://robotframework.org
- PaBot (this workshop was created using version 1.10.1) -> https://github.com/mkorpela/pabot
- Charles Proxy -> https://www.charlesproxy.com/documentation/proxying
- Graphwalker, a model-based testing tool -> https://github.com/GraphWalker/graphwalker-project
- Appium Desktop -> https://github.com/appium/appium-desktop
- wget -> https://www.gnu.org/software/wget/
- cURL -> https://curl.se/
- jq -> https://stedolan.github.io/jq/
- git -> https://git-scm.com/
After installing the basic technical requirements on your machine (depending on the OS: Windows, MacOS, Linux etc.) please run the following on your machine.
git clone https://github.com/jg8481/Getting-Started-Robotframework-AppiumLibrary-RoboCon-2021-And-2022.git
cd ./Getting-Started-Robotframework-AppiumLibrary-RoboCon-2021
Set up an .env file using the provided template.env file.
There will be presentation slides explaining the following in more detail and I will assist everyone with running them. The examples will automate the following apps.
- https://github.com/wikimedia/wikipedia-ios
- https://www.browserstack.com/app-automate/sample-apps/android/WikipediaSample.apk
If the BrowserStack WikipediaSample.apk link stops working you can try these links.
- https://github.com/hariprasadms/sample-applications/blob/master/WikipediaSample.apk
- https://www.apkmirror.com/?post_type=app_release&searchtype=apk&s=wikipedia
- Workshop-Part-One: Simple automation workflows for IOS apps and automation workflows for Android apps + adb shell.
>> Following commands need to run first before any other examples in Workshop-Part-One. <<
bash ./start-specific-appium-example-workflows-for-workshop.sh All-Appium-Tests-Teardown &&
bash ./start-specific-appium-example-workflows-for-workshop.sh Appium-No-Proxy-Test-Setup
>> Each command runs a group of examples for Workshop-Part-One. <<
bash ./start-specific-appium-example-workflows-for-workshop.sh Robot-Framework-Android-Apps-And-Adb-Tests Android_Adb
bash ./start-specific-appium-example-workflows-for-workshop.sh Robot-Framework-Android-Apps-And-Adb-Tests Android_App_Recording_Screen_Capture
bash ./start-specific-appium-example-workflows-for-workshop.sh Robot-Framework-IOS-App-Tests
bash ./start-specific-appium-example-workflows-for-workshop.sh Robot-Framework-IOS-And-Android-Mobile-Browsers-Test-Examples
- Workshop-Part-Two: PaBot, Charles Proxy, Graphwalker, and adb shell CPU usage monitoring workflows.
>> Following commands need to run first before any other examples in Workshop-Part-Two. <<
## The following two setup commands are only for the Charles Proxy examples.
bash ./start-specific-appium-example-workflows-for-workshop.sh All-Appium-Tests-Teardown &&
bash ./start-specific-appium-example-workflows-for-workshop.sh Appium-Charles-Proxy-Test-Setup
## The following two setup commands are only for the PaBot Parallel IOS and Android device examples.
bash ./start-specific-appium-example-workflows-for-workshop.sh All-Appium-Tests-Teardown &&
bash ./start-specific-appium-example-workflows-for-workshop.sh Appium-No-Proxy-Test-Setup
>> Each command runs a group of examples for Workshop-Part-Two. <<
bash ./start-specific-appium-example-workflows-for-workshop.sh Robot-Framework-Charles-Proxy-IOS-And-Android-Mobile-Browsers-Test-Example
bash ./start-specific-appium-example-workflows-for-workshop.sh Robot-Framework-Parallel-IOS-Android-Tests
The Workshop Examples use a lot of Bash scripting for setting up Appium and running Robot Framework. If you have a Windows operating system, the following options may work for you...
- Windows 10 users can check out the "Windows Subsystem for Linux" -> https://docs.microsoft.com/en-us/windows/wsl/
- Consider downloading Git for Windows -> https://git-scm.com/download/win and https://gitforwindows.org/
- There's also CygWin -> https://www.cygwin.com/
- It's possible to run the Android Workshop Examples from a Linux virtual machine running on Windows.
- As a last resort, you can copy the commands and run them individually from your Windows machine.
- Pekka Klarck
- Ed Manlove
- Serhat Bolsu
- Antti Karjalainen
- René Rohner
- James Bach
- Jonathan Bach
- Michael Bolton
- Cem Kaner
- Kristian Karl
- Harry Robinson
- Mikko Korpela
- Bryan Oakley
- Shiva Prasad Adirala
- The Appium development team
- The Graphwalker development team
- The thought-leaders who inspired me to learn model-based testing
- The thought-leaders of Rapid Software Testing Methodology
- The entire Robot Framework community and its contributors
Their contributions to the testing community helped me a lot with this workshop and my day-to-day work.