appium-workshop

An Appium workshop on how to automate a native iOS/Android app with Appium.

This workshop holds the exercises for the Appium workshop. The master branch will hold exercise 1. All other exercises can be found in branches called exercise-#, the # is the number of the exercise. If you want you can cheat, to be honest I don't mind, but you might need to ask yourself if that would be the best way to learn ;-)

Table of content

Requirements for the workshop
Setting up Appium on your machine
Setting up Android and iOS on a local machine
Installing this project
- Check if all works
- Exercises

Requirements for the workshop

This workshop already provides you with a complete project setup for doing automation with JavaScript. I'll not be teaching you how to write tests in JavaScript, but only how to use Appium, how to find elements and so on.

The only thing I ask from you is to follow the steps below before we start the workshop.

Keep in mind that we don’t have enough time during the workshop to dive into environmental issues. If your machine is not working we advise you to pair with someone who has his machine already configured and working.

I would also ask you to install a code editor that supports JavaScript, you can use a free trial version of for example WebStorm (download it from here), or use your favourite one.

Setting up Appium on your machine:

During this workshop we’re going to focus on Android, because everybody can set this up on his machine (Windows / Linux / OSX). Please follow the instructions here for Android and make sure everything is working on your machine.

If you have a Mac you might also want to install everything for iOS, but we will not be covering that during the workshop

Setting up Android and iOS on a local machine

For using Appium on your local machine you need an Android emulator or an iOS simulator on your machine. Check this document for more information.

Installing this project

Hopefully you've been able to set up your local machine for Android and or iOS. To use this project you need to download it to your local machine and install all the dependencies. This can be done with the following steps

Clone the project to your local machine by opening a terminal and enter this

git clone https://github.com/wswebcreation/appium-workshop.git
Go to the folder of the project by entering this in your terminal

cd appium-workshop
Install all the dependencies by running this command in your terminal

npm install

Check if all works

I've created a simple test case to check if everything works on your machine. You can run this script by:

opening a terminal
make sure you are in the appium-workshop-folder
Open the just created Android emulator (Make sure you created a Android emulator with the name `Pixel_8.1``, see this-document)

Run the following command

npm run test.android

When everything was correct, you would see the following logs

➜  appium-workshop git:(master) ✗ npm run test.android

> appium-workshop@1.0.0 test.android /Users/wswebcreation/Git/appium-workshop
> wdio tests/configs/wdio.local.app.android.conf.js


Execution of 1 spec files started at 2019-06-13T06:12:34.384Z

[0-0] RUNNING in com.swaglabsmobileapp.MainActivity - /tests/specs/login.spec.js
[0-0] PASSED in com.swaglabsmobileapp.MainActivity - /tests/specs/login.spec.js

 "spec" Reporter:
------------------------------------------------------------------
[emulator-5554 LINUX 8.1.0 #0-0] Spec: /Users/wswebcreation/Git/appium-workshop/tests/specs/login.spec.js
[emulator-5554 LINUX 8.1.0 #0-0] Running: emulator-5554 on LINUX 8.1.0 executing /Users/wswebcreation/Git/appium-workshop/apps/Android.SauceLabs.Mobile.Sample.app.1.0.0.apk
[emulator-5554 LINUX 8.1.0 #0-0]
[emulator-5554 LINUX 8.1.0 #0-0] Login
[emulator-5554 LINUX 8.1.0 #0-0]    ✓ should be able to login with a standard user
[emulator-5554 LINUX 8.1.0 #0-0]    - should not be able to login with a locked user
[emulator-5554 LINUX 8.1.0 #0-0]    - should show an error when no username is provided
[emulator-5554 LINUX 8.1.0 #0-0]    - should show an error when no password is provided
[emulator-5554 LINUX 8.1.0 #0-0]    - should show an error when no match is found
[emulator-5554 LINUX 8.1.0 #0-0]
[emulator-5554 LINUX 8.1.0 #0-0] 1 passing (5s)
[emulator-5554 LINUX 8.1.0 #0-0] 4 skipped


Spec Files:      1 passed, 1 total (100% completed) in 00:00:16

If this is the case, congrats 🎉, if not, check the logs and see what is wrong / missing

Exercises

In our previous step we already checked if the setup worked and we already ran our first test. The master branch already holds the first exercise, which can be found here.

All other exercises can be found in branches called exercise-#, the # is the number of the exercise. Check the note at the beginning of this document!

The goal of each exercise and the steps you need to take can be found in the exercise documents.

Check out a branch

Check out the branch exercise-#(# is the number 2 or 3) with:

git checkout exercise-#

or go to GitHub and select branch exercise-2 or exercise-3

You will find:

answers for the previous exercise
the new exercises

The answers of exercise-3 can be found in the branch called answers-exercise-3, use

git checkout answers-exercise-3

to see them.

arkhangelsk/appium-workshop