AI 助理
文档备案控制台
官方文档
首页

配置ADB调试设备

更新时间：
复制 MD 格式
产品详情
我的收藏

如需在云电脑中正常使用ADB调试设备，请管理员按照本文说明配置相关外设策略。

准备工作

如果使用的是无影硬件终端，则必须先为ADB设备启用网络ADB，因为无影硬件终端不支持通过USB方式连接ADB设备，只支持通过网络连接。

无影硬件终端

通过无影硬件终端（例如无影魔方、无影魔方Pro、无影一体机23.8等）使用云电脑时，请管理员和终端用户按照以下步骤配置外设接入。

管理员配置外设策略

外设管控策略包含在云电脑策略中，需要由管理员在控制台上创建和维护。

说明

下文以无影云电脑企业版控制台为例。关于商业版的具体操作步骤，请参见管理策略。

新建或修改外设策略的通用操作步骤

新建自定义策略并绑定至云电脑

默认情况下，创建好的云电脑会绑定系统自动生成的默认策略，但默认策略无法修改，需要由管理员在控制台上创建一条自定义云电脑策略，并为云电脑绑定该策略。

  1. 登录无影云电脑企业版控制台。

  2. 在左侧导航栏，选择运维管理>策略。

  3. 在策略页面上单击创建策略。

  4. 在创建策略页面上按照页面提示填写策略名称，根据需要修改策略配置，并单击确定。

    策略创建完成后，可前往策略页面的列表中查看新建的策略。

  5. 在左侧导航栏，选择资源管理>云电脑企业版。

  6. 在云电脑企业版页面上，按需选择以下一种操作：

    • 单一操作：找到目标云电脑，在操作列中单击更多，然后选择更改策略。

    • 批量操作：选择一台或多台云电脑，在页面底部选择更多>更改策略。

  7. 在更改策略面板的必选策略页签上单击更改策略，然后选择新建的自定义策略，并单击确定。

    说明

    如果云电脑所属的资源组已有关联策略，则无法在此处直接更换云电脑的关联策略。您可以直接更换资源组的关联策略，或者先将云电脑移出资源组再更换云电脑的关联策略。

  8. 在更改策略面板底部单击确定，并单击确认修改策略。

修改已绑定云电脑的自定义策略

如果云电脑已经绑定自定义策略，则管理员可以在控制台直接修改该策略，无需重新绑定。

  1. 登录无影云电脑企业版控制台。

  2. 在左侧导航栏，选择运维管理>策略。

  3. 在策略页面上找到要修改配置的自定义策略，并在操作列单击修改策略。

  4. 在修改策略页面上按需修改策略配置，并单击确定。

外设配置说明

说明

无影硬件终端不支持通过USB方式连接ADB设备，只支持通过网络连接，因此需要由管理员配置网络重定向来连通云电脑和手机的网络。

开启ADB调试设备的设备重定向

  • 配置项位置：外设管控 > 外设重定向 > ADB。

  • 配置要求：将ADB的重定向类型设置为设备重定向。

    item_adb_device_redirection

端侧配置

确保无影硬件终端网络和ADB设备网络保持一致。以oppo手机为例（其他手机类似，如无法配置需联系无影人员处理），打开设置 > 开发者选项 > 无线调试。

  1. 查看无影硬件终端的网络IP和手机"无线调试"的IP在同一个网段。

    • 打开无影硬件终端设置 > 网络，选择该网络 > 网络属性，找到对应的IPv4地址。

    • 打开手机设置 > 开发者选项 > 无线调试，选择对应网络，查看IP地址和端口。

  2. 打开手机无线调试，点击使用配对码配对设备。

    image.jpeg

  3. 在云电脑中配置好ADB环境后（参考下方Windows镜像或Linux镜像配置说明），执行配对命令。

    adb pair <手机IP>:<配对端口>
# 示例：adb pair 10.1.30.130:37659
# IP和端口与手机"使用配对码配对设备"中显示的信息一致

  4. 配对成功后，与设备进行连接。连接的IP和端口是手机"无线调试"页面中显示的"IP地址与端口"信息。

    adb connect <手机IP>:<连接端口>
# 示例：adb connect 10.1.30.130:35287
# IP和端口与手机"IP地址与端口"中显示的信息一致

  5. 验证连接是否成功。

    adb devices

Windows客户端/macOS客户端

通过Windows客户端/macOS客户端使用云电脑时，请管理员和终端用户按照以下步骤配置外设接入。

管理员配置外设策略

外设管控策略包含在云电脑策略中，需要由管理员在控制台上创建和维护。

说明

下文以无影云电脑企业版控制台为例。关于商业版的具体操作步骤，请参见管理策略。

新建或修改外设策略的通用操作步骤

新建自定义策略并绑定至云电脑

