appium Getting started with appium

30% OFF - 9th Anniversary discount on Entity Framework Extensions until December 15 with code: ZZZANNIVERSARY9


Appium is an open source, cross-platform test automation tool for native, hybrid and mobile web apps, tested on simulators (iOS, FirefoxOS), emulators (Android), and real devices (iOS, Android, FirefoxOS).

Why Appium?

  1. You don't have to recompile your app or modify it in any way, due to use of standard automation APIs on all platforms.
  2. You don't have to recompile your app or modify it in any way, due to use of standard automation APIs on all platforms. You can write tests with your favorite dev tools using any WebDriver-compatible language such as Java, Objective-C, JavaScript with Node.js (in promise, callback or generator flavors), PHP, Python, Ruby, C#, Clojure, or Perl with the Selenium WebDriver API and language-specific client libraries.
  3. You can use any testing framework.

Investing in the WebDriver protocol means you are betting on a single, free and open protocol for testing that has become a defacto standard. Don't lock yourself into a proprietary stack.

If you use Apple's UIAutomation library without Appium you can only write tests using JavaScript and you can only run tests through the Instruments application. Similarly, with Google's UiAutomator you can only write tests in Java. Appium opens up the possibility of true cross-platform native mobile automation.

How It Works

Appium drives various native automation frameworks and provides an API based on Selenium's WebDriver JSON wire protocol.

Appium drives Apple's UIAutomation library for versions before iOS 10, which is based on Dan Cuellar's work on iOS Auto. With the deprecation of the UIAutomation library, all iOS 10 and future version are driven by the XCUITest framework.

Android support uses the UiAutomator framework for newer platforms and Selendroid for older Android platforms.

FirefoxOS support leverages Marionette, an automation driver that is compatible with WebDriver and is used to automate Gecko-based platforms.


VersionRelease Date

Installation or Setup


Check the requirements for each device type you wish to automate and make sure they're installed before attempting to use Appium!

iOS Requirements

Android Requirements

  • Android SDK API >= 17 (Additional features require 18/19)

  • Appium supports Android on OS X, Linux and Windows. Make sure you follow the directions for setting up your environment properly for testing on different OSes:

FirefoxOS Requirements

Installation of Appium

Global installation using Node.js

$ npm install -g appium
$ appium

Local installation from Github's master branch

$ git clone
$ cd appium
$ npm install
$ node .

Using the App for Mac or Windows

Writing Tests for Appium

Formatted version of the Appium docs can be found here with the ability to choose code example language from the top right corner.

Launching Appium for Android platform and creating sample test

Environment Setup:


  • make sure Eclipse is downloaded from
  • java is installed (both jdk and jre)
  • android sdk is installed
  • Make sure your environment variable (Path) for Java, Android SDK, Platform and platform-tools is set.

Steps to set Path on windows OS:  Right Click “My Computer”.  “Properties”  On left panel “Advance System Settings”  Select Environment Variables  System Variables-> Type Path-> “Path” double click  Enter the path to JAVA jdk in your system followed by (;) then path to your android sdk (;) path to your android platform (;) path to your android platform tools-> Click OK.

  • Make sure Eclipse Plug-in is installed

Steps to install Eclipse Plug-in for Android:  Start Eclipse, then select Help > Install New Software.  Click Add, in the top-right corner.  In the Add Repository dialog that appears, enter "ADT Plugin" for the Name and the following URL for the Location:  Click OK (If you have trouble acquiring the plugin, try using "http" in the Location URL, instead of "https" (https is preferred for security reasons).

  • Make sure ANDROID_HOME variable is set.

Steps to set ANDROID_HOME variable:  Go to Eclipse->Window on top panel->Preferences-> Double click Android on left panel  In the Android preferences, Copy the SDK Location  Right Click “My Computer”.  “Properties”  On left panel “Advance System Settings”  Select Environment Variables  On the top User Variables-> Select new-> Variable Name, Enter ANDROID_HOME, Variable Path-> Enter copied SDK location from Eclipse-> Click OK  Then System Variables-> Select new-> Variable Name, Enter ANDROID_HOME, Variable Path-> Enter copied SDK location from Eclipse-> Click OK  Exit

  • Make sure Android Virtual Device Manager can be launched. Eclipse->Window on top panel->Android Virtual Device Manager-> Click on the existing virtual device if it exists/ Create a new one with customized configurations.-> Click on “Start” on the right panel of the window.-> Launch

Launching Appium:

  • Install node.js (“”).
  • Launch Appium from command line from the below location: Goto Appium folder node_modules appiumbinshift+right clickopen command prompttype node appiumenter

Following should be displayed: info: Welcome to Appium v1.3.4 (REV c8c79a85fbd6870cd6fc3d66d038a115ebe22efe) info: Appium REST http interface listener started on info: Console LogLevel: debug info: Appium REST http interface listener started on Console LogLevel: debug

Write a Program to launch Appium in Eclipse: package;

import; import;

import org.openqa.selenium.remote.CapabilityType; import org.openqa.selenium.remote.DesiredCapabilities; import org.openqa.selenium.remote.RemoteWebDriver;

public class AppiumLaunch { public static void main(String args[]) throws MalformedURLException { RemoteWebDriver driver; DesiredCapabilities capabilities =new DesiredCapabilities();

capabilities.setCapability("platformName", "Android");

capabilities.setCapability("device ID","");
capabilities.setCapability(CapabilityType.BROWSER_NAME, "");                                                


driver=new RemoteWebDriver( new URL(""), capabilities);
System.out.println("app is launched on the device");



  • Make sure the path of the apk file in the system is correct
  • Make sure the path to the apk file in your system is correct in the program. Use correct package and activity which can be found by decompiling the apk file. For decompiling apk file, go to

Steps to launch appium for android:

  1. First start the appium server on command prompt or by running the appium.exe file.
  2. Check whether the device is connected and displayed in adb: adb devices
  3. Execute the program on the Eclipse. The program will get executed and .apk file which was installed in the device will launch the app.

Got any appium Question?