靠人手在手机界面上点点点，很难把测试或运营扩到几十、上百台设备。迁到云端 Android 后，常用的两层控制是 ADB（Android Debug Bridge）与提供商 REST API。一层管操作系统内动作，一层管虚拟设备生命周期。
本指南说明二者差别、何时用哪个、如何通过 TCP/IP 连接 ADB，以及如何用 API 做批量编排。范围限定在已批准的测试、诊断、文件传输与受控自动化。
1. ADB 与云手机 REST API 的区别
什么是云手机 ADB？
ADB 工作在 OS 层。它是原生 Android 命令行工具。实体机上通常走 USB；云手机上常见做法是通过网络用 TCP/IP 连接。连上后，你可以直接与环境内的 Android 对话：安装 APK、推送/拉取文件、读 logcat、注入点击或滑动。
什么是云手机 REST API？
REST API 工作在基础设施层。它由云手机平台（宿主机）提供，虚拟机内的 Android 通常感知不到。你用它管理虚拟硬件本身：开关机、恢复出厂、绑定代理、调整设备元数据、查询在线状态等。
2. ADB vs API：何时用哪个？
多数稳健架构会编排二者：API 管池与状态，ADB 管机内动作。
| 自动化任务 | 使用工具 | 为什么 |
|---|---|---|
| 重启虚拟设备 | REST API | 与宿主机交互，安全重启实例 |
| 安装测试 APK | ADB | 直接写入 Android 文件系统 |
| 更改代理绑定 | REST API | 在流量进入手机前配置路由 |
| 模拟点击/滑动 | ADB | 向 OS 注入 UI 事件 |
| 提取 UI 层级供 Appium | ADB | 从无障碍层读取窗口树 |
| 恢复出厂或清数据 | REST API | 把实例重新镜像到干净状态 |
查阅端点与鉴权时，以你所选提供商的官方 API 文档为准。不同平台路径与权限模型差异很大。
3. 通过 ADB 连接云手机（分步）
云手机无法插 USB，因此提供商通常通过 TCP/IP 暴露 ADB。连接前先确认：你的角色是否获批、目标设备是否正确、流量是否走隧道或白名单。
步骤 1：获取远程连接详情
登录控制台，打开目标设备的开发者/连接信息。通常会看到主机、端口，以及鉴权令牌或临时凭证。形状类似 host:5555，具体以提供商为准。
步骤 2：通过终端连接
本机安装 Android SDK Platform-Tools 后执行：
adb connect HOST:PORT
成功时会看到 connected to HOST:PORT 一类提示。
步骤 3：执行命令时带上设备选择器
多设备场景下始终用 -s，避免打到错误环境：
adb -s HOST:PORT install my_app.apk
adb -s HOST:PORT shell input tap 500 1000
adb -s HOST:PORT shell input text "Hello%sWorld"
安全注意： 明文 TCP 上的 ADB 风险更高。优先使用提供商提供的 SSH 隧道、VPN 或 IP 白名单，并限制谁能拿到连接串。命令、设备、用户与结果应进审计日志。
4. 用 REST API 扩展设备池
ADB 适合精确控制单机。池子到几十、上百台时，靠手工 adb connect 不现实。这时用 REST API 做编排：列设备、改代理、批量重启、等 Online，再按需挂 ADB 任务。
示例：晨间重置（已批准工作流）
假设团队每天需要把一批测试/运营环境恢复到已知状态：
- GET 拉取设备列表与状态
- POST 按策略更新代理或网络配置
- POST 批量重启，使配置生效
- 状态变为 Online 后，脚本再按设备建立 ADB 连接，触发 Appium / UIAutomator 或已批准诊断脚本
任何一步失败都应停止或降级，而不是盲目重试。
5. 框架兼容性：Appium、设备内脚本
因为环境跑的是 Android，常见框架通常可复用。
Appium 与 UIAutomator2
建立 ADB 连接后，把远程 host:port 作为 Desired Capabilities 的 udid 传入。后续写法与本地设备接近，但仍要处理云端特有的超时、断连与设备占用。
设备内脚本（Auto.js / Tasker 等）
若不想长期维持本机到云端的 TCP 连接，可把已审核脚本推到设备内本地跑。适合网络抖动较大、或任务允许离线执行的场景。脚本来源、版本与触发人仍要可追溯。
6. 常见问题
使用 ADB 需要 Root 吗？
标准安装、点击、拉日志通常不需要。若脚本要改深层系统文件或装系统级框架，才可能需要 Root——这会扩大风险面，应单独审批。
云手机 API 有速率限制吗？
多数企业平台有。写循环时实现退避与错误处理，尤其是 HTTP 429。把限流当成正常设计约束，不要靠打满配额「抢速度」。
能同时对多台设备跑 ADB 吗？
可以，用多线程或设备农场调度工具。每条命令必须带 -s，并限制并发，避免把平台或本机打满。
ADB 对应用行为有影响吗？
有可能。开启调试相关开关会改变设备状态，部分应用对调试环境更敏感。把它当作已知变量：能用官方 API 或应用内测试通道时优先用；必须用 ADB 时，把范围写进变更记录，并在复盘时标注。