默认情况下，创建好的云电脑会绑定系统自动生成的默认策略，但默认策略无法修改，需要由管理员在控制台上创建一条自定义云电脑策略，并为云电脑绑定该策略。

  1. 登录无影云电脑企业版控制台。

  2. 在左侧导航栏，选择运维管理>策略。

  3. 在策略页面上单击创建策略。

  4. 在创建策略页面上按照页面提示填写策略名称，根据需要修改策略配置，并单击确定。

    策略创建完成后，可前往策略页面的列表中查看新建的策略。

  5. 在左侧导航栏，选择资源管理>云电脑企业版。

  6. 在云电脑企业版页面上，按需选择以下一种操作：

    • 单一操作：找到目标云电脑，在操作列中单击更多，然后选择更改策略。

    • 批量操作：选择一台或多台云电脑，在页面底部选择更多>更改策略。

  7. 在更改策略面板的必选策略页签上单击更改策略，然后选择新建的自定义策略，并单击确定。

    说明

    如果云电脑所属的资源组已有关联策略，则无法在此处直接更换云电脑的关联策略。您可以直接更换资源组的关联策略，或者先将云电脑移出资源组再更换云电脑的关联策略。

  8. 在更改策略面板底部单击确定，并单击确认修改策略。

修改已绑定云电脑的自定义策略

如果云电脑已经绑定自定义策略，则管理员可以在控制台直接修改该策略，无需重新绑定。

  1. 登录无影云电脑企业版控制台。

  2. 在左侧导航栏，选择运维管理>策略。

  3. 在策略页面上找到要修改配置的自定义策略，并在操作列单击修改策略。

  4. 在修改策略页面上按需修改策略配置，并单击确定。

外设配置说明

开启ADB调试设备的设备重定向

  • 配置项位置：外设管控 > 外设重定向 > ADB。

  • 配置要求：将ADB的重定向类型设置为设备重定向。

    item_adb_device_redirection

端侧配置

在端（本地设备）和云电脑上配置ADB环境变量，使ADB命令可用。根据端和云电脑的操作系统，选择对应的配置方式。

Windows本地（客户端）

  1. 在开始菜单中搜索关键字环境变量，并在搜索结果中单击编辑系统环境变量。

  2. 添加ANDROID_HOME变量。

    1. 在系统属性对话框中，单击高级页签，并单击环境变量。

    2. 在环境变量对话框的系统变量区域底部，单击新建。

    3. 在新建系统变量对话框中，输入变量名ANDROID_HOME，变量值为adb.exe所在的目录路径（例如D:\platform-tools），并单击确定。

  3. 修改Path变量。

    1. 在环境变量对话框的系统变量区域，找到并选中名为Path的变量，并单击编辑。

    2. 在编辑环境变量对话框中，单击新建，然后在空白行输入%ANDROID_HOME%，并单击确定。

  4. 验证环境变量是否添加成功。打开命令提示符应用（CMD），执行命令adb。若返回ADB版本号，则说明环境变量添加成功。

macOS本地（客户端）

先确认当前Shell类型：打开终端，执行echo $0，根据输出结果（-zsh或-bash）选择对应的配置文件。

  • zsh（默认Shell）：配置文件为~/.zshrc或/etc/zshrc

  • bash：配置文件为~/.bashrc或/etc/profile

  1. 打开对应的配置文件。

  2. 添加以下环境变量，将路径替换为实际的ADB工具所在目录。

    # Android ADB 配置
export ANDROID_HOME=/Users/xxxx/Downloads/platform-tools
export PATH=$PATH:$ANDROID_HOME

  3. 执行以下命令使配置生效。

    # zsh 用户
source ~/.zshrc

# bash 用户
source ~/.bashrc

  4. 验证环境变量是否添加成功。打开终端应用（Terminal），执行命令adb。若返回ADB版本号，则说明环境变量添加成功。

Windows镜像（云电脑）

  1. 在开始菜单中搜索关键字环境变量，并在搜索结果中单击编辑系统环境变量。

  2. 添加ANDROID_HOME变量。

    1. 在系统属性对话框中，单击高级页签，并单击环境变量。

    2. 在环境变量对话框的系统变量区域底部，单击新建。

    3. 在新建系统变量对话框中，输入变量名ANDROID_HOME，变量值为adb.exe所在的目录路径（例如D:\platform-tools），并单击确定。

  3. 修改Path变量。

    1. 在环境变量对话框的系统变量区域，找到并选中名为Path的变量，并单击编辑。

    2. 在编辑环境变量对话框中，单击新建，然后在空白行输入%ANDROID_HOME%，并单击确定。

  4. 验证环境变量是否添加成功。打开命令提示符应用（CMD），执行命令adb。若返回ADB版本号，则说明环境变量添加成功。

Linux镜像（云电脑）

  1. 打开配置文件（例如~/.bashrc或/etc/profile）。

  2. 添加以下环境变量，将路径替换为实际的ADB工具所在目录。

    # Android ADB 环境变量
export ANDROID_HOME=/opt/platform-tools
export PATH=$PATH:$ANDROID_HOME

  3. 执行source ~/.bashrc使配置生效。

  4. 验证环境变量是否添加成功。打开终端，执行命令adb。若返回ADB版本号，则说明环境变量添加成功。

本地设备能识别到ADB设备，但云电脑识别不到，怎么办？

问题现象：运行云电脑的本地设备能识别到ADB设备，但云电脑识别不到这些设备。

可能原因：

  • 端或云电脑上没有配置ADB环境变量。

  • 管控台未开启ADB功能。

解决方案：

  • 根据端和云电脑的操作系统，参考上方端侧配置完成ADB环境变量配置。

  • 检查管控台中外设策略是否已启用ADB设备重定向，参考上方管理员配置外设策略。

解决问题

上一篇：配置网卡设备下一篇：配置高拍仪