Page tree
Skip to end of metadata
Go to start of metadata

Remote debugging allows testers and developers to connect to remote devices, directly to their local PC/MAC machines. This tutorial guides you on how to get started with remote debugging on iOS and Windows. 

This table details the remote debugging capabilities based on the mobile/desktop OS.

Desktop OSMobile OS
MAC OSiOS \ Android


  • Remote debugging on iOS is enabled only when connecting from a macOS machine. Make sure the SeeTest Remote Debugging CLI and Xcode is installed.
  • When working from macOS machines, Xcode must be closed when initiating the Remote Debugging session. Otherwise Xcode will not identify the device.
  • It is not recommended to use remote debugging on devices connected to DHM's with latency greater than ~50ms (round trip).

To enable remote debugging:

  1. Open a device. To learn how to open a device, see Mobile Devices.
  2. Click Tools → Remote Debugging. The Remote Debugging dialog appears. The dialog contains all the information to get started with CLI tool.
  3. Click Download. 

  4. Install the tool.
    • For the Mac OS, double-click the downloaded file, then click OK.

      Warning for MAC OS

      If you get a malicious software warning, click System Preferences → Security & Privacy -> General, then click Open Anyway.

      never remind me again

    • For Windows, open the zip file, then open command line session.

      Note:  If your network is behind a proxy, see Configure Proxy for Remote Debugging.

  5. In a command line, run cd <SeeTestRemoteDebugging_folder>.

  6. Copy the text to the clipboard from the Remote Debugging window.
  7.  Paste it into the terminal and enter to start the debugging session.  Once the session is up, the Debugging icon turns red ().
    You can now start debugging.

To debug using Xcode:

  1. Make sure Xcode is closed.
  2. Start a debugging session.
  3. Open Xcode.

  4. Click Window -> Devices and Simulators.

  5. Wait for Xcode to finish making the device ready for development.

To debug using Android Studio:

  1. Open Android Studio.
  2. Wait a few seconds for Android Studio to fully load.

  3. Choose your device as a target.

  4. Run your application.

  • No labels