一、什么是Airtest
Airtest是网易出品的一款基于图像识别和poco控件识别的UI自动化测试工具。支持Windows、Android、IOS平台。 Airtest提供了跨平台的API,包括安装应用、模拟输入、断言等。可结合python脚本进行自动化。测试脚本运行后可以自动生成详细的HTML测试报告。
二、Airtest环境部署
① 官网地址:http://airtest.netease.com/;
② Airtest IDE自身集成了adb,因此不需要配置环境变量,下载解压即可;
③ Airtest IDE用到python,因此需要安装部署python的环境;建议用Python3.X以上版本;
④ 其余用到的python的库,根据需要自行安装即可,例如OpenCV;
⑤ 一切就绪之后,启动AirtestIDE.exe,可以忽略注册,直接skip即可;
⑥ 进入到IDE,右上角的设备管理区域,建议选择use adb touch,具体界面图如下:
注释:软件部署成功之后,连接设备之后,设备端会生成两个插件,Yosemite和PocoService。
三、Airtest项目实践
小编最近利用Airtest编辑浏览器自动化脚本,遇到的难点不是业务本身,而是工具资料的不全,给实践过程中带来很多不便。因此觉得有必要整理一番,以下Api均为小编实践运用,验证可行,后续会陆续补充。
1、 点击
单击:touch((x,y)),例如,touch((200,500)),表示点击x为200,y为500的位置点;
双击:touch((x,y),times=times),times表示点击次数;例如,touch((200,500),times=2),表示双击x为200,y为500的位置点,默认双击事件为0.01秒;
长按:touch((x, y),duration=duration),duration为长按时间,默认为0.01;例如,touch((200,500),duration =1),表示长按x为200,y为500的位置点1秒;
text控件点击:poco(text = text名称).click();例如,poco(text =“设置”).click(),表示点击控件text名称为“设置”的控件;
name控件点击:poco(“控件名称”).click();例如,
poco(“sogou.mobile.explorer.hmct:id/ff”).click(),表示点击控件name名称为“sogou.mobile.explorer.hmct:id/ff”的控件;
resourceId控件点击:poco(resourceId =resourceId名称).click();例如,
poco(resourceId=“sogou.mobile.explorer.hmct:id/ff”).click(),表示点击控件resourceId名称为“sogou.mobile.explorer.hmct:id/ff”的控件;
注释:resourceId控件名称通常前面包含“r”,但是在点击时要去掉;获取设备坐标可以利用手机的开发者模式中的【显示触摸位置】。
其他的控件内容如下:
2、 滑动
Airtest滑动Api为swipe((x1, y1),(x2,y2),steps= 5,duration=0.2),前两个参数为滑动的前后两个坐标;steps为滑动的步数;duration为滑动的时间;例如,swipe((100,350),(200,350),steps = 5,duration=0.2)表示从坐标(100, 350)滑动5步到(200,350),滑动时间为0.2秒;
注释:swipe中的steps默认为5,但是实践证明,对于用户教育页的场景,至少得10秒,因此为了保险起见,建议赋值10。
3、文本输入
Airtest文本输入Api为text(“文本信息”,enter = False,search=True),第一个参数为输入的文本信息;第二个和第三个类似,均为自动搜索,相当enter,可以不写,除非需要检验输入框内容,此时可以将第2个和第3个参数赋值Fasle;
4、断言
Airtest断言分为图片断言,控件断言。目前常用的是图片断言assert_exists()和控件断言exists();
assert_exists(“图片信息”,测试描述点),例如:assert_exists(Template(图片路径), "验证是否成功")返回的为坐标点,因此作为断言,一般会采用标记位,即建立一个flag,命中则true,反之则false;
poco(控件名称).exists(),表示控件是否存在,存在则标记位返回true;反之为false;
5、安装应用
Airtest安装应用的Api为install_app(apkPath,replace= False), apkPath为应用路径,replace为是否为覆盖安装开关,默认为False;用法如下:
6、卸载应用
Airtest卸载应用的Api为uninstall(“package_name_of_your_apk”),package_name_of_your_apk为应用包名,用法如下:
7、启动应用
Airtest启动应用的Api为start_app(“package_name_of_your_apk”),
package_name_of_your_apk为应用包名,用法如下:
8、退出应用
Airtest启动应用的Api为stop_app(“package_name_of_your_apk”),
package_name_of_your_apk为应用包名,用法如下:
四、Airtest参考资料
Airtest中文官网文档:https://airtest.readthedocs.io/zh_CN/latest/
五、Airtest经验之谈
①不要直接调用Api执行,采用“先封装后调用”的方法。例如Airtest中点击,滑动的操作,直接调用不仅代码冗余,而且不美观,可读性差,可以将点击,滑动的Api进行封装,用时直接调用即可;例如可以新建一个公共类,里面包含所有原始操作,如下图: ② 不要直接用图片进行点击,采用控件点击的方法。图片点击不仅看着代码结构不美观,而且只局限于固定的图片,一旦UI发生改变,点击就会出现问题; ③ 封装的方法不要直接写死参数,采用“数据驱动”的方法。封装的目的是代码层级结构明显,可读性强,代码复用性好;
④ 如何调用已有的方法。例如,小编代码结构存在Common.py,在业务类中调用Common.py中的函数,可以如下操作:
⑤ 对于控件元素有雷同的如何处理。 控件之间存在父子关系和控件 对应关系,当遇到儿子或者父亲名称一样的情况,可以采取“父找子”,“子找父”,“控件对应”的方法。 例如:
六、实践不足之处
目前的控件只适用于当前软件,一旦布局发生变化,则当前脚本不再适用,因此后续会改为“数据驱动”,动态获取数据资源,这样一来兼容性将大幅度提高。
七、结尾
以上是小编最近在使用Airtest期间的总结,初步满足了项目需要,后续随着业务需求的增加,小编会继续总结Airtest的用法,欢迎大家批评指正。
八、后续文章
“Airtest跨平台的UI自动化测试之数据驱动”正在整理中,敬请期待……
搜狗测试微信号:Qa_xiaoming
搜狗测试QQ粉丝群:459645679
本文分享自微信公众号 - 搜狗测试(SogouQA)。
如有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。