首先需要确认两个前提条件：Android 调试桥（ADB）已正确安装，且 UEngine 网络连通正常。安装 ADB 非常简便，只需在终端中执行 `sudo apt install adb` 命令即可——如果系统提示“无法定位软件包”，请先运行 `sudo apt update` 更新软件源索引，再重新尝试安装。安装完成后，验证网络状态：输入 `ifconfig | grep uengine0` 查看是否有输出，若有输出则表明虚拟网卡已激活；接着执行 `ping -c 3 192.168.250.2`，确保三个 ICMP 包均能成功收到回复。上述两项验证均通过后，最后执行 `adb connect 192.168.250.2`，当终端显示 `connected` 字样时即表示 ADB 与 UEngine 容器成功建立连接。 在统信 UOS 操作系统中配置 ADB 调试工具，核心目的是为了与 UEngine 安卓容器实现通信——安装 APK 应用、抓取日志信息、执行批量脚本等操作都依赖 ADB 连接。如果在终端中输入 `adb version` 后提示“命令未找到”，通常意味着 ADB 尚未安装，或未正确添加到系统环境变量中。 ## 安装 ADB 调试工具 直接执行 `sudo apt install adb` 即可完成安装。该命令会从系统默认软件源获取官方维护的 ADB 版本，该版本与 UEngine 安卓容器的通信协议完全兼容。 若遇到 `E: 无法定位软件包 adb` 错误提示，不必担心，请先更新软件源索引：执行 `sudo apt update` 刷新源列表，然后重新运行安装命令。 安装完成后，使用 `adb version` 命令验证版本信息，确保版本号不低于 1.0.41——低于此版本可能与 UEngine 内置安卓子系统握手时出现兼容性问题。 ## 验证 ADB 可用性与网络连通性 ADB 工具本身不依赖图形界面，但若要成功与 UEngine 容器通信，底层网络必须畅通。如果跳过网络验证环节，后续执行 `adb connect` 很可能会失败，并且错误提示往往不够明确。 首先检查 UEngine 虚拟网卡是否已激活：执行 `ifconfig | grep uengine0`，若有输出则表示网络接口已就绪。 接着测试容器 IP 地址的连通性：执行 `ping -c 3 192.168.250.2`，应收到三个成功响应。如果出现超时，通常意味着 UEngine 服务未启动或网络模块存在故障。 **【关键前提】** 仅在 `ping 192.168.250.2` 成功的前提下，ADB 连接才具有实际意义。如果在网络不通的情况下强行执行 `adb connect`，终端将返回“unable to connect to 192.168.250.2:5555”，且缺乏进一步指引，容易陷入困境。 ## 连接 UEngine 安卓容器 第一步：确保 UEngine 容器服务处于运行状态。执行 `sudo systemctl start uengine-container.service`——切勿省略此步骤，即便之前已启动过，系统重启后该服务往往处于 inactive 状态。 第二步：建立 ADB TCP 连接。输入 `adb connect 192.168.250.2`，终端将立即返回 `connected to 192.168.250.2:5555`，出现该提示即表示连接成功。 第三步：验证设备是否在线。执行 `adb devices` 命令，输出中应包含 `192.168.250.2:5555 device` 条目，状态显示为 `device`，而非 `offline` 或 `unauthorized`。 如果显示 `unauthorized`，表明 UEngine 容器未授权当前主机的调试请求——需要打开 UEngine 安卓桌面，在弹出的 ADB 授权对话框中点击“允许”。该弹窗仅在首次连接时出现，默认 5 秒后自动消失，若错过则需断开连接后重新触发授权。