Appium Architecture for Android Testing

Ahmet Koçu
Mobile Application Test Automation
4 min readApr 4, 2017

Appium is certainly one of the first tool to come to mind when it comes to mobile test automation. It continues to evolve rapidly with the advantage of open source development.

In this article, I would like to talk about architecture on Appium Android side. Those who want to develop their own automation framework or use this tool more effectively should look at the handy libraries that Appium has in the backplane.

Let’s first look briefly at the Android test libraries, Instrumentation, and UIAutomator’s libraries. Along with allowing you to develop UI test automation in two libraries, there are some differences. The Instrumentation library has been supported since the first versions of Android and many operations can be automated on the application front. However, except for the application context, the native elements such as the alert window, notification, etc. can not be accessed. UIAutomator is a test library which is used together with API 18 and allows easy automation of test automation on the UI of the application and operation system. API 18 and above are able to write much stronger tests with these two libraries.

The Appium is based on small modules that run on the application with the WebDriver protocol. Through these modules, take screenshots of the device, click on the application elements, and so on. Commands are being processed on the device.

On the Android side, I want to talk first about the Appium Android Bootstrap. This module allows handling of commands sent using Android’s UIAutomator test framework. It is a Java application that runs on Android and has a Javascript interface to access it on the nodejs side.

This module technically works like this;
- The Java application contains a test derived from the com.android.uiautomator.testrunner.UiAutomatorTestCase class. This test works to run a socket server listening on port 4724 on the device. Uses the Appium UI Automator interface to load and run the test on the device.
- This server gets the commands, converts them to the appropriate Android UI Automator commands and runs them on the device.
- Commands are sent via the JavaScript interface.

Secondly, let’s look at the Appium UIAutomator 2 Server module. The logic of this librarian is the same as Bootstrap, except that this module was developed to work with UI Automator 2.0. Unlike the Bootstrap module, it is used as an Android package, not as a jar library. When the module is compiled, two (application and application test) APKs are generated. After installing them on the device, we run the application test and activate the socket server to the 6790 port. It also has a Javascript interface (appium-uiautomator2-driver).

Appium includes a small nodejs module for running tests written in UI Automator on Android. With the appium-uiautomator module, you can send and run the jar package containing your test to the device. In Appium, this module is used to run the Bootstrap module.

Finally, let’s talk about Selendroid, which is used to support older versions of Android within Appium. Selendroid is another test tool that you can automate your Android tests on your own. Again with WebDriver protocol, the desired commands can be run on the device. This test framework is built on the Android Instrumentation library. For this reason, it is a good tool for those who want to test on old Android versions with some limitations. His work is as follows;

  • The APK to be tested is re-signed.
  • The Selendroid test server APK is signed with the same key. (Instrumentation library and target application must be signed with the same key.)
  • These APKs are installed on the device.
  • The instrumentation test is run via ADB and the server is removed from the device.

This test tool is used by Appium with the appium-selendroid-driver JavaScript interface. This interface performs the above steps to run the Selendroid server on the device and sends the test commands to the device over this server.
After the Appium 1.5. * Version, it was a completely new architecture. Thanks to its modular structure, a number of useful tools that you may need in test development are available on their own and are open source. It would be useful to examine the modules within the Appium architecture in order to be able to use this tool more effectively in developing mobile application test frameworks or in testing processes.

RobotQA and Running Appium tests in the cloud
With RobotQA test services, you can run your Appium tests in parallel on hundreds of different devices in the cloud. You can get test results as a detailed report consisting of screen images, video, device logs and performance logs.
We will also be able to provide RestApi to access our device lab and create test scripts, or you can run your tests on our devices from your own development environment.

--

--