基于 Python + appium+wda搭建 APP UI 自动化测试框架,对 Android/iOS 移动端 App 页面功能做自动化回归。支持元素定位、页面操作、多设备管理、测试数据驱动、页面断言、失败截图,自动生成可视化测试报告;可接入 Jenkins 实现定时自动执行,用于版本迭代冒烟、核心业务流程回归,替代重复手工点击操作,快速发现页面元素、业务流程类 bug,降低手工回归成本。
1、整体分层目录设计
框架采用分层思想,业务和元素、用例解耦:
config:yaml 配置文件,保存设备信息、app 包名、启动参数、环境配置;
page:页面对象层 PO 模式,每个页面封装页面元素定位器、页面操作方法(点击、输入、滑动);
cases:测试用例,基于 pytest 编写业务流程,调用 page 层方法;
common:公共工具,Appium 驱动初始化、元素等待、截图工具、日志、yaml 读取;
report/log:Allure 测试报告、运行日志、失败截图存放目录。
2、驱动与设备管理
封装 Appium 驱动启动、销毁逻辑;支持多 Android 设备连接,指定设备执行;支持设置隐式 / 显式等待,避免页面加载未完成导致元素找不到;支持 app 重置、重启、安装卸载 APP。
3、PO 页面对象模式封装
采用 PO(Page Object)设计模式:将每个页面的元素定位、页面操作单独封装。测试用例只关心业务流程,不写大量元素定位代码;页面改版时,只需要修改 page 层,用例不用大量改动,维护成本更低。
支持多种定位方式:id、xpath、resourceId、text、className。
4、页面断言与失败自动截图
支持页面文本断言、元素是否存在判断、toast 弹窗捕获;用例执行失败时自动截图,图片嵌入 Allure 报告,方便定位失败原因。使用 logging 记录每一步操作日志。
5、报告与 CI 集成
执行完成自动生成 Allure 可视化报告,展示用例执行状态、失败截图、执行耗时;可接入 Jenkins,配置定时任务在打包后自动执行冒烟回归,结果推送钉钉 / 企业微信。
6、常用操作封装
封装常用移动端操作:点击、输入文本、上下左右滑动、手势长按、弹窗关闭、toast 获取、app 后台唤醒。