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

最新推荐文章于 2024-08-08 18:56:23 发布

程序员汤圆

最新推荐文章于 2024-08-08 18:56:23 发布

阅读量365

点赞数 4

分类专栏：面试软件测试软件测试面试文章标签： ui 职场和发展面试软件测试软件测试面试

本文链接：https://blog.csdn.net/2401_83014911/article/details/141028516

版权

软件测试同时被 3 个专栏收录

252 篇文章 0 订阅

订阅专栏

面试

63 篇文章 0 订阅

订阅专栏

软件测试面试

58 篇文章 0 订阅

订阅专栏

本文是我们《手把手教你搭建基于Airtest的App&Web UI自动化测试框架》系列文章中的支线文章，用于在AirtestIDE中进行测试脚本编写的说明。

Airtest框架

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

Poco框架

Poco 是一款 基于UI控件识别 的自动化测试框架，目前支持Android原生、iOS原生、Unity3D、cocos2dx、UE4和Egret等平台，也可以在其他引擎中自行接入poco-sdk来使用。

AirtestIDE

AirtestIDE 是一款跨平台的 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) doesn't 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 Recording：Poco脚本自动录制功能，随鼠标对控件进行点击、滑动等操作，会自动在脚本编辑窗口生成对应的Poco操作脚本

3.3 代码示例

下面这段代码例子将演示一个简单的功能：代开App,等待页面加载完成，使用Airtest验证相应图片是否存在，最后使用poco验证相应位置信息是否正确：

# -*- encoding=utf8 -*-
__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__,
logdir=True,
devices=["android://127.0.0.1:5037/93e445f8?cap_method=JAVACAP&touch_method=MAXTOUCH&",],
project_root="D:/gmluo-auto-test/auto-test-android/auto_test_android_migu/airtest_script")
"""初始化poco对象"""
poco = AndroidUiautomationPoco(use_airtest_input=True, screenshot_each_action=False)
"""应用apk名称赋值"""
package_name="cmccwm.mobilemusic"
"""关闭当前应用"""
stop_app(package_name)#通过应用apk名称方式启动app应用
"""启动相关应用"""
start_app(package_name)#通过应用apk名称方式启动app应用
"""@test_script_content_start"""
wait(Template(r"tpl1712827950840.png", record_pos=(0.069, -0.375), resolution=(1080, 2340)))
wait(Template(r"tpl1712827962637.png", record_pos=(-0.4, -0.946), resolution=(1080, 2340)))
assert_exists(Template(r"tpl1712828005781.png", record_pos=(0.004, -0.293), resolution=(1080, 2340)), "宫格模块检查")
assert_exists(Template(r"tpl1712828014609.png", record_pos=(-0.342, -0.001), resolution=(1080, 2340)), "推荐歌单模块检查")
assert_exists(Template(r"tpl1712828024239.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 脚本，自动生成的初始化脚本带有 logdir=True ，所以默认也是保存了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__,logpath=True,output=r"D:\test\report02\log.html")

② 使用LogToHtml类：

h1 = LogToHtml(script_root=r'D:\test\report01.air', log_root=r"D:\test\report01.air\log", export_dir=r"D:\test\report02" ,logfile=r'D:\test\report01.air\log\log.txt', lang='en', plugins=None) h1.report()