---
version: "2026"
language: "en"
---
# Mobile FAQ

## **How to set up an Appium Server**

Appium acts as the automation bridge between Leapwork and mobile devices.

**To install locally:**

1. Install **Node.js** (LTS version).

2. Run:

       npm install -g appium
       npm install -g appium-doctor

3. Verify with `appium-doctor --android` and fix any missing components (e.g., SDK tools, Java).

4. Start Appium:

       appium

   It will listen on port `4723` by default.
5. Note the URL (e.g., `http://127.0.0.1:4723/wd/hub`) --- you'll use it in Leapwork's **Mobile Device Connection**.

You can also host Appium remotely or through services like HeadSpin or BrowserStack.

*** ** * ** ***

## **How to set up the Android Native Environment**

To prepare your Android environment for Leapwork automation:

1. **Install Java (JDK)** : Make sure JDK 8 or higher is installed. Add the Java `bin` folder to your system `PATH`.

2. **Install Android Flow and SDK Tools**:Download Android Flow, which includes the SDK Manager.

   * Install SDK Platform Tools and SDK Build Tools.

3. **Set Environment Variables:**

   * `ANDROID_HOME` → path to your Android SDK (e.g., `C:\Users\<user>\AppData\Local\Android\Sdk`).

   * Add `%ANDROID_HOME%\platform-tools` and `%ANDROID_HOME%\tools` to `PATH`.

4. **Verify Setup:**

   * Run `adb devices` in a terminal to confirm that Android Debug Bridge (ADB) works.

5. **Optional:** Install Node.js and Appium if you'll be running mobile tests locally.

Your environment is now ready to connect with Leapwork for Android automation.

*** ** * ** ***

## **How to integrate Android Device with Leapwork**

**Minimum Requirements**

* Appium Server installed and running on the local machine.

* Android Native Environment set up (Java SDK, Android SDK, environment variables).

* Android device connected to the same machine via USB cable.

**How to Do It**

1. Prepare the Android Device

   1. Open your phone's **Settings**.

   2. Go to **About Phone** and note the **Device Name** and **Android Version**.

   3. If you don't see *Android Version* and *Build Number* directly, open **Software Information**.

   4. Tap the **Build Number** seven times to enable **Developer Mode**.

   5. Go to **Settings → System → Developer Options** and ensure Developer Options are **enabled**.

   6. In the **Developer Options** , enable **USB Debugging** under the *Debugging* section.

2. Verify Device Connection

   1. Connect the Android phone to your machine with a USB cable.

   2. Open a command prompt and run:

          adb devices

   3. Confirm that your device ID appears in the list as *device*.

   4. If prompted on your phone, accept the *Allow USB debugging* permission.

