Skip to main content

Device Farm

This tutorial explains how to set up a device farm.

Prerequisites

The following items are required to run the tests:

  1. A desktop or laptop running Windows or Mac operating system.
  2. An Android or iOS device.
  3. USB hub and data transfer cable.
info

iOS devices can only be used with Mac operating systems.

Building Infrastructure

In Dogu, there are two main components: Host and Device. The Host serves as a hub to apply tests to multiple devices. The Device refers to the actual physical devices where the tests are executed. To connect the Host and the Devices, please physically connect the actual devices to the Host.

tip

The Host can also be used as a Device. For more information, refer to the Host Management documentation.

This document describes the process based on one host and one device.

Device configuration

To optimize the use of the device, please read the Device Configuration document and make the necessary changes to the device settings.

Connect device

  1. Prepare the configured device.
  2. Physically connect the Android device to the host using a data transfer cable or hub that allows data transfer.

Add host

Prerequisites
  1. Please refer to the Agent Installation page for the recommended specifications of the host.
  1. Click on the "Hosts" menu in the left sidebar within the organization section of the console.
  2. Click on the "Add new host" button, enter the host name, and complete the creation process.
  3. Copy the host token that you have received, then paste the copied token into the token input field in Dogu Agent to complete the connection.
  4. Once the connection status of the created host in the console shows "Connected," the host registration is complete.
info

For detailed information about Dogu Agent and the host, please refer to the Host documentation.


If you are experiencing any issues during the process of adding a host, please refer to the Host Troubleshooting document for assistance.

Add device

To build a device farm, add devices and group them using tags. The added devices can perform tasks such as test execution and remote control.

info

This document explains how to add Android devices.
For iOS devices, additional configuration is required in Dogu Agent. Please refer to the iOS Setting documentation for more details.

Use device

  1. Click on the "Devices" menu in the left sidebar within the organization section of the console, and then click on the "Standby devices" tab.
  2. Click on the menu button(···) of the device you want to use, and then click on the "Start using" option.
  3. Select the project in which you want to use the device, and then complete the addition process.
  4. Click on the "In-use devices" tab to check if the device has been successfully added.
Permissions and Public Devices

The Dogu console has the organization-level permission feature. Utilize the permission feature to freely designate members who can access test results or devices.

For public devices, all members or all projects have access to the devices (including streaming, remote control, and test execution).

For more information about the permission feature, please refer to the Permission system documentation.

info

For more detailed information about adding devices and related management tasks, please refer to the Organization Device Management documentation.


If you encounter any issues during the process of adding devices, please refer to the Device Troubleshooting document for assistance.

Attach device tag

You can group devices using device tags and execute tests on them.

Default tag

By default, devices are assigned platform tags based on their device platform when they are used.

  1. Click on the "Devices" menu in the left sidebar within the organization section of the console.
  2. Click on the menu button(···) of the device to which you want to add tags, and then click on the "Edit tags" option.
  3. Enter the desired tag name and click on the "Add" button to create the tag.
  4. Close the modal and check if the tag has been added to the device.
info

For more detailed information about device tags and their management within the organization, please refer to the Organization Device Tag Management documentation.

Start device streaming

The added devices can be used for streaming or remote control functionalities.

  1. Click on the "Devices" menu in the left sidebar within the organization section of the console.
  2. Click on the menu button(···) of the device to which you want to stream or control remotely, and then click on the "Streaming" option.
  3. Device streaming has started. You can click on the screen or drag to remotely control the device.

Wrap up

Device farm setup has been completed. Now, the added devices can be managed from the Dogu console.

Utilize features such as real-time device screen streaming, remote control, device tagging, and device project allocation to efficiently manage devices within the organization.