Skip to content

新人必读

前言

每天都有很多新的小伙伴开始学习使用我们的 Airtest 和 poco 框架来进行自动化测试;但是新手难免会提出很多疑问:

比如,使用这两个框架能不能满足我的测试工作需求;有没有什么教程可以学习;到哪里可以找到一些脚本demo看看;遇到问题不能解决可以怎么办...

因此我们特意编写了这篇新手指南大全,希望可以帮助大家可以更好地理解和学习这俩个自动化测试框架,轻松入门自动化测试。

Airtest

Airtest是一款基于 Python 的、跨平台的UI自动化测试框架。因为它基于 图像识别 的原理,所以适用于所有 Android、 iOS和 Windows 应用。因此,不论是手机上的app还是游戏,或者是Windows电脑上面的应用或者游戏等等,都可以用Airtest框架。

借助Airtest,我们可以通过各种截图在设备上实现模拟输入,完成自动化测试脚本:

image

Poco

Poco是一款基于 UI控件搜索 的自动化框架,它本质上也是 python 第三方库。

image

目前来说,除了安卓原生应用,poco可以直接使用,其它各种平台都需要通过对应的方法来接入pocoSDK,之后才能够使用poco框架。

我们现在支持的平台有:Android,iOS,Cocos-Creator,Cocos2dx-js, Cocos2dx-lua,UE4,Unity3D,Egret,WeChat Applet&webview,Netease;不支持Windows和MacOS。

对应的接入文档和注意事项可以在我们的官方文档网站上查看“poco支持的平台” 这部分内容。

AirtestIDE

AirtestIDE 是一个跨平台的UI自动化测试编辑器,它是专为以上两个自动化测试框架量身打造的。所以我们非常建议新手可以从 AirtestIDE 开始学习 Airtest 和 poco 。

image

AirtestIDE的下载官网为:http://airtest.netease.com/ 。这款编辑器可以运行在以下平台上:

image

如何开始使用

对于新手,我们非常建议使用 AirtestIDE 来帮助你编写自动化测试脚本。熟练上手 Airtest 和 poco 以后,如果有需要的话,则可以尝试脱离IDE来跑测试脚本,比如在本地命令行上运行,比如在pycharm上运行等等。

所以首先,你需要在你的电脑上下载对应的 AirtestIDE ,详细的AirtestIDE安装与启动的方法可以参看官方文档:https://airtest.doc.io.netease.com/IDEdocs/getting_started/AirtestIDE_install/ 。

成功打开IDE之后,你需要在IDE的设备窗口连接上你的测试设备,不论是安卓真机、安卓模拟器、iOS真机还是Windows窗口,在我们官方教程文档 https://airtest.doc.io.netease.com/ 上都可以找到对应的教程。

image

借助IDE界面左侧的Airtest辅助窗,我们可以对连接上的设备进行一些模拟操作,比如点击、滑动、截图、长按、输入文本等等。

image

而借助poco辅助窗,我们则可以看到设备的UI树,然后我们选中某个UI控件,就可以对这个选中的控件进行各种操作。

image

特别注意:因为 Airtest 和 poco 都是基于 python 语法的,所以我们编写的测试脚本都应该符合 python 语法。

我们建议不懂 python 的新手,可以在网上自行查找一些 python 教程来学习一下,基本上学会一些基本语法、变量、条件语句和循环语句,就可以满足初期的学习需求;更多关于python的高级语法可以等用到的时候再去学习。

如何查找资料

① 最新的官方文档

目前我们最新的官方文档 Airtest Project Docs 的地址为:https://airtest.doc.io.netease.com/ 。

在这里你可以看到关于Airtest、poco和AirtestIDE的详细教程;还可以查看到使用这两个自动化测试框架常遇到的问题和一些我们给出的脚本demo:

image

而在博客里面,我们会定期更新的一些高级教程和实际应用的例子,方便大家学习;博客原文来自于我们的官方公众号“AirtestProject”。

② 查询各种方法的api

如果你想要查询某个方法详细的用法,或者是查看它的源码,可以在Airtest和poco的项目文档中查询到:

Airtest的项目文档为:https://airtest.readthedocs.io/zh_CN/latest/index.html

image

poco的项目文档为:https://poco.readthedocs.io/zh_CN/latest/index.html

image

③ 官方公众号“AirtestProject”

在公众号菜单的往期教程里面,可以查看到一些高阶教程、实战例子和常见问题:

image

我们的官方公众号二维码:

image

遇到问题如何提问

查看相应教程

对于新手来说,难免会遇到各种各样的问题。设备连接不上?脚本运行报错?...

对于大部分的常见问题,我们已经收集起来放在了我们的官方文档上面:

① 安卓设备连接常见问题可以查看:https://airtest.doc.io.netease.com/IDEdocs/device_connection/2_android_faq/

② 脚本运行常见问题可以官方文档对应的部分或者公众号的答疑系列教程

在交流群提问

另外,我们还专门设有开发者沟通交流群,供大家互相探讨自动化测试相关的问题:

目前1群已满,大家可以加入2群(QQ1017250147)。

注意:提问时最好附上使用的设备详情和IDE版本等,然后贴出报错的log图片,可以方便群内管理员迅速定位问题。

提问规范:https://airtest.doc.io.netease.com/IDEdocs/getting_started/crash_abnormalProblem/#airtestide_1

在公众号留言

有些用户会在我们的官方公众号留言提问,当然也是可以的;工作日内我们都会有专门的人员回复,但是不保证时效。

所以我们更建议大家多查询我们整理好的问题文档,或者直接加群提问;群内不仅有项目管理员,还有很多热心的大佬会帮助你解决问题。

到GitHub上提issue

如果你在使用过程中发现了bug,或者有建议想提给我们,可以到我们项目的GitHub地址上给我们提一个issue:https://github.com/AirtestProject/AirtestIDE/issues 。这样bug被解决或者建议被采纳时,你就可以收到通知了。