All Products
Search
Document Center

Mobile Testing:Remote debugging

Last Updated:Mar 16, 2022

Prerequisites

  • A resource plan for remote device debugging is purchased, or your resource usage does not exceed the free quota. For more information, see Pricing.

  • Optional. An Android app that you want to debug is uploaded. For information about how to upload an app, see Upload an app.

  • You are logged on to the Mobile Testing console. For more information, see Go to the Mobile Testing console page.

Apply for a remote device

  1. In the left-side navigation pane of the Mobile Testing console, click Testing Services and click Remote Device Debugging to view remote devices.

  2. Select a remote device on which you want to perform remote debugging.

    • Enter keywords in the search box to search for remote devices of the specified brand or model.

    • Click Show Filter to show filter conditions for remote devices. You can specify one or more conditions to filter the remote devices that meet the specified conditions.

Note

The filter conditions include Brand, Android Version, iOS Version, Resolution, and Time to Market.

3. In the remote device list, move the pointer over a device that you want to use and click Use Now. The Remote Device Debugging page appears.

Note

Root permissions are disabled for all Android remote devices.

Remote Device Debugging

Description for remote device debugging

A remote device can be used to simulate the basic operations on a device on web pages.

No.

Icon

Control

Description

1

System settings toolbar

Terminal type

The brand and model of a remote device.

Duration

  • The duration that you have used within your free quota or within your resource plan.

  • The remaining duration of your free quota or your resource plan.

High

Switches between high definition and standard definition.

Enter Install Password (Oppo/Vivo)

When you use Android Debug Bridge (adb) to connect remote devices to perform remote debugging, some remote devices must be verified before you log on to them. In this case, click the Enter Install Password (Oppo/Vivo) icon.

Lock Screen

Locks the screen of a remote device.

Rotate Screen

Switches between the landscape mode and the portrait mode.

Obtain the device clipboard content

Copies the content in the clipboard of a remote device to the Mobile Testing console.

Shortcut keyboard

The window for shortcut inputs. You can enter letters, digits, Chinese characters, and common special characters. Common special characters are , . ; ? !

Go to App Management

Navigates to the App Management page.

2

Full screen icon

-

Shows a remote device in full screen mode after you click Full Screen.

3

System icons

-

Simulate three system icons of an Android mobile phone.

4

Page adjustment slider

-

Controls the window size of a terminal simulator.

Install an app

  1. After you go to the Remote Device Debugging page of the remote device, the Apps tab appears.

  2. Search for the app that you want to debug.

    • If the app that you want to debug is uploaded, click Uploaded or Installed to filter apps.

    • Then, enter a keyword in the search box to search for the app by name. Fuzzy matching is supported.

  3. Upload the app that you want to debug. If the app that you want to debug is not uploaded, click Upload App to upload the app. For more information about how to upload an app, see Upload an app.

  4. Install the app that you want to debug. If the app is uploaded but not installed, click Installation in the Actions column to install the app on the remote device.

28E20872-00C2-4BD2-90F8-480EA5BA5ED4

View logs

1. On the Remote Device Debugging page of the remote device, click the Logs tab.

2. On the Logs tab, turn on the logging switch to start recording the logs of the device.

3. Select a level from the Select Level drop-down list to show logs of the specified level.

4. Enter a keyword in the Search by keyword search box to search for log information. Fuzzy matching is supported.

5. Turn on Scroll to scroll through the latest log entries in the log list.

6. Click Download Logs to download log information as a text file to your on-premises machine.

7. Click Clear Logs to clear the log list.

Logs tab

Take screenshots or record your screen

Go to the Screenshots tab

1. On the Remote Device Debugging page of the remote device, click the Screenshots tab.

2. On the Screenshots tab, the Screenshots and Recordings subtabs are available.

3. Click the Screenshots subtab to view screenshots and take screenshots. Click the Recordings subtab to view recordings and record the screen.

4. Click the Large Image or Small Image icon to switch the display mode of the screenshots or recordings.

Screenshots and Recordings Take screenshots

1. Click the Screenshots subtab.

2. In the left-side window, perform operations on the app that is installed on the remote device.

