---
name: android-use-setup
description: 配置 Android Use 的 ADB、USB 调试和设备选择，启动 UI Automator 并验证 ready=true，处理未授权、断线、停止和重连。
---

# 配置 Android Use

先 `aua_doctor()` 或 `aua_setup(action="discover")`。复用本机 Platform Tools；SDK 默认路径可自动发现，其他位置设置 `ANDROID_USE_ADB`。不要为了本插件升级 Android SDK、杀掉共享 ADB server 或删除应用。

只有一台已授权设备时可以直接使用；多台设备必须根据用户选择用 `configure` 写入明确 serial，不猜手机。设备授权状态、配置保存在 `~/.local/share/android-use`，不写入源码或版本管理。

需要用户开启开发者选项和 USB 调试、在手机上允许这台电脑调试、解锁设备时，说明真实缺项，并使用宿主提问工具，首个选项固定「已完成继续」，另一个可为「暂时无法完成」。只有收到用户实际完成回复才继续依赖操作。其余本地代码和无关设备诊断可以继续。不要索取密码、解锁码或验证码。

用户已授权启动时调用 `aua_setup(action="start")`；使用固定版本 UI Automator 库，复用健康服务。它通过 ADB 推送执行 jar 并启动 Android 测试服务，不需要 Apple 签名或 root。`start` 的返回同时执行 READY，只有 `ready=true` 才宣布设备可用；验收包括授权、解锁、控件树、真实前台和视口。截图能力只在实际需要时验证。

停止使用 `aua_setup(action="stop")`，保留 serial 和依赖，禁用本插件操作与预览，并结束当前进程自己启动的 UI Automator。共享 ADB 与其他自动化进程保持运行；没有归属证据不按端口杀进程。重连先看 status，复用配置、接线和授权，再启动并验证 READY。

READY 报 `phone_locked` 会自动暂停为 `device_locked`，用户完成解锁后重新 READY。App 认证按 [操作技能](../android-use/SKILL.md) 接管。持续断线或 UI Automator 不可用时按具体错误处理，不无限重新安装、不重放之前的手机动作。未连接设备只能报告本地准备完成，不能宣称真机 READY。