First Appium Test to Launch Amazon App

Finally the times come, when we will write our First Appium Test to Launch Amazon App. This will include following steps:

Launch Appium Node server
Create your first test script
Execute your first test

Launch Appium Node Server

1) I am expecting that your Appium window is already opened on your machine. If you have restarted your system then please start Appium by navigating to Appium directory in your system and start Appium by double-clicking Appium.exe file.

Appium_1

Android Icon is for Configuration settings
Settings Icon is for General Settings
Play Icon is for Starting Node server

2) Click on Android icon to open the configuration of the Appium run. There you need to select the check box of ‘No Reset‘. This will ensure that the Appium will not install or uninstall App on every run.

Appium_2

3) Click on General Setting icon and make sure that Server Address and Port is populated.

Appium_4

Note: Do not alter the IP address or port number. Your Appium console starts at 127.0.0.1:4723 as shown in below.

4) Now its time to start the Appium server, just click on the Launch Appium Node Server button on the top right corner of Appium window and wait for few seconds. Appium server started and running on your system.
Appium_3

Run The First Test

Now you are all set to write your first test script. Create a small test program for opening an Amazon application on your device using Appium.

1) Copy & paste the below code to your StartApplication class and give it a run.

package amazon;

import io.appium.java_client.android.AndroidDriver;
import java.io.File;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.concurrent.TimeUnit;
import org.openqa.selenium.remote.CapabilityType;
import org.openqa.selenium.remote.DesiredCapabilities;

public class StartApplication {

		private static AndroidDriver driver;
		public static void main(String[] args) throws MalformedURLException, InterruptedException {

			File classpathRoot = new File(System.getProperty("user.dir"));
			File appDir = new File(classpathRoot, "/Apps/Amazon/");
			File app = new File(appDir, "in.amazon.mShop.android.shopping.apk");

			DesiredCapabilities capabilities = new DesiredCapabilities();
			capabilities.setCapability(CapabilityType.BROWSER_NAME, "");
			capabilities.setCapability("deviceName", "Micromax A311");
			capabilities.setCapability("platformVersion", "4.4.2");
			capabilities.setCapability("platformName", "Android");
			capabilities.setCapability("app", app.getAbsolutePath());
			capabilities.setCapability("appPackage", "in.amazon.mShop.android.shopping");
			capabilities.setCapability("appActivity", "com.amazon.mShop.home.HomeActivity");

			driver = new AndroidDriver(new URL("https://127.0.0.1:4723/wd/hub"), capabilities);
			driver.manage().timeouts().implicitlyWait(80, TimeUnit.SECONDS);
			Thread.sleep(10000);
			driver.quit();

	}

}

package amazon;

import io.appium.java_client.android.AndroidDriver;

import java.io.File;

import java.net.MalformedURLException;

import java.net.URL;

import java.util.concurrent.TimeUnit;

import org.openqa.selenium.remote.CapabilityType;

import org.openqa.selenium.remote.DesiredCapabilities;

public class StartApplication {

private static AndroidDriver driver;

public static void main(String[] args) throws MalformedURLException, InterruptedException {

File classpathRoot = new File(System.getProperty("user.dir"));

File appDir = new File(classpathRoot, "/Apps/Amazon/");

File app = new File(appDir, "in.amazon.mShop.android.shopping.apk");

DesiredCapabilities capabilities = new DesiredCapabilities();

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

capabilities.setCapability("deviceName", "Micromax A311");

capabilities.setCapability("platformVersion", "4.4.2");

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

capabilities.setCapability("app", app.getAbsolutePath());

capabilities.setCapability("appPackage", "in.amazon.mShop.android.shopping");

capabilities.setCapability("appActivity", "com.amazon.mShop.home.HomeActivity");

driver = new AndroidDriver(new URL("https://127.0.0.1:4723/wd/hub"), capabilities);

driver.manage().timeouts().implicitlyWait(80, TimeUnit.SECONDS);

Thread.sleep(10000);

driver.quit();

}

2) Do not get into details for now and simply run the test. To start the test just select Run > Run As > Java Application Or Right Click on Eclipse code and Click Run As > Java Application.

3) After a few seconds, you will see that with the help of your script, Amazon application will be launched on your device. Once the execution is finished, you will see a long list of messages on the Appium console. We will come back to these messages later.

Code Explanation

Lets now discuss what each line of code means in the above test. I hope you are enjoying your journey of learning Appium.

Import libraries statements

// Llibrary for Appium drivers
import io.appium.java_client.android.AndroidDriver;

// Library to create the path to APK
import java.io.File;

// Library used to verify if URL is malformed
import java.net.MalformedURLException;

// Library used to create URL for the Appium server
import java.net.URL;

// Libraries for configuring Desired Capabilities
import org.openqa.selenium.remote.CapabilityType;
import org.openqa.selenium.remote.DesiredCapabilities;

Path to APK file

Since the Amazon app apk is stored in the computer and is not already installed on the device we need to create a file object which represents the actual apk file on the disk. I placed the folder ‘/Apps/Amazon/‘ which contains the apk file inside the Eclipse project.

// Path to Eclipse project
File classpathRoot = new File(System.getProperty(“user.dir”));

// Path to <project folder>/Apps -> Amazon
File appDir = new File(classpathRoot, “/Apps/Amazon/”);

// Path to <project folder>/Apps -> Amazon/Amozon apk file
File app = new File(appDir, “in.amazon.mShop.android.shopping.apk”);

Desired Capabilities

To be able to test the app on an actual device Desired Capabilities need to be set. Desired Capabilities are a set of keys and values sent to the Appium server to tell the server what kind of automation session we’re interested in starting up. There are also capabilities used to modify the behavior of the server during automation.

// To create an object of Desired Capabilities
DesiredCapabilities capabilities = new DesiredCapabilities();

// Name of mobile web browser to automate. It should be an empty string, as we are automation an app
capabilities.setCapability(CapabilityType.BROWSER_NAME, “”);

// Name of the OS: Android, iOS or FirefoxOS
capabilities.setCapability(“platformName”, “Android”);

// Mobile OS version – My device is running Android 4.4.2
capabilities.setCapability(CapabilityType.VERSION, “4.4.2”);

// Device name: – I am using Micromax A311
capabilities.setCapability(“deviceName”, “Micromax A311”);

// An absolute local path to the APK file
capabilities.setCapability(“app”, app.getAbsolutePath());

// Java package of the tested Android app
capabilities.setCapability(“appPackage”, “in.amazon.mShop.android.shopping”);

// An activity name for the Android activity you want to run from your package.
capabilities.setCapability(“appActivity”, “com.amazon.mShop.home.HomeActivity”);

// Constructor to initialize driver object with new Url and Capabilities
driver = new AndroidDriver(new URL(“https://127.0.0.1:4723/wd/hub”), capabilities);