AutoDroid app

AutoDroid 是一个面向 Android 设备的自动化平台与管控客户端。它开放 HTTP REST API，可以把远程控制、批量调度这类工作交给接口去完成，自动化测试等流程也能直接对接进来。设备端内置了 UI 自动化执行引擎，通过控件选择器定位页面元素，再按预设步骤完成一连串交互操作，执行过程比较稳定，对不同机型的兼容性也做了处理。

主要功能

1. 提供 HTTP REST API，远程下发自动化任务、批量调度设备都能通过接口完成，方便接入现有测试流程。

2. 内置 UI 自动化执行引擎，用控件选择器精确定位页面元素，交互操作执行稳定，兼容性不错。

3. 安全层面做了速率限制、路径遍历保护、头部注入防止、URL 规范化、CORS 可配置等防护。

功能特色

1. HTTP REST API 可用于远程自动化控制与批量调度，相关流程可以直接跑在接口上。

2. UI 自动化执行引擎支持灵活的控件选择器，定位到元素后即可完成点击、输入等交互动作。

3. 安全机制包含内容速率限制、路径遍历保护、头部注入防止、URL 规范化，CORS 策略也能自行配置。

4. 内置 5 个单例适配器；AutomatorEngine 作为独立 Gradle 模块存在；Web 前端用 React 19、TypeScript、Vite 构建运行。

5. 壳命令执行模块可以运行任意 shell 命令并截取屏幕画面，还支持手势控制、硬件键操作，多窗口界面层级也能完整呈现。

使用前的准备

1. 先授权开启无障碍权限和悬浮窗权限。

2. 留意仪表盘上显示的 API 令牌，后续调用接口会用到。

3. 设置端口转发，执行命令：adb forward tcp:8080 tcp:8080。