============================================================ Appium Testing Sample with Robot Framework and AppiumLibrary

AppiumLibrary_ is an appium testing library for Robot Framework_. In this sample usage of the library, you can find ios and android test suites that are ready to execute. Also you can find how the reports look like.

.. contents:: Contents: :depth: 1 :local:

Downloading demo package

To get the demo, you can either download_ the repository from GitHub or checkout the source code_ directly.

Reports are available also online in generated results_.

Overview

In this sample framework, you will find test cases for iOS and Android. Test cases are written for sample applications under demoapp_ folder.

• Test suite for iOS and Android Locators
• Test suite for iOS and Android Mobile Web Testing
• Test suite for iOS and Android Basic Interactions
• Test suite for iOS and Android Selectors

Generated results

After running tests_ you will get report and log in HTML format. Example files are also visible online in case you are not interested in running the demo yourself:

• report.html_
• log.html_

Running Sample

Preconditions

Install Robot Framework_ and AppiumLibrary_

The simplest way is using pip_ package manager::

pip install -r requirements.txt

Device Setup

After installing the library, you still need to setup an simulator/emulator or real device to use in tests. iOS and Android have separate paths to follow, and those steps better explained in Appium Driver Setup Guide_. Please follow the Driver-Specific Setup according to platform.

Running tests

Test cases are located in the tests folder. They can be executed using the robot command::

robot  tests/*.test.robot

You can also run an iOS or Android case file/test::

robot tests/android_basic_interactions.test.robot
robot --test "Should find elements by ID" tests

TODO

There are much more to improve, here is the list of things to come

• Circle.ci build pipeline
• SauceLabs Execution Support
• More coverage from library methods

.. _Robot Framework: http://robotframework.org .. _Robot Framework User Guide: http://robotframework.org/robotframework/#user-guide .. _Appium Driver Setup Guide: http://appium.io/docs/en/about-appium/getting-started/?lang=en .. _AppiumLibrary: https://github.com/serhatbolsu/robotframework-appiumlibrary .. _pip: http://pip-installer.org .. _download: https://github.com/serhatbolsu/robotframework-appium-sample/archive/master.zip .. _source code: https://github.com/serhatbolsu/robotframework-appium-sample.git .. _demoapp: https://github.com/serhatbolsu/robotframework-appium-sample/tree/master/demoapp .. _report.html: https://serhatbolsu.github.io/robotframework-appium-sample/docs/report.html .. _log.html: https://serhatbolsu.github.io/robotframework-appium-sample/docs/log.html