Airtest介绍与快速上手
AirtestProject项目简介
Airtest Project是一款由网易研发并开源的自动化测试框架,相比于其他的自动化测试框架,主要有如下两个优势:
- 大幅度降低自动化脚本的编写和维护成本
Airtest Project希望能够通过一种所见即所得的方式完成脚本的录制,即使测试人员不会编程不懂脚本,也可以通过正常用户的点击拖拽等操作,自动完成脚本的录制,从而大幅度降低企业和项目的自动化维护成本。
- 解决游戏测试的痛点
Airtest Project希望能够通过对游戏的不同引擎做支持,成为一个真正意义上的跨引擎跨平台的自动化测试平台。
AirtestProject是由网易游戏推出的一款自动化测试框架,项目构成如下:
Airtest:是一个跨平台的、基于图像识别的UI自动化测试框架,适用于游戏和App,支持平台有Windows、Android和iOS,开码和有API文档。
Poco:是一款基于UI控件识别的自动化测试框架,目前支持Unity3D/cocos2dx-*/Android原生app/iOS原生app/微信小程序,也可以在其他引擎中自行接入poco-sdk来使用,开码和有API文档。
AirtestIDE:跨平台的UI自动化测试编辑器,内置了Airtest和Poco的相关插件功能,能够使用它快速简单地编写Airtest和Poco代码。
AirLab:真机自动化云测试平台,目前提供了TOP100手机兼容性测试、海外云真机兼容性测试等服务,请访问官网以了解更多。 私有化手机集群技术方案:从硬件到软件,提供了企业内部私有化手机集群的解决方案,欢迎了解。
可以看到,底层的主要测试框架主要是Airtest和Poco,二者的区别在于:
Airtest:基于Python的、跨平台的UI自动化测试框架,基于图像识别原理,适用于游戏和App。
Poco:基于UI控件搜索的自动化测试框架,其核心优势是除了对Android、iOS之外,对游戏也是支持的,同时也支持微信小程序、微信小游戏和H5应用。
支持平台
- Android
- iOS
- Windows
- Unity
- Cocos2dx
- 白鹭引擎
- 微信小程序
快速上手
对于新手,我们非常建议使用 AirtestIDE 来帮助你编写自动化测试脚本。熟练上手 Airtest 和 poco 以后,如果有需要的话,则可以尝试脱离IDE来跑测试脚本,比如在本地命令行上运行,比如在pycharm上运行等等。
Airtest官方文档:https://airtest.doc.io.netease.com/
AirtestIDE
AirtestIDE 是一个跨平台的UI自动化测试编辑器,它是专为以上两个自动化测试框架量身打造的。所以我们非常建议新手可以从 AirtestIDE 开始学习 Airtest 和 poco 。
AirtestIDE 安装
目前AirtestIDE提供了Windows和Mac两个版本的客户端,请从官网下载,解压即用。
官网下载地址:http://airtest.netease.com/
系统要求
- 操作系统
- Windows
- MacOS X
- Linux
- Python2.7 & Python3.3+
连接设备
无论是Android/iOS手机,还是Windows窗口,在Airtest中都将它视为一个设备,接下来我们将演示如何连接一个设备。
连接Android手机 通过ADB连接你的电脑和Android手机,即可开始调试Android应用。ADB是Google官方提供的Android调试工具。AirtestIDE依赖ADB与安卓设备进行通信。
打开AirtestIDE,按照以下步骤进行连接:
- 打开手机设置-开发者选项-USB调试开关,参考安卓官方文档
- 在AirtestIDE设备面板中点击refresh ADB按钮,查看连接上的设备
- 如果没有显示出设备,试试restart ADB,如果还不行,参考FAQ文档进行问题排查
- 能够成功看到设备后,点击对应设备的Connect按钮,进行初始化
手机连接成功后,即可在AirtestIDE中看到手机屏幕的镜像显示,并进行实时操作。
录制自动化脚本
一、基于图像识别
点击AirtestIDE左侧的Airtest辅助窗上的录制按钮,然后随着你在设备窗口上操作手机,代码会自动生成在代码窗口中。
支持以下常用API:
touch:点击输入
text: 文字输入
keyevent: 按键输入,包括(HOME/BACK/MENU等)
sleep: 等待
snapshot: 截屏
二、基于UI控件
如果你发现图像识别不够精确,还可以使用基于UI控件搜索的方式进行自动化测试,与刚才的Airtest不同,这是Poco这个框架实现的功能。
目前Poco直接支持Unity3d、Cocos2d、白鹭引擎等多种游戏引擎,以及Android/iOS原生App。
如果是Android/iOS原生应用,是即插即用的,无需接入SDK。但由于游戏引擎使用OpenGL等图形接口直接渲染,而没有使用Android原生的UI系统,我们需要与游戏的Runtime进行通信获取整个UI结构。
点击录制按钮,然后随着你的鼠标操作,会自动生成Poco语句到脚本编辑框中
对于Android/iOS的原生应用来说,不需要接入SDK即可使用,例如在连上Android手机后,将Poco辅助窗的模式切换至Android,能可以看到整个UI树形结构。
自动录制出的语句不一定能够适应所有场景,采用更合理的选择器编写代码,通常会增强整个自动化脚本的健壮性和可读性,这是门学问。
使用Python语法
整个AirtestIDE中录制和运行的代码都是基于Python语言。Python语法简洁而强大,第三库和工具也非常多。
对于老手,你可以在AirtestIDE中使用各种第三方库来使你的自动化脚本更加强大,通过添加PYTHONPATH设置,可以使用本地的python.exe来运行你的脚本。
除了辅助窗口里面提供的语句,更多的API文档,可以查看Airtest和Poco的仓库。
例子:使用这些API来编写一个自动化脚本,步骤如下:
- 通过ADB连接一台安卓手机
- 安装应用APK
- 运行应用并截图
- 模拟用户输入(点击、滑动、按键)
- 卸载应用
模拟输入,支持以下常用API:
- touch:点击
- swipe:滑动
- text:文本输入
- keyevent:按键输入,包括(HOME/BACK/MENU等)
- snapshot:截图
- wait:等待
声明断言,Airtest提供了以下断言方法:
- assert_exists:断言图片存在
- assert_not_exists:断言图片不存在
- assert_equal:断言相等
- assert_not_equa:断言不等
命令行接口
可以使用命令行接口将自动化测试与持续集成结合起来。
你可以在不开启IDE的情况下,在命令行中使用那条命令来启动测试脚本,例如: "D:\迅雷下载\AirtestIDE\AirtestIDE" runner "D:\AirtestIDE_2018-01-24_83\untitled.air" --device Android://127.0.0.1:5037/F8UDU16409004135 --log "C:\Users\gzliuxin\AppData\Local\Temp\AirtestIDE\scripts\cdfc40e8c297b6ad88e09de64d8bafa3"
你还可以在不同电脑上针对不同设备运行测试, 这时候你就需要用命令行运行 .air 脚本 。 对于多平台发布的产品,灵活使用跨平台API和命令行,还可以让同一套测试脚本运行在Android和Windows上进行测试。
查看测试报告
脚本运行完毕后,点击查看报告按钮(快捷键Ctrl+L),会使用默认浏览器打开结果报告页面。报告中将展示出每一个步骤的内容和实际执行过程的截图、运行结果,方便查看步骤是否执行成功。
案例实操
完成过程请观看演示视频:
总结
Airtest特性回顾
跨平台: Airtest可以在几乎所有平台上执行游戏和App的自动化。
一次编写,随处运行: Airtest提供了跨平台的API,囊括了应用安装、模拟输入以及断言等。由于使用图像识别技术来定位UI元素,因此无需嵌入任何代码即可对游戏和应用进行自动化操作。
可扩展性: 通过使用Airtest提供的命令行与python API接口,可以很轻松地在大规模设备集群上运行脚本。提供的HTML报告包含了详细操作步骤和截屏,能够迅速定位到失败点。同时,网易也提供了 Airlab 云测试平台服务。
AirtestIDE: AirtestIDE是一个强大的GUI工具,可以帮助你录制和调试测试脚本。 AirtestIDE提供了完整的自动化工作流程支持:录制脚本->真机回放->生成报告。