autool/DroidBot

DroidBot - 多平台自动化 UI 测试框架

DroidBot 是一个轻量级的自动化 UI 测试框架，支持多平台（目前支持 Android）。通过智能的 UI 探索策略和可扩展的架构设计，帮助开发者进行应用测试和 UI 自动化。

特性

• 多平台支持: 采用抽象工厂模式，易于扩展新平台
• 智能探索: 基于记忆引导的 UI 探索策略 (MemoryGuidedPolicy)
• CV 模式: 支持计算机视觉识别 UI 元素
• GuiAgent 集成: 可集成 LLM 驱动的 GUI 代理处理复杂场景
• 脚本支持: 支持自定义脚本控制测试流程

快速开始

安装

cd DroidBot
pip install -e .

运行

python start.py -d <device_serial> -a <package_name> -o <output_dir>

主要参数

参数	说明
-d	设备序列号
-a	被测应用包名
-o	输出目录
-policy	探索策略 (memory_guided, manual, none)
-cv_mode	启用 CV 模式
--enable_guiagent	启用 GuiAgent

架构

droidbot/
├── core/                       # 核心抽象层
│   ├── abstract_device.py      # 设备抽象基类
│   ├── abstract_device_state.py # 状态抽象基类
│   ├── abstract_input_event.py # 事件抽象基类
│   └── platform_factory.py     # 平台工厂
├── platforms/                  # 平台实现
│   ├── android/               # Android 实现
│   └── ios/                   # iOS 预留
├── input_policy.py            # 输入策略
├── input_manager.py           # 输入管理器
└── utg.py                     # UI 转换图

扩展新平台

参见 PLATFORM_GUIDE.md 了解如何添加新平台支持。

许可证

MIT License