项目简介
本项目是基于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】