3. Click the Click to Take Screenshot action button to take a screenshot of the interface of the device. The screenshot that you take is displayed on the Screenshots subtab.

Screenshots Record your screen

1. Click the Recordings subtab.

2. Click the Start Screen Recording action button to start screen recording. After you click the Start Screen Recording action button, the Start Screen Recording action button changes to the Stop Screen Recording action button.

3. In the left-side window, perform operations on the app that is installed on the remote device.

4. Click the Stop Screen Recording action button to stop screen recording. The recording is displayed on the Recordings subtab.

Recordings

Edit screenshots or recordings

1. Move the pointer over screenshots or recordings and select the corresponding check boxes. You can also click All to select all screenshots or recordings.

2. Select one or more screenshots or recordings and click the delete icon to delete the screenshots or recordings.

Edit screenshots or recordings

Upload a file

1. On the Remote Device Debugging page of the remote device, click the Files tab.

2. In the Quick Access field, enter a complete path of a specified directory.

3. Click the upload section to select a file or drag the file to the upload section to upload the file to the specified directory.

Note

The size of a file that you want to upload must be smaller than 256 MB.

Files tab
Note

You cannot create or manage a directory.

Configure remote debugging

Before you configure remote debugging, make sure that the adb debugging tool is installed on your on-premises machine.

1. On the Remote Device Debugging page of the remote device, click More, and then click ADB in the drop-down list. The ADB tab appears.

2. On the ADB tab, click Start ADB Debugging to generate the command for remote device debugging.

Use adb to perform debugging

3. Run the command for remote device debugging in the command line of the adb debugging tool.

4. Run the adb devices command to view devices. If the device is displayed in the list, start remote debugging.

5. After remote debugging is complete, run the adb disconnect command to close the connection.

Perform positioning tests

  1. On the Remote Device Debugging page of the remote device, click More, and then click Positioning in the drop-down list. The Positioning tab appears.

  2. In the left-side window, open the installed app that you want to test. For more information about how to install an app, see Install an app.
  3. Specify a location for which you want to search by using one of the following methods:

    1. Configure the Longitude and Latitude parameters. Then, click Determine.

    2. Enter a location for which you want to search in the Location search search box and press Enter on your keyboard.

    If the positioning succeeds, the "Virtual positioning succeeded" message appears.

    Note

    • You must enable the positioning feature for your remote device.

    • You must enable the positioning feature for your browser and allow the browser to locate a position.

    • You must make sure that you perform a positioning test by using the Internet. The map can only be displayed if you use the Internet.

    Positioning tab

Perform QR code scanning tests

  1. On the Remote Device Debugging page of the remote device, click More, and then click Scan code in the drop-down list. The Scan code tab appears.

  2. Click the upload section to select a file or drag the file to the upload section to upload the file to the specified directory.

    If the file is uploaded, the "File uploaded!" message appears.

  3. In the left-side window, open the installed app that you want to test. Use the QR code scanning feature of the app. For more information about how to install an app, see Install an app.

  4. Select album for QR code scanning.

  5. Specify a picture for which you want to perform a QR code scanning test in the album. Then, the system automatically scans the picture.

    Perform QR code scanning tests

Perform performance tests

1. On the Remote Device Debugging page of the remote device, click More, and then click Performance Test in the drop-down list. The Performance Test tab appears.

2. Select an app that you want to test from the app drop-down list.

3. Select a process that you want to test from the process drop-down list. By default, Master Process is selected.

4. Click the Start a test icon to start plotting the performance data of the specified process of the specified app. After you click the Start a test icon, the icon is changed to the Stop a test icon.

5. In the left-side window, perform operations on the app and view the changes in the plotted data.

6. Click the Save results icon. In the Save to Use Case panel, enter a task name in the Task Name field, select a directory and a use case to which you want to save the results, and then click OK.

Save results to a use case
Note

You must configure a directory and a use case before you save results. If no directory or use case is configured, click Create Use Case or Create Directory to create a use case or a directory. The created directory and use case are displayed in Use Cases on the Performance Testing page. For more information, see Manage test cases.

7. Click the Stop a test icon to finish plotting performance data.

8. Click the Clear data icon to clear the data.Performance tests

For information about a performance test report and the description of the corresponding data, see View a test report.