Remote debugging allows testers and developers to connect to remote devices, directly to their local PC/MAC machines. In this tutorial, we'll guide you on how to get started with remote debugging on iOS and Windows.
Note:
- Remote debugging on iOS is enabled only when connecting from a macOS machine. Please verify the SeeTest Remote Debugging CLI and Xcode is installed.
- When working from macOS machines, Xcode must be closed when initiating the Remote Debugging session or 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).
1. Open a device
In order to remotely debug a device, you'll first need to open a device.
The following table provides details remote debugging capabilities based on the mobile/desktop OS.
Desktop OS | Mobile OS |
---|---|
MAC OS | iOS \ Android |
Windows | Android |
To Open a device, please refer to Mobile Devices tutorial.
2. Download tool
Select Remote Debugging option under the Tools menu, opens Remote Debugging dialog as shown below. The dialog contains all the information to get started with CLI tool. You can download the CLI tool from the Download button(marked red in the picture).
3. Installing tool
For MAC OS, the downloaded file is an installer.
- Double click the downloaded file.
- Launch Remote Debugging installer.
For Windows, the download file is a zip file.
- Unzip the file
- Start a cmd session
Handling the warning for MAC OS
If you get a malicious software warning as shown above for iOS system, go to System Preferences > Security & Privacy > General tab and click Open Anyway.
Note: If your network is behind proxy follow these guideline: Configure Proxy for Remote Debugging
4. Starting a RDB session
- The first step to start a RDB session:
For MAC system:
cd <The location of the SeeTestRemoteDebugging folder>
for example: cd /Applications/SeeTestRemoteDebugging
For Windows - Depends on which directory the archive was unzipped:
cd <The location of the SeeTestRemoteDebugging folder>
for example: cd <User Downloads folder>\SeeTestRemoteDebugging
The subsequent steps are common for both Windows and MAC OS:
2. Copy the text to the clipboard from the Remote Debugging window
3. Paste it into the terminal and enter to start the RDB session
4. Once the session is up, the Debugging icon will turn red
5. Debugging an app on the remote device via Xcode
- Make sure Xcode is closed before starting the RDB session(step 2)
- Start RDB session
Open Xcode
Go to Window -> Devices and Simulators
Wait for Xcode to finish making the device ready for development
Now you are ready to debug your app on the remote device
6. Debugging an app on the remote device via Android Studio
You can also debug an app on remote device on Android Studio:
Open Android Studio
Give it few seconds to settle
Choose your device as a target
Run your App
Note:- We can't work with local android device in parallel to running RDB