How to connect Android Emulator with Appium

What is an Android Emulator?

An Android Emulator is a virtual Android device that runs on your computer. It mimics the hardware and operating system of a real Android smartphone or tablet so you can develop, test, and debug Android applications without needing a physical device.

Prerequisites

Requirement	Description
Android Studio	Installed and configured with Android SDK & Emulator
Appium	Installed via Appium Desktop or npm
Node.js	Required for Appium
Java	JDK 8+ installed and configured with JAVA_HOME
Appium Inspector	(Optional) To inspect UI elements
Appium Java Client	For writing test scripts in Java
Emulator	Created & launched using AVD Manager

Step-by-Step Guide

1. Set up Android Emulator

Open Android Studio → AVD Manager
Create a Virtual Device (example: Pixel 4 with Android 11)
Launch the emulator

Tip: You can also launch via command line:

emulator -avd <emulator_name>

2. Check Emulator Connection

Run in terminal or CMD:

adb devices

Output should look like:

List of devices attached
emulator-5554	device

3. Install Appium

npm install -g appium

4. Start Appium Server

From command line:

appium

Or use Appium Desktop and click "Start Server".

5. Set Desired Capabilities

These are needed to connect to your emulator.

{
  "platformName": "Android",
  "platformVersion": "11.0",
  "deviceName": "emulator-5554",
  "automationName": "UiAutomator2",
  "app": "path/to/your/app.apk",
  "noReset": true
}

You can set these in Appium Desktop (Inspector) or in your Java code.

6. Example Java Code to Connect Emulator

import io.appium.java_client.android.AndroidDriver;
import io.appium.java_client.MobileElement;
import org.openqa.selenium.remote.DesiredCapabilities;
import java.net.URL;

public class EmulatorTest {
    public static void main(String[] args) throws Exception {
        DesiredCapabilities caps = new DesiredCapabilities();

        caps.setCapability("platformName", "Android");
        caps.setCapability("platformVersion", "11.0");
        caps.setCapability("deviceName", "emulator-5554");
        caps.setCapability("automationName", "UiAutomator2");
        caps.setCapability("app", "C:\\path\\to\\your\\app.apk");
        caps.setCapability("noReset", true);

        AndroidDriver<MobileElement> driver = new AndroidDriver<>(
            new URL("http://127.0.0.1:4723/wd/hub"), caps
        );

        // Example action
        System.out.println("App launched successfully!");
        driver.quit();
    }
}

Things to check before test:

Check	Description
Emulator is running	Make sure the emulator is active
Appium server is started	Run via terminal or Appium Desktop
ADB device listed	`adb devices` shows emulator
APK path correct	Valid path to your `.apk` file
Appium Java client added	Add it to your `pom.xml` or `build.gradle`