Adding an Android device (Android TV, Fire TV, Android mobile) to Suitest

Suitest supports all the different devices with operating system based on Android. When adding a new device into Suitest, there are 2 platforms to choose from:

  • Android TV (including Amazon Fire TV)
  • Android mobile (phones and tablets)

Device has to run Android version 5.0 or later (minimum API level 21, however the app itself has to be built with API level 25 or higher). After setting up an Android device you will be able to run automated end-to-end tests on Android apps.


Android devices can be controlled either over API by SuitestDrive or over Infrared (only TVs) by CandyBox or SoloCandy.

In order to use SuitestDrive, you need to pair it with your Suitest account first.

CandyBox can be ordered through your account. If you would like to get a SoloCandy, please contact our sales team.

Minimum requirements

  • OS Android version 5+ on your device
  • Apps must be built with at least API level 25

Enable developer mode and ADB / USB debugging

On your Android device make sure the following are enabled:

  • Developer mode
  • ADB debugging
  • USB debugging
  • Apps from Unknown Sources

example for Amazon Fire TV devices

  • all the settings necessary are located under Settings / My Fire TV / Developer options.

Adjust manufacturer specific configurations

Xiaomi mobile devices
  1. Go to Settings -> Additional Settings -> Developer options.
  2. Turn off "MIUI optimization".
  3. Restart your mobile device.

If you still have issues with Xiaomi device, check the troubleshooting section.

Locate the IP address of your Android device

Static IP address

To prevent connection failures due to the device IP address changes you should consider configuring your DHCP server to assign static IP address to your device.

Android TV and Amazon Fire TV

The current IP address is usually displayed on the Network status page of the device. Go to Settings > About > Network and look for the IP address. The location may vary from device to device.

Android mobile

The current IP address is usually displayed under Wi-Fi settings of your mobile device.

On Xiaomi devices, please go to Settings -> Wi-Fi -> Additional settings.

Add an Android device without infrared control (controlled over API)

Allow debug mode

When connecting to the device for the first time the device may popup a message asking you to allow the debug mode. Be sure to allow it or else the device will refuse connection from Suitest.

  1. Open the Device wizard
  2. Select Add physical device
  3. Choose Android TV or Android mobile (based on your device) from the platform list and click Next
  4. Fill-in all the fields and click Next (Suitest will verify that it can connect to your device)

Android TV device details

The rest of the process will complete automatically. After this, the Android device will become available in your Suitest account. Suitest will automatically determine the name of the device. You'll be able to change it later on the device management page.

Now that you have your Android TV device configured, it's time to instrument your app and start testing.

Add an Android TV or Amazon Fire TV device with infrared control

Not valid for Android mobile devices

To control an Android TV via infrared, it will need to be added as the Only configure device control platform. Follow the Adding any Smart TV or set-top box to Suitest section.

Once the device is added, find the device inside of Devices and click on the device to open its details. Switch to the Settings tab.

Add platform button in device details

To add the Android TV platform to the device, press the Add platform button.

The device needs to be disabled before the new platform can be configured. Suitest will ask to disable the device if necessary.

Disable device confirmation dialog

Now, choose Android TV from the platform list and then press Next.

Android TV device details

On the next screen fill in all the fields and press Next. Suitest will verify that it can connect to your device.

Allow debug mode

When connecting to the device for the first time the device may popup a message asking you to allow the debug mode. Be sure to allow it or else the device will refuse connection from Suitest.

The rest of the process will complete automatically. After this the Android TV platform will be available for this device.

Now that you have your Android TV device configured, it's time to instrument your app and start testing.

Add the Android TV platform to a HbbTV / Freeview Play device

This method will use infrared for controlling the Android TV. If you want to use ADB to control the Android TV, then follow Add an Android TV device without infrared control and add the HbbTV / Freeview Play platform to the device.

Firstly, make sure that your device is added using the HbbTV / Freeview Play platform. Then, find the device inside of Devices and click on the device to open its details. Switch to the Settings tab.

Add platform button in device details

To add the Android TV platform to the device, press the Add platform button.

The device needs to be disabled before the new platform can be configured. Suitest will ask to disable the device if necessary.

Disable device confirmation dialog

Now, choose Android TV from the platform list and then press Next.

Android TV device details

On the next screen fill in all the fields and press Next. Suitest will verify that it can connect to your device.

Allow debug mode

When connecting to the device for the first time the device may popup a message asking you to allow the debug mode. Be sure to allow it or else the device will refuse connection from Suitest.

The rest of the process will complete automatically. After this the Android TV platform will be available for this device.

Now that you have your Android TV device configured, it's time to instrument your app and start testing.

Something went wrong?

Please check the Android troubleshooting section for guidance.