All Products
Search

This Product

    WUYING Terminal:Configure ADB devices

    Document Center

    WUYING Terminal:Configure ADB devices

    Last Updated:May 30, 2025

    To use ADB devices on cloud computers, administrators must configure the relevant peripheral policies as described in this topic.

    Preparations

    If you are using an Alibaba Cloud Workspace hardware terminal, you must first enable network ADB for ADB devices because Alibaba Cloud Workspace hardware terminals cannot connect to ADB devices over USB. Alibaba Cloud Workspace hardware terminals can connect to ADB devices only over networks.

    Windows client/macOS client

    When you use cloud computers from a Windows client or macOS client, administrators and end users must configure peripheral access by following the following steps.

    Configure peripheral policies as an end user

    Peripheral policies are included in cloud computer policies and need to be created and maintained by administrators in the console.

    General steps for creating or modifying peripheral policies

    Create a custom policy and associate it with a cloud computer

    By default, newly created cloud computers are associated with a system-generated default policy. However, the default policy cannot be modified. Administrators need to create a custom cloud computer policy in the console and associate it with the cloud computers.

    1. Log on to the EDS Enterprise console.

    2. In the left-side navigation pane, choose Operation & Maintenance > Policies.

    3. On the Policies page, click Create Policy.

    4. On the Create Policy page, enter the Policy Name as prompted, modify the policy configuration as needed, and click OK.

      After the policy is created, you can view the new policy in the list on the Policies page.

    5. In the left-side navigation pane, choose Resources > Cloud Computers.

    6. On the Cloud Computers page, perform one of the following operations based on your business requirements:

      • Single operation: Find the target cloud computer, click the ⋮ icon in the Actions column, and then select Change Policy.

      • Batch operation: Select one or more cloud computers. At the bottom of the page, choose More > Change Policy.

    7. On the Required Policy tab of the Change Policy panel, click Change Policy, select the newly created custom policy, and click Confirm.

      Note

      If the resource group to which a cloud computer belongs is associated with a policy, you cannot directly replace the policy for the cloud computer. You can either replace the policy for the resource group or remove the cloud computer from the resource group and then replace the policy for the cloud computer.

    8. Click OK at the bottom of the Change Policy panel. In the message that appears, click OK.

    Modify a custom policy with which a cloud computer is associated

    If cloud computers are already associated with a custom policy, administrators can directly modify the policy in the console.

    1. Log on to the EDS Enterprise console.

    2. In the left-side navigation pane, choose Operation & Maintenance > Policies.

    3. On the Policies page, find the custom policy you want to modify, and click Change Policy in the Actions column.

    4. On the Modify Policy page, modify the policy configuration based on your business requirements, and click OK.

    Peripheral configuration instructions

    Enable device redirection for ADB devices

    • Configuration path: Peripheral Control > Peripheral Redirection > ADB.

    • Configuration requirements: Set the redirection mode for ADB devices to Device Redirection.

      item_adb_device_redirection

    What do I do if an on-premises device can detect an ADB device but my cloud computer cannot detect it?

    Problem description

    What do I do if an on-premises device can detect an ADB device but my cloud computer cannot detect it?

    Cause

    You have not configured ADB environment variables on the cloud computer.

    Solution

    Perform the following steps on the cloud computer to configure environment variables:

    1. Go to Start and search for environment variables. Then click Edit the system environment variables from the search result.

    2. Add the ANDROID_HOME variable.

      1. In the System Properties dialog box, click the Advanced tab and then click Environment Variables.

      2. In the Environment Variables dialog box, click New in the lower part of the System variables section.

      3. In the New System Variable dialog box, specify the variable name and variable value and click OK.

        The variable name is ANDROID_HOME, and the variable value is the path to adb.exe, such as D:\platform-tools.

    3. Modify the Path variable.

      1. In the System variables section of the Environment Variables dialog box, select the Path variable and click Edit.

      2. In the Edit environment variable dialog box, click New, enter %ANDROID_HOME% in the blank row, and then click OK.

    4. Optional. Verify that the environment variables are added. Open Command Prompt on the cloud computer and run the adb command. If an ADB version number is returned in the command output, the environment variables are added.

    Troubleshooting