Get Started

1.1.Sign up

Go to the https://console.wetest.net/, complete the sign up process.

1.2.Log in the UDT Platform

(1)Go to UDT website：
https://udt.wetest.net/home
(2)Click login to complete the login process.

1.3.Create a project

Before using the service, you need to choose which project to enter. If this is your first time using the platform, you will need to create a project.
(1)Create a project
step1: Click New Project.

step2: Fill in the information, and create the project.

(2)Choose Project
Click on the project name to enter the use.

(3)Demo Project
If you need some trial devices to test, pleaser provide your WeTest Login Account to us. We will invite you into our demo project.

Note: Please create a new project before connecting your local device (the UDT Demo project only provides our devices for trial purposes).

1.4.Device Connection

We provide a device connection tool called UDT Desktop which can help you connect local devices in batches to UDT smoothly, start Debugging and conduct Auto-Testing.
1.4.1.Download UDT Desktop
Contact your sales to obtain the latest version of UDT Desktop.
- 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.
  

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

1.4.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.
  Note：Install iTunes in advance for connecting an iOS device via a Windows OS.

Step 1: 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.

If the device is installed with iOS <15.0, the screen mirroring will be restricted, and the screen mirroring component needs to be re-signed as instructed below:

• Get the working directory using the following method:
  
  
• Find the following files in the {working directory}/assistd-v* directory:
  ○ resources/scrcpy-v*_dev_sign.ipa
  ○ resources/wda-v*_dev_sign.ipa
  
• re-sign the component and overwrite the existing file using your developer account, and restart the client.
  1.4.4.Desktop Configuration
  Step 1: Import Project Information
  In the Desktop, select the target project to automatically pull and fill in the information of the project.
  
  Step 2:Setup Configuration
  Select an assistd start mode
• Real Device Mode: Select the Real Device mode to check the environment of the device and download the assistd file. After the device is successfully connected and click check, the related capabilities of real device are available.
  
• Task mode: After the device is connected using the task mode, the related capabilities of real device and automated testing are available.
  (1) 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 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.
  (2) Select a test framework
  Choose the framework based on the test automation framework used in your automation script.
• UITrace, Airtest, and GAutomator frameworks are available for the macOS version.
• UITrace and Airtest frameworks are available for the Windows version.
  

PerfDog token (optional)
Configure the PerfDog token if it is available. After the token configuration, the performance data generated in the automation can be viewed in the report under the account with PerfDog access.

Step 3:Environment Check

• adb/pytest/pytest-json-report: Automatically detect and install
• Python exceptions (see FAQ 8 below), make sure to use Python v3.8-3.10. Check the version as follows:

dafenghuang@DAFENGHUANG-MB0 ~ % python3 -V
Python 3.9.4

Step 4:Assistd Check
Automatically detect and install the component; if it does not exist or there is a new version, the system will try to automatically download and decompress the new version to the local.
Step5: PerfDog Check
Automatically detect and install the component; if it does not exist or there is a new version, the system will try to automatically download and decompress the new version to the local.
Step6: Test Framework Check
Automatically detect the presence of the required framework based on the test automation framework you select.
Step7: Install required script dependencies
We use venv to solve the possible chaos of the local environment with Python 3. All of your scripts will run in the standalone Python environment generated by venv, so dependencies in your scripts need to be reinstalled in the venv-generated Python environment.

Step8: Check
When the environment is ready, click Check. After all items are successful, click Start.

If the device does not appear, click Refresh in the top right corner.

1.4.5.iOS17 Configuration
(1)PC
MAC: The macOS version must be 13.0 or later, and only the macOS Desktop mode is supported.
(2)Start
Update Desktop to 1.3.7 or later. For more information, contact us.
Note: The latest assistd version must be 1.4.0 or later.

After the software starts, the trust confirmation window pops up twice on your smartphone (for the first access and use only).