Android CLI接入云端真机：AI Agent也能部署应用、抓日志和截图

核心更新：真机测试进入命令行工作流

Android Developers宣布，开发者及其AI Agent现在可以通过Android CLI直接访问Android Device Streaming，在终端中完成远程真机连接、应用部署、日志收集和屏幕截图。

这次更新的重点可以概括为三点：

• 连接的是远程物理设备，不是本地模拟器。没有对应手机，也能在真实硬件上运行和调试应用。
• 真机操作可以接入脚本和Agent工作流，减少在多个工具之间手工切换。
• 代码修改之后，Agent有了获取运行日志和界面截图的工具入口，但这不等于应用已经自动通过测试。

Android CLI与Device Streaming各自做什么

Android CLI提供统一的开发命令入口，覆盖项目创建、SDK管理、应用运行、设备操作和界面检查。Android Device Streaming则提供远程物理设备资源。

根据官方文档，android device remote命令组可以预约Google数据中心托管的Android设备，并将它连接到本机ADB。连接完成后，开发者可以像操作本地连接设备一样，使用相关命令部署、调试应用。

不只是远程看屏幕，而是让Agent取得运行证据

部署、日志与截图构成验证链路

传统AI编程流程容易停在‘代码改好了’：项目可能编译通过，但目标设备上的页面错位、运行异常或兼容问题尚未验证。

命令行接入真机后，可以组织这样的工作流：

1. 构建应用，并部署到指定设备。
2. 运行需要检查的功能或测试用例。
3. 收集日志，判断是否出现异常。
4. 保存截图，核对实际界面。
5. 根据证据修改代码，再次验证。

这是可搭建的工作流，不是官方承诺的全自动修复能力。测试场景、成功标准和结果审核仍需要开发者定义。

截图也能带上可定位的界面标记

Android CLI的截图能力支持给检测到的界面元素添加编号边界框。Agent可以查看截图中的编号，再通过android screen resolve将编号解析为坐标，便于后续交互。

需要分清两个动作：解析坐标不等于点击已经执行；截图中的视觉标记，也不能替代测试断言。

上手流程：登录、选设备、预约并连接

第一步：准备CLI与云项目

先从Android官方工具页面下载并安装Android CLI。已安装的用户可以更新工具，并初始化供Agent使用的技能：

android update
android init
android auth login
android auth status

其中，android init会安装Android CLI相关技能；登录命令会通过浏览器完成Google账号认证。账号必须有权访问已经启用设备串流的Google Cloud项目。

第二步：查询项目和可用机型

android device remote projects

# 替换为自己有权限使用的项目ID
PROJECT_ID=your-project-id
android device remote models --project="$PROJECT_ID"

机型以<codename>/<api>形式标识，应以查询返回的可用列表为准，不要直接假设某个型号或系统版本始终有库存。

第三步：预约设备并接入ADB

# 替换为models命令实际返回的设备标识
DEVICE_MODEL='your-codename/your-api'
android device remote create "$DEVICE_MODEL" --project="$PROJECT_ID"
adb devices

create默认会等待预约就绪，并连接到ADB，同时输出预约ID及结束时间。若只想预约、稍后再连接，可以加上--connect=false。

在真机上部署、抓日志与截图

用序列号锁定操作目标

设备接入后，可使用android run、android install或ADB执行后续操作。下面以已有APK为例，演示安装、读取当前日志和截图；执行截图前，应先启动应用并进入待验证页面。

# 从adb devices输出中获取远程设备序列号
SERIAL=your-device-serial

# 替换为实际构建产物路径
adb -s "$SERIAL" install -r path/to/app.apk
adb -s "$SERIAL" logcat -d > device-log.txt

android screen capture --device="$SERIAL" --output=screen.png
android screen capture --device="$SERIAL" --annotate --output=ui-annotated.png

如果同时连接了本地手机、模拟器和云端设备，显式指定序列号尤其重要，避免安装到错误设备或采集错日志。

测试完成后释放预约

断开连接和删除预约是两个不同动作。官方推荐结束使用时依次执行：

# 使用create命令返回的预约ID，不是ADB序列号
RESERVATION_ID=your-reservation-id
android device remote disconnect "$RESERVATION_ID" --project="$PROJECT_ID"
android device remote remove "$RESERVATION_ID" --project="$PROJECT_ID"

预约ID用于管理云端资源，设备序列号用于选择ADB操作目标，两者不要混用。

使用边界：真机可访问，不代表测试可以无人负责

计费、权限和数据都要纳入流程

官方文档明确，远程设备用量归属Google Cloud项目计费。这不是无限免费的真机池；启动前应确认项目的配额、预算和适用收费规则，结束后及时释放预约。

让Agent操作时，还应注意：

• 权限最小化：只开放完成测试所需的账号和项目权限。
• 使用测试数据：避免在共享测试流程中登录真实生产账号。
• 审查输出文件：日志和截图可能包含用户信息、令牌或业务数据，不宜未经处理直接传给外部服务。
• 明确验收条件：安装成功、页面能打开，都不等于功能正确或兼容性达标。

最适合从一个小型验证任务开始

可以先选一个待复现问题、一款目标设备和一组明确操作，跑通‘部署—复现—日志—截图—释放’的完整过程，再扩展到更复杂的自动化测试。

这次更新的实际价值，是把远程真机变成开发者和Agent都能调用的标准工具，让AI辅助开发从生成代码进一步走向真实设备上的验证。它降低了获取设备和运行证据的门槛，但不会替代测试设计与工程判断。

本文依据Android Developers公告及Android CLI远程设备官方文档整理；示例按文档编写，未在本次整理中实际预约设备执行。