写出你的第一个App UI自动化测试脚本

Airtest框架Airtest是一款基于Python的、跨平台的UI自动化测试 框架。因为它基于图像识别的原理所以适用于所有Android、 iOS和 Windows应用。因此不论是手机上的app还是游戏或者是Windows电脑上面的应用或者游戏等等都可以用Airtest框架。Poco框架Poco 是一款基于UI控件识别的自动化测试框架目前支持Android原生、iOS原生、Unity3D、cocos2dx、UE4和Egret等平台也可以在其他引擎中自行接入poco-sdk来使用。AirtestIDEAirtestIDE 是一款跨平台的UI自动化测试编辑器内置了Airtest和Poco的相关插件功能能够使用它快速简单地编写 Airtest 和 Poco 代码。建议先学习Python的基础语法知识我们的项目自动化脚本以及 Airtest 和 Poco 都是基于Python的因此写出来的所有脚本都是Python代码建议同学们在使用前先学习Python的基础语法知识。使用 AirtestIDE 来帮助你编写自动化测试脚本建议使用 AirtestIDE 来帮助你编写自动化测试脚本。在编写自动化脚本时可以配合我们提供的AirtestIDE编辑器能够快速编写脚本。熟练上手 Airtest 和 poco 以后如果有需要的话则可以尝试脱离IDE来跑测试脚本比如在本地命令行 上运行比如在其他Python编辑器比如pycharm上运行等等当然你也可以使用自己喜欢的Python编辑器来编写脚本。1. 设备Android连接AirtestIDE支持市面上几乎绝大多数Android手机、Android模拟器1.1 在AirtestIDE里连接Android手机使用USB线连接手机和电脑、安装好对应驱动、打开开发者模式的USB调试选项并在AirtestIDE中尝试连接手机。在成功连上手机后我们就能够在AirtestIDE里操作手机画面就像下图中这样接下来就可以开始用这台手机编写脚本了。1.2 连不上的典型现象在完成以上基本操作之后发现IDE还是连不上这些安卓设备可参考下方几个解决方案① 在IDE的设备连接窗口看到待测设备的ADB status是 unauthorized 。这时候你就要看下手机上是否出现了1个允许USB调试的弹窗看到了点击确认即可。如果没看到的话那就拔插设备重新来一遍基础操作。② 连接设备的时候log查看窗出现1个 AdbShellError 的报错这个情况就复杂的多。因为造成这个报错的原因有很多种比如出现ADB冲突这时候往往会出现 adb server version (40) doesnt match this client (39); killing... 这样的提示。又或者是你的手机没有成功安装Airtest的输入法Yosemite.apk。当然更多的可能是你这个真机是某些特殊品牌需要开启一些额外的设置才能够使用我们的Airtest这个额外设置因设备而异。③ 连接上设备之后黑屏、闪退或者不能点击屏幕。这时候只能请出3个备选连接参数了通常情况下黑屏或者闪退可以勾选第一个 use Javacap 不能点击屏幕的特殊设备可以勾选最后一个 use Adb Touch 。2. 脚本录制AirtestIDE支持Airtest、Poco和airtest-selenium脚本的录制录制脚本功能的使用都是有一定前提的① Airtest录制保证IDE的设备连接窗口连接上了安卓设备、iOS设备或者Windows窗口嵌入不嵌入都行。② Poco录制保证IDE的设备连接连接上了安卓设备或者iOS设备不支持Windows桌面应用并且在poco辅助窗中选择了待测的poco模式刷出了正常的UI树。能连接上设备不能刷出UI树的情况请参考我们的 官方文档 给出的解决办法。另外同学们要明确录制脚本只适合简单的点击、滑动等操作且可以帮助新手同学快速上手框架的部分api。但是仅仅依赖录制功能就完成内容复杂的自动化脚本是不现实的而且录制出来的脚本并不全是符合同学们期待的脚本有可能存在录制出来的截图脚本回放时不通过的情况或者录制出来的poco脚本层次过深导致回放非常不稳定的情况。这时候我们就要根据实际情况来优化这些录制出来的脚本了。3. 脚本编写录制不是万能的最终还是要自己会用框架的api才能编写出更加丰富功能更加符合需求的自动化测试脚本。3.1 如何编写Airtest脚本首先IDE给我们提供的api快捷键不能放过这里面几乎包含了Airtest的所有核心API鼠标移动上去还可以看到参数详情非常便捷其次Airtest提供了 中文版的API文档 核心API还有详细的示例供大家学习基本上掌握了核心API就可以实现我们的大部分测试需求了剩下的就是python脚本能力的体现了比如如何编写判断语句、循环语句等等。3.2 使用Poco对 Android原生应用 进行测试Poco支持直接对任何Android原生应用非游戏引擎、非webview进行UI层次结构识别用法上与Poco在其他平台上一模一样。在AirtestIDE的Poco Assistant面板中选择Android模式之后AirtestIDE会开始自动向手机里安装Pocoservice.apk和Pocoservice-test.apk部分型号手机需要手动点击确认安装才能顺利安装。安装完成后AirtestIDE会自动启动PocoService它会定时抓取 Android上界面的层次结构信息稍等片刻就可以在AirtestIDE界面中看到当前界面的UI层次结构树。点击UI树上的任意节点可以Log面板中看到该节点的所有属性同时设备画面中将出现方框把对应位置框选出来方便定位节点。同时Poco辅助窗还给我们提供了3个辅助功能功能分别如下Poco Pause锁定当前画面并检索当前画面的控件单击需要检索的控件log查看窗会出现该控件的详细信息Poco Inspector不锁定当前画面检索控件鼠标移动到哪个控件log查看窗就会显示哪个控件的详细信息并且鼠标对控件进行点击时设备画面也会实时响应Poco Auto RecordingPoco脚本自动录制功能随鼠标对控件进行点击、滑动等操作会自动在脚本编辑窗口生成对应的Poco操作脚本3.3 代码示例下面这段代码例子将演示一个简单的功能代开App,等待页面加载完成使用Airtest验证相应图片是否存在最后使用poco验证相应位置信息是否正确# -*- encodingutf8 -*- __author__ gmluo __title__首页TAB 页面模块检查 __desc__ 首页TAB 页面模块 检查 from airtest.core.api import * from airtest.cli.parser import cli_setup from poco.drivers.android.uiautomation import AndroidUiautomationPoco if not cli_setup(): auto_setup(__file__, logdirTrue, devices[android://127.0.0.1:5037/93e445f8?cap_methodJAVACAPtouch_methodMAXTOUCH,], project_rootD:/gmluo-auto-test/auto-test-android/auto_test_android_migu/airtest_script) 初始化poco对象 poco AndroidUiautomationPoco(use_airtest_inputTrue, screenshot_each_actionFalse) 应用apk名称赋值 package_namecmccwm.mobilemusic 关闭当前应用 stop_app(package_name)#通过应用apk名称方式启动app应用 启动相关应用 start_app(package_name)#通过应用apk名称方式启动app应用 test_script_content_start wait(Template(rtpl1712827950840.png, record_pos(0.069, -0.375), resolution(1080, 2340))) wait(Template(rtpl1712827962637.png, record_pos(-0.4, -0.946), resolution(1080, 2340))) assert_exists(Template(rtpl1712828005781.png, record_pos(0.004, -0.293), resolution(1080, 2340)), 宫格模块检查) assert_exists(Template(rtpl1712828014609.png, record_pos(-0.342, -0.001), resolution(1080, 2340)), 推荐歌单模块检查) assert_exists(Template(rtpl1712828024239.png, record_pos(0.013, 0.975), resolution(1080, 2340)), 底部TAB按钮模块检查) test_script_content_end 关闭当前应用 stop_app(package_name)#通过应用apk名称方式启动app应用4. 脚本运行4.1 如何运行如果是在AirtestIDE运行脚本那直接快捷键F5或者点击顶部菜单栏的运行按钮即可那么脱离AirtestIDE如何运行脚本呢情况大致分为2种① 一种是在命令行使用 airtest run test.air命令运行该命令后面还可以跟着设备参数、log参数和录屏参数--device用来指定连接的被测设备--log用来指定log内容和截图存放的目录--recording运行脚本时进行录屏操作运行脚本时带不带参数取决于你的脚本是否已经完成了连接设备、保存log、录屏等工作如果脚本里面已经包含这些步骤那命令行运行时这些参数就不用带了如果你的脚本并没有完成这些步骤那命令行运行脚本时就要根据自己的需要有选择性地带上这些参数。② 第二种就是在别的python编辑器上运行我们的airtest脚本比如pycharm。运行的话一般没什么问题点击编辑器对应的运行脚本按钮即可。重要的是编写脚本的规范性、以及运行环境的建设问题。以pycharm为例我们在运行脚本之前需要部署好当前的python环境把脚本中用到的库比如airtest、pocoui或者airtest-selenium装好。另外如果脚本是AirtestIDE迁移过来的还需要特别注意是否有设备连接语句、截图路径是否正确等等。4.2 运行后的常见问题图像找不到像 Picture xxx not found in screen 可能是新手同学在学习Airtest脚本的时候最常遇到的问题了很多同学会说明明我用肉眼已经看到截图是存在于设备画面上的为什么运行总是不通过或者是截图脚本运行是通过了但是点到了别的地方去并不是点到了我的预期位置上。首先我们要了解截图脚本运行的本质。实际上运行我们的截图脚本就是1个图像识别的过程airtest会用多个图像识别算法去设备画面里面匹配我们的截图。算法并不是人眼它只能依靠截图的一些向量特征或者特征点来匹配结果这就意味着它匹配出来的结果会出现不满足我们实际预期的情况。4.3 运行后的其它语法问题比如 invalid syntax 或者 API的用法报错这些问题都是没有任何捷径的基本的python语法比如符号的完整性、缩进格式的统一性可以直接网上看一些python基础教程来学习。5.生成报告编写完脚本之后先运行脚本再生成报告右键单独运行某一条脚本不算正式运行脚本所以不会保存log内容也就意味着不会生成有log内容的报告。5.1 在IDE生成报告在AirtestIDE运行 .air 脚本时运行命令默认是带log参数的所以运行脚本之后都会保存运行的log内容运行结束之后我们直接点击顶部菜单栏的查看报告按钮即可一键生成并打开HTML格式的报告。在AirtestIDE新建 .py 脚本自动生成的初始化脚本带有 logdirTrue 所以默认也是保存了log内容的同理运行完毕之后也可以点击顶部菜单栏的查看报告按钮一键生成并打开HTML格式的报告。5.2 命令行生成报告上文我们了解了 airtest run test.air 命令用于运行脚本使用该命令在命令行运行脚本之后我们可以使用生成报告的指令airtest report test.air 来生成该脚本的Airtest报告。命令行生成报告可带的参数非常多--log_root指定log内容和截图文件所在的目录--outfile指定生成报告的目录--lang指定报告语言可以是中文/英文--export导出一个包含所有资源的报告文件--static_root指定静态资源文件的路径5.3 脚本生成报告用python脚本生成报告有2种方式① 使用simple_report接口simple_report(__file__,logpathTrue,outputrD:\test\report02\log.html)② 使用LogToHtml类h1 LogToHtml(script_rootrD:\test\report01.air, log_rootrD:\test\report01.air\log, export_dirrD:\test\report02 ,logfilerD:\test\report01.air\log\log.txt, langen, pluginsNone) h1.report()5.4 生成的报告为空报告为空大概率是因为log.txt文件的内容为空要么是没有保存log要么是生成报告的语句放在了脚本开头导致还没运行到实际的步骤就已经生成了一份空报告。总结本文基于Airtest框架通过Android平台App测试脚本的设计从设备连接--脚本录制/编写--脚本运行--生成报告进行了第一个APP UI自动化测试脚本实现介绍。最后下方这份完整的软件测试 视频教程已经整理上传完成需要的朋友们可以自行领取【保证100%免费】​​​软件测试面试文档我们学习必然是为了找到高薪的工作下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料并且有字节大佬给出了权威的解答刷完这一套面试资料相信大家都能找到满意的工作。