Configuring your Android devices in Zoho QEngine | Zoho QEngine Help

Configuring your Android device in Zoho QEngine

 1. Overview

To test mobile applications on your desired mobile devices, it is necessary to install the agent and link your devices. Testing can be conducted using either your real or virtual devices. Zoho QEngine uses the aid of Android Studio to facilitate for your Android devices, allowing you to perform testing effectively. This document is aimed to help you through the configuration and setup required to establish a connection between real or virtual devices to the Agent.

2. Prerequisites    

2.1. System Requirements

For the best experience, you should use Android Studio on a computer with at least the following specs:

 

  • 16 GB RAM

  • 64-bit Windows, macOS, Linux, or ChromeOS operating system

  • 16 GB disk space

2.2. Download and Install Android Studio 

Notes
Note: The exact steps might vary slightly depending on the make and model of your Android device, as well as the version of the Android operating system it is running. Here, we have illustrated the steps for macOS.

Follow the steps below to install Android Studio:

 

  1. Follow the instructions provided on the website to download and install Android Studio.
  2. Check the system requirements and install the right file for your machine:
  3. After installation, launch the application to ensure a successful setup.

3. Connect your Real Device with the Agent  

Let's create a connection between your Android device and the Agent. Follow the steps below, to get started.
 
NotesNote: For demonstration, we have used a OnePlus Nord device running Android version 12. Here, the UI may vary depending on the device you are using.
 

Step 1: Download and Install Android Studio

 

  1. Follow the instructions provided on the website to download and install Android Studio.
  2. Check the system requirements and install the right file for your machine:
  3. After installation, launch the application to ensure a successful setup.
 

Step 2: Enable Developer options on the device

 

  1. Open the Settings app on your device.

  2. Navigate to the About phone or About device option.



  3. Inside the About device option, tap on Build number seven times in quick succession. You will likely be prompted to enter your device's unlock code or PIN.

  1. After tapping the build number seven times, you should see a message indicating that "Developer options" are enabled.

 

  1. Go back to the main Settings menu, and you should now see a new option called "Developer options" or "System" with "Developer options" within it.

 

Step 3: Enable USB debugging

 

  1. Once Developer options are enabled, in its menu, look for the USB debugging option.

  1. Toggle the switch next to "USB debugging" to enable it. When you enable USB debugging for the first time, you may see a prompt asking you to confirm your action. Select "OK" or "Allow" to proceed.

  1. Use a USB cable to connect your Android device to the computer.

 

  1. After connecting your device to the computer, you may see a notification on your device's screen regarding the USB connection. Select "Transfer files" or "File transfer" mode. This step is essential for allowing data transfer between the device and the computer.

  1. Check the RSA fingerprint displayed on your Android device and make sure it matches the fingerprint of your computer. If the fingerprints match, check the " Always allow from this computer" checkbox and tap Allow to confirm.

 

Step 4: Enable Stay Awake Option (Optional)

 

  1. Within the Developer options menu, look for the "Stay awake" or "Keep screen on while charging" option.

  1. Toggle the switch next to "Stay awake" or "Keep screen on while charging" to enable this option.

 


Notes
Note: For optimal testing experience, it's recommended to enable the "Stay awake" option.

4. Connect your Virtual Device with the Agent 

For mobile emulators, you can create or choose your desired virtual device using Android Studio. Follow the steps below to setup your own emulator:
 

Step 1: Download and Install Android Studio

 

  1. Follow the instructions provided on the website to download and install Android Studio.

  2. Check the system requirements and install the right file for your machine:

  3. After installation, launch the application to ensure a successful setup.

 

 

Step 2: Install the required SDK developer tools 

  1. Open Android Studio and click on More Actions inside the Welcome page.

  1. Navigate to SDK Manager.

  1. Under the Android SDK section, select "SDK Tools."

Ensure that Android Emulator and Android SDK Platform - Tools are installed. If not, check the boxes and click Apply.

  1. Confirm the changes by clicking OK.

 

Step 3: Setup Virtual Devices

  1. Navigate back to More Actions and select Virtual Device Manager.



  2. Click Create Device.



  3. Choose a device from the Phone category and click Next.



  4. Select the preferred Android version for your device.



  5. Finally, verify the device configuration and setup, then click Finish.

 

Notes
Note: Try to use the recommended Android versions for your preferred devices. Don't try to change any of the default configurations, as this may affect the setup.
  1. After a few minutes, start/restart your Agent. The connected devices will be listed under Devices inside your Agent. To verify, navigate to Agents within the settings of the project where it is configured or check About Agent by clicking on the icon in the system tray.

 

Now, that you've configured your desired devices with Zoho QEngine, you can easily run and preview your test cases. 

5.  Related Links