项目简介
本项目是基于Python的Android自动化测试工具,借助ADB(Android Debug Bridge)命令与Android设备通信,模拟用户操作实现Android设备的自动化控制,支持自动化测试、应用演示等功能。
项目的主要特性和功能
- ADB命令操作:利用ADB命令与设备通信,获取设备信息并模拟操作。
- 触摸事件解析:解析ADB输出的触摸事件信息,提取触摸点坐标并归一化处理。
- GUI界面支持:提供简单GUI界面执行特定操作。
- 屏幕录制功能:通过ADB控制设备屏幕录制,可保存视频到设备或本地。
- 自定义操作支持:支持点击、滑动、输入文本等自定义触摸操作。
- 自动化评测:通过配置文件进行自动化评测,生成结果并保存日志。
- 多并发数据构造:调节并发参数控制并行协程数量,提升测试效率。
- 人工执行与历史加载:支持人工操作,可加载历史操作记录恢复操作。
安装使用步骤
前提条件
假设用户已下载本项目的源码文件。
具体步骤
- 安装ADB和Android Studio:
- 下载并安装Android Debug Bridge。
- 若无Android设备,下载Android Studio并使用其自带模拟器。
- 配置环境:
- 确保ADB环境配置正确,能通过命令行执行adb devices查看设备。
- 安装项目依赖:pip install -r requirements.txt。
- 创建配置文件:
- 依据config_files/example.yaml创建yaml文件,填写GPT4V_TOKEN和LOG_DIR等配置项。
- 运行自动化测试:
- 修改mobile_test.py中的instruction和yaml文件路径,运行python mobile_test.py。
- 自动化评测:
- 修改yaml文件,添加AVD_BASE、AVD_NAME、ANDROID_SDK_PATH等配置项。
- 运行evaluation_emulator.py,结果保存在evaluation_logs文件夹。
- 人工执行与历史加载:
- 运行simple_test_manual_executor.py,设置auto_executor = False进行人工操作。
- 设置reload_history = True并指定历史记录路径,加载历史操作。
- Webarena评测:
- 配置端口转发和环境文件.env。
- 运行python -m Pipeline.pipelines.webarena_test --result_dir result。
注意事项
- 环境配置:确保ADB环境配置正确,可正常执行ADB命令。
- 设备连接:确保Android设备已连接到计算机,且处于调试模式。
- 权限问题:执行某些操作可能需设备特定权限,如文件访问权限。
- 稳定性测试:自动化测试时,注意保持脚本稳定性和可靠性。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】