1、Airtest客户端下载
访问官网http://airtest.netease.com/,根据自己的系统下载相应的客户端安装;
2、python工具下载与环境搭建
在本地python环境中安装airtest和pocoui,然后用命令行运行脚本;
1、建议使用3.7以下 版本,下载python3;
2、下载python后,配置本地的运行环境,详见:http://airtest.netease.com/docs/cn/4_run_script/run_script.html#id4
1)使用 pip 安装Airtest框架 pip install airtest
2)若运行代码时,在cv2模块报 ImportError: DLL load failed: 找不到指定模块
的错,如果使用的python版本低于3.7,请直接运行:
pip uninstall opencv-contrib-python
# 若以下安装语句运行失败,可以尝试更新pip到最新版本后重试
pip install opencv-contrib-python==3.2.0.7
3)Poco安装
使用 pip 安装poco框架 pip install pocoui
,请注意库的名称为 pocoui
,不要填错。
3、在Airtest中集成python环境
在Airtest中集成python环境的话,需要安装python之后,再填写python的路径到AirtestIDE中;可以参考:http://airtest.netease.com/docs/cn/4_run_script/run_script.html#airtestidepython 进行集成;
1、使用方法
具体请参考官方文档:http://airtest.netease.com/docs/cn/,请优先看快速5分钟使用教程:http://airtest.netease.com/tutorial/Tutorial.html
2、在Airtest IDE中连接手机
在Air test中连接手机请查看连接:http://airtest.netease.com/docs/cn/2_device_connection/1_android_phone_connection.html#androidusb
手机连上Airtest之后,会向手机中咱装3个app,如下:
pocoservice是支撑poco操作的app,yosemite是airtest的输入法,安装之后,手机的默认输入法会变成这个输入法,如果需要改回来原来的输入法,需要手动到手机设置里面进行修改;
3、在代码中连接手机
如果是在 .py
脚本文件中 import airtest/poco
,希望以普通python脚本的方式来运行的话,可以在脚本代码中使用 connect_device
接口:
1 from airtest.core.api import *
2 connect_device("Android:///") # 传入的是设备字符串
4.多个手机交互
如果case中涉及到两个手机交互的,可以在.py文件中连接多个手机,需要在哪个手机上操作,就需要在脚本中使用set_cerrent()借口来切换到相应的手机上;
1 device1 = "c17a4cb4" #设备1
2 device2 = "RKK0217C15003363" #设备2
3 dev1 = connect_device("android://127.0.0.1:5037/"+device1)#连接设备1
4 dev2 = connect_device("android://127.0.0.1:5037/"+device2)#连接设备2
5 poco1 = AndroidUiautomationPoco(dev1) #初始化设备1
6 poco2 = AndroidUiautomationPoco(dev2) #初始化设备2
7 set_current(device1)#切换到手机1
8 set_current(device2)切换到手机2
5.case举例
初始化设备之后就可以进行相关设备的poco操作了,举个例子:
这个例子是打开微信,点击聊天信息中的一个好友,然后清除好友聊天的例子;
1 from poco.drivers.android.uiautomation import AndroidUiautomationPoco
2 device1 = "c17a4cb4" #设备号
3 dev1 = connect_device("android://127.0.0.1:5037/"+device1)#连接师傅手机
4 poco1 = AndroidUiautomationPoco(dev1) #实例化手机
5 auto_setup(__file__)
6
7
8 def clear_wechat(poco):#清除微信的聊天记录
9 start_app("com.tencent.mm")#启动微信
10 sleep(12)#等待12秒
11 poco1(text="三星").click()#点击好友“三星”的聊天
12 poco1("android.support.v7.widget.LinearLayoutCompat").click()#点击更多
13 poco1(text="清空聊天记录").click()#点击清空聊天记录
14 poco1(text="清空").click()#点击清空
15 stop_app("com.tencent.mm")#关闭微信
6.引用其他air文件的方法:
如果有很多重复的操作,可以将这些重复的操作写到一个公用的air文件里面,然后再在用例里面引用这个公用的air文件的方法就可以:
举例,有一个名叫gongyou.air的文件,里面有一个clear_wechat的方法,这个clear_wechat方法就是一个清除微信聊天记录的用例,如果需要在用例中用到这个clear_wechat,就需要在用例中引用这个文件,然后倒入这个引用文件中的clear_wechat方法,如下:
1 # -*- encoding=utf8 -*-
2 __author__ = "xhong"
3
4 from airtest.core.api import *
5 from poco.drivers.android.uiautomation import AndroidUiautomationPoco
6 from poco.exceptions import PocoNoSuchNodeException
7 from poco.exceptions import PocoTargetTimeout
8 ST.PROJECT_ROOT = "D:\code\AirtestCase"#引用公用air的路径
9 using("gongyou.air")
10 from gongyou import clear_wechat
7.IDE的使用
IDE的设置和使用官网有具体的说明:http://airtest.netease.com/docs/cn/7_settings/1_ide_settings.html#editor
7.1、新建脚本
点击脚本窗口右侧的“+”号,会新建脚本,新建的脚本默认会生成下面的代码;如下:
7.2 Airtest辅助窗的使用
7.3 poco辅助窗的使用:
符合下列框架的APP的UI定位使用的是POCO辅助窗;
已安卓原生应用举例:
选择Android原生应用之后,会提示导入相关的库,选择yes就好;
7.4、执行脚本与查看报告
执行单个脚本,在airtest中执行就可以,如下:
7.5 执行多个脚本,需要在python中跑代码
多个脚本批量执行,在Airtest IDE中无法实现,需要单独写一个框架,并使用python写一个执行入口文件myrunner.py;
多个脚本串行执行脚本请参考:https://blog.csdn.net/u010127154/article/details/83375659
执行myrunner.py文件时,需要更改自己的AllCase路径和自己手机的设备号:
说明: 1.所有的需要执行的case写好之后都放在AllCase文件夹里面;
2.执行时只需要执行myrunner.py文件就可以了。
3.批量执行的报告会汇总到/Users/xhong/Documents/UI/AirtestCase/AllCase/summary.html文件里面,所有case执行完成之后,打开semmary.html文件可以看到汇总页面,点击每一个case名称可以查看具体的测试报告的内容;
7.6 需要注意的问题:
airtest 测试需要注意的问题:
1、在使用Airtest过程中,遇到的错误,请先到官网http://airtest.netease.com/docs/cn/9_faq.html,查找相应问题的解决方法,这个很重要,可以节省很多时间;
2.查看批量脚本的执行报告时,不要再IDE里面查看,直接打开文件就可以;
3.图像识别时,要截取高分辨率的手机来适配低分辨率的手机;
4.最好使用华为或是三星的手机,其他的手机启动pocoserver时可能会失败,导致脚本执行失败;
软件测试技术交流群:1125760266