Device Connection

We provide a device connection tool called UDT Desktop which can help you connect local devices in batches to UDT smoothly, start Remote Debugging and conduct Auto-Testing easily.
1. Download UDT Desktop
Contact your sales to obtain the latest version of UDT Desktop pro.

- MAC
Please confirm in advance that you have selected the “Mac App Store and identified developers” or “Anywhere” in System Preferences -> Security & Privacy. Otherwise, the tool can’t be started.

Drag the tool to the Applications folder to open it later.

- Windows
After decompression, directly double-click udt-desktop.exe.

2. Login
(1)Select OAuth Login method
(2)Enter the site: https://udt.wetest.net
(3)Click One- click Login and finish the login process.

(4)Select the Work directory (set up on first use):
This is where the desktop tool stores downloaded basic components, cache, logs, etc. Note:
○ No spaces in the selected directory.
○ No two or more “udt_desktop_work” directories within the work directory.

3. Connect and configure devices

• Android
  To connect and register an Android device, configure the device in advance to ensure smooth connection later.
  Note: Enable the developer mode and USB debugging before device connection.

• iOS
  To connect and register an iOS device, configure the device in advance to ensure smooth connection later. iOS device version support: Below iOS 17.0 and iOS 17.4 and above.
  Note：Install iTunes in advance for connecting an iOS device via a Windows OS.

Step 1: Version Upgrade
If your iOS version is between 17.0 and 17.3, please upgrade it to version 17.4 or above.

Step 2: Device trust
(1)Remove the screen lock of the device to facilitate subsequent steps.
(2)If the “Trust” pop-up window appears after you connecting the device via USB, click Allow.
Note：If the device is installed with iOS v16.0 or higher, you need to manually enable the developer mode in Settings -> Security & Privacy -> Developer Mode (restart the device as prompted after enabling).

If the toggle does not appear, unplug and plug the device again and connect it to Desktop. Desktop will automatically restart it.

Step 2: Install UDT components
If the device is installed with iOS v15.0 or later, select Settings -> General -> VPN & Device Management -> Enterprise Signature APP -> scrcpy, and click Trust.

After the component runs properly, the phone will prompt “Automation Running”, as follows:

Note：If you don’t want to access Desktop later, click “scrcpy” and “WebDriverAge…” on the desktop, go to the Recent APP tasks page, and manuallyshutdown it. After that, the “Automation Running” prompt will disappear.

4. Desktop Configuration
Step 1: Select Project
In the Desktop, select the target project to automatically pull and fill in the information of the project.

Step 2: Select type of Accessible Devices

• Mobile Device: Supports the access of Android/iOS devices.
• PC Device: The access of PC devices is currently only in internal testing. If you have requirements such as PC device access, remote debugging, or automation of PC applications, please contact us.
  

Note: Installation of iOS Plug-in for iOS 17+ devices
The UDT desktop extensions provides plug-ins that facilitates the access and management of iOS devices. If you need to access an iOS 17+ device, please click to install the Tunneld3 plug-in and launch it.

Step 3: Select the Task Mode

• Real Device Mode: After the device is successfully connected, relevant functions of the remote debugging can be used.
• Task Mode: After the device is successfully connected, the related capabilities of real device and automated testing are available.

(1) Real Device Mode:
Select the Real Device mode. Click the [Check] button, and the desktop will conduct an environmental check of the device and download the assistd file. Once the check passes, click [Start].

Once the device is successfully connected, you can click the [Start Debugging] button to start debugging immediately.

Within the UDT platform, the corresponding device can also be viewed and started.

(2) Task Mode:
Select the Python environment, Automation Testing frameworks, and Performance Data Collection options, then click [Check].

• Select a local Python version
  To enable the task mode, you need to have at least one version of Python locally.
  • For the Python environment, Python v3.8-3.10 is required, with Python v3.8 recommended for macOS. Download link: https://www.python.org/downloads/.
  • Environment Variables: Configure the Python installation path in the system environment variables.
  • Environment check: Enter python --version on the command line.
    Note：If you have installed Python of an earlier version, you need to restart Desktop after a new version of Python is installed to identify the latest version.

Select Automation Testing frameworks
Choose the framework based on the test automation framework used in your automation script.

Performance Data Collection (optional)
When the button is opened, the PerfDog service runs, supporting performance collection for automated tests. Also, if a custom token is filled in, it enables reporting of performance data to the PerfDog platform.

Click the [Check] button, and the desktop application will automatically conduct checks on the operating environment, testing framework, Assistd, and basic components. Once the checks are completed, click the [Start] button.

Once the device is successfully connected, you can click the [Start Debugging] button to start debugging immediately. Within the UDT platform, the corresponding device can also be viewed and started.