3. Set Up a [Mobile Connection](https://docs.leapwork.com/leapwork-flow/latest/administration/connections.md) in Leapwork.

4. Set Up [Mobile Configuration](https://docs.leapwork.com/leapwork-flow/latest/administration/mobile-configuration.md) in Leapwork.

**Results**

* Your Android device is now fully integrated with Leapwork.

* The device can be used to run mobile automation flows directly through the Appium connection.

* Once configured, the setup remains reusable for all your Android test cases.

*** ** * ** ***

## **How to automate Android native app using Leapwork on real Android Device**

**Minimum Requirements**

* Appium Server installed and running on your local machine.

* Android Native Environment set up (Java SDK, Android SDK, environment variables).

* Android device integrated with Leapwork and connected via USB cable.

* Device unlocked before recording the test case.

**How to Do It**

1. Start the Recorder:

   1. In Leapwork Flow, select your mobile configuration from the dropdown.

      ![image-20251105-124530.png](/__attachments/a_b08ae390d2b1bb11a14ce5fdb146df496fe1f5b01d4945f7f0f867eac973d325/image-20251105-124530.png?cb=a75c84454a9ba7e01b33406850525c12)
   2. Create a new flow, right-click the canvas, and choose **Add Building Block → Start Mobile Recorder** .

      ![image-20251105-130311.png](/__attachments/a_23a1eab824a0cc9e16868145ed92e2dd7e3d4a05c90ce1d2310d25a3b6d2e84e/image-20251105-130311.png?cb=8fd232335e19315f9a1036161f21069a)
   3. Your device screen will appear on your computer. Hovering over it highlights elements.

2. Open the App Drawer:

   1. Perform a swipe gesture: click at the bottom of the screen, drag upward, and release.

   2. Choose **Mobile Drawing Action** when prompted and click **Apply**.

      ![image-20251105-141747.png](/__attachments/a_0c2186bc30b5ecb041d9db3b647eeb53b21478ed29ab8b0e949e397cacb630b7/image-20251105-141747.png?cb=dfe9d5d3c16272db9682ebf3a3d92e83)

   3. The swipe executes on your physical device.

      ![image-20251105-141810.png](/__attachments/a_24ca8f5e6513c05eb77bd4ce832ee28334a401720a362f000781c1373c78beee/image-20251105-141810.png?cb=d64244b9d254218943153cd283bb5117)

3. Launch the Outlook App:

   * Tap the search bar using a **Mobile Action (Tap)** block.

     ![image-20251105-141850.png](/__attachments/a_e8989d7601155c5aa7517e0c1e92ffc2ae4736e992168ca7a4461526b77f5c59/image-20251105-141850.png?cb=7d976f9c5fd48fcc21020de1c0fdb692)

   * Use **Set Mobile Text** to type *Outlook*.ç

     ![image-20251105-141919.png](/__attachments/a_13637ab603c4972f44acfd284f58b03e55a7525a21cb726c651dcde18e8ff48c/image-20251105-141919.png?cb=dbcbdcf053fccf3f5f1733bdbcb9cec5)

   * When the app appears, tap it again to open it.

4. Compose and Send the Email:

   1. Inside Outlook, use **Mobile Action (Tap)** and **Set Mobile Text** blocks to fill in fields: *To* , *Subject* , and *Body*.

      ![image-20251105-142033.png](/__attachments/a_7ce4edcb631ae7eb5385186e94ce6cff7c38750bacb82d5848faca98ce282397/image-20251105-142033.png?cb=8047e38c7429664b5eb0c65d09dafbaa)

   2. Tap the **Send** button using another **Mobile Action (Tap)** block.

5. Save the recording:

   1. Hover over the bottom-left corner of the mirrored screen and click the **✓** icon to stop recording.

   2. Select **Save and Close Recorder** to generate the flow automatically.

**Results**

* Leapwork creates a complete flow that sends an email through Outlook (or any similar app).

* The flow can be executed, edited, or expanded, for instance, by adding a **Read Excel** block to send multiple emails automatically.

* The entire process takes less than five minutes and runs directly on the connected device.

*** ** * ** ***

## **How to set up the Android Native Environment**

**Minimum Requirements**

* Windows machine with admin rights.

* Stable internet connection to download JDK, Android SDK, and Android Flow.

* At least 10 GB free disk space.

**How to Do It**

1. Install the Java Development Kit (JDK):

   * Download and install the latest **JDK (e.g., JDK 18)** from Oracle.

   * Default installation path: `C:\Program Files\Java\jdk-18.0.1`.

   * Set up the environment variable:

     * Go to **System Properties → Advanced → Environment Variables**.

     * Create a new system variable:

       * **Name:** `JAVA_HOME`

       * **Value:** path to your JDK folder (e.g., `C:\Program Files\Java\jdk-18.0.1`).

         ![image-20251106-121448.png](/__attachments/a_29ac93154b7b866f4e66a54d38c0226cdc46711e1143f6974fc48132fa828575/image-20251106-121448.png?cb=4a9b37441292b6584245eb99db86f7e7)
     * Edit the `Path` variable and add `%JAVA_HOME%\bin`.

       ![image-20251106-122636.png](/__attachments/a_370228e54181fffb87db095aa49889cc36f9e4ca2f89cfbaaf510ce778cb153c/image-20251106-122636.png?cb=271e819853dc4ebe5c3340decd6be564)
   * This ensures Java is globally accessible from the command line.

2. Install Android SDK (Command Line Tools):

   * Create a folder: `C:\Android`.

   * Download the **Android Command Line Tools** for Windows from [Google's developer site](https://developer.android.com/studio?gclid=Cj0KCQjwntCVBhDdARIsAMEwACkmXBvjkMTvSYzJ9741h3PDAhMzxFfVJ99XXZzsDECL_fWCmjS-hRQaAv73EALw_wcB&gclsrc=aw.ds).

   * Extract them to `C:\Android\cmdline-tools`.

   * Inside that folder, create a new subfolder called `latest` and move all extracted files into it.

   * Open Command Prompt and navigate to:

         cd C:\Android\cmdline-tools\latest\bin

   * Run:

         sdkmanager.bat --list

   * Then install the core Android tools, build utilities, and the USB driver for device communication:

         sdkmanager "platform-tools"
         sdkmanager "build-tools;33.0.0"
         sdkmanager "extras;google;usb_driver"

3. Install Android Flow:

   * Download **Android Flow** from the official [Android Developer site](https://developer.android.com/studio?gclid=Cj0KCQjwntCVBhDdARIsAMEwACnRbWcNGtycPEB38xFPoNejEswzc6H5GAKZWWTf0eKdGYWg9rC8eo8aAo4QEALw_wcB&gclsrc=aw.ds).

   * Run the installer and follow these options:

     * Select *Android Flow* component only.

     * Use the default installation path: `C:\Program Files\Android\Android Studio`.

   * After installation:

     * Copy the folders `build-tools`, `cmdline-tools`, and `platform-tools` from `C:\Android` into `C:\Program Files\Android\Android Studio`.

     * Inside `build-tools\33.0.0\lib`, copy the `apksigner` JRE file into the same directory inside Android Flow if it's missing.

       ![image-20251106-123743.png](/__attachments/a_f0bf9bab4fb4477e9b343aebcd6e247a18eefdc6d497d3ab7b6132a807b62d95/image-20251106-123743.png?cb=87a258859f884646b3b276ffe807b877)

4. Set Android Environment Variables:

   * Go to **System Properties → Advanced → Environment Variables** again.

   * Add a new variable:

     * **Name:** `ANDROID_HOME`

     * **Value:** `C:\Program Files\Android\Android Studio`

       ![image-20251106-123844.png](/__attachments/a_d69d072c4840794e7a0ae017dfed1feb72cac650c544ed45341a1d04c320b23d/image-20251106-123844.png?cb=1e3f2d07051a0bc06440f7b56c652f73)
   * Edit the system `Path` and add these entries:

         %ANDROID_HOME%\bin
         %ANDROID_HOME%\tools
         %ANDROID_HOME%\platform-tools

   * Click **OK** to apply changes.

     ![image-20251106-123929.png](/__attachments/a_f30d0231882ec13a84953bdd40c9ed9e997f97974d1c34d65a9d4a9545daf433/image-20251106-123929.png?cb=5a8aa5c05994e90a2dab3f949171cd85)
5. **Verify the Setup**

   * Open Command Prompt and run:

         adb devices

     * If a list of devices or "List of devices attached" appears, your setup is working.

   * You can now connect an Android device or emulator and use Leapwork with Appium for automation.

**Results**

* Your Windows environment is now ready for Android mobile automation with Leapwork.

* All key components (JDK, Android SDK, Android Flow) are correctly installed and globally accessible.

* You can proceed to set up Appium and integrate your Android device to start building and running tests.

*** ** * ** ***

## How to automate Native, Hybrid and Mobile Web Applications in Leapwork?

With Leapwork's no-code automation platform, you can easily test native and mobile web applications across different devices.

Many organizations rely on mobile apps for critical operations but still struggle to automate testing for native iOS and Android apps on real devices. Leapwork makes this process simple and visual.

**Automating mobile web applications**

To automate a mobile web app on Android or iPhone:

1. In the **Start Web Browser** block, open the **Device Type** dropdown.

   ![image-20251112-145208.png](https://docs.leapwork.com/__attachments/a_57fcb67e106a94751a5a1e173907d4e7ab3db2b076651917d177c78a1014ac0e/image-20251112-145208.png?cb=8e1c2a35324bff4d0e52f8259d706559)
2. Select the device you want to test on, such as **Apple iPhone4**.

3. Capture elements and build your flow just as you would with any regular web page.

*(Example: elements on the simulated iPhone can be captured like standard web elements.)*

**Automating native and hybrid mobile apps**

Leapwork also supports testing **native** and **hybrid** mobile applications on real devices.

You can use **BrowserStack App Live** or **Sauce Labs** to access real mobile devices and run tests through Leapwork.

Steps:

1. Open **BrowserStack App Live** (or **Sauce Labs**) and select a device.

2. Launch the mobile app you want to test.

   ![image-20251112-145245.png](https://docs.leapwork.com/__attachments/a_6f2f9f2a4f7426b57d5b5083aff7ec4830d0585f8787a65bfc21ff0f5de6ca90/image-20251112-145245.png?cb=25ef01a203affb713453b1e4fc9a4494)
3. Use Leapwork's **Image** and **Text Recognition** blocks to automate interactions with the app interface.

   ![image-20251112-145350.png](https://docs.leapwork.com/__attachments/a_57c6894836a51953c0516141e58db131893b4e4f7f1f2df5c7e4fc88db95c3d4/image-20251112-145350.png?cb=f0333c30f8a8ff0f32f9fe4a4e168f2d)

*(Example: these blocks can recognize and interact with buttons, icons, and text on the screen.)*