八、微信小程序和小游戏自动化测试

Airtest Project自动化测试方案除了支持原生应用,游戏,Web之外,也支持了最新推出的微信小程序和小游戏平台。下面我们分别来看下如何利用Airtest Project进行小程序和小游戏的自动化测试:

1. 小程序

对于微信小程序,我们既可以利用 Airtest的图像识别的方式 来进行自动化测试,也可以直接利用原生平台的Poco进行控件识别。

微信小程序目前采用的内核信息可以参考官方文档。我们用最新版(V8.0.10)的微信测试,可以直接用Android或者iOS poco模式对相应平台的小程序进行控件识别。如果无法使用,可能是由于部分Android设备的Webview内核设置问题,请参考文档进行修改。

下面来分别看下Android和iOS上的效果:

1)Android小程序

连接Android手机,并打开微信小程序,以星巴克小程序为例,在Airtest IDE中选择Android模式,可以对页面进行控件识别:

image-20210825171030279

下述代码可以点击星巴克小程序上面 text 属性为 “一起恰秋味” 的控件:

  1. from airtest.core.api import *
  2. auto_setup(__file__)
  3. from poco.drivers.android.uiautomation import AndroidUiautomationPoco
  4. poco = AndroidUiautomationPoco(use_airtest_input=True, screenshot_each_action=False)
  5. poco(text="一起恰秋味").click()

2) iOS小程序

连接iOS手机,并打开微信小程序,以星巴克小程序为例,在Airtest IDE中选择iOS模式,可以对页面进行控件识别:

image

如下示例代码可以实现在iOS上点击对应卡面的操作:

  1. from airtest.core.api import *
  2. auto_setup(__file__)
  3. from poco.drivers.ios import iosPoco
  4. poco = iosPoco()
  5. while not poco("感恩有你").exists():
  6. poco.scroll(direction='vertical', percent=0.3, duration=1.0)
  7. snapshot()
  8. poco("感恩有你").click()

2. 小游戏

Airtest 可以使用 基于图像识别 的方式对小游戏进行自动化测试,此外,Poco UI控件检索也对使用白鹭引擎开发的小游戏进行了支持。Poco的接入需要在源代码中接入poco-sdk,具体接入指引如下:

1) 环境配置

  • 首先下载 poco-sdk
  • 然后在egretProperties.json中修改modules属性,添加红框内相应字段,其中name属性必须为poco
  • 路径可以是相对路径也可以是绝对路径,具体可以参考白鹭引擎说明文档中有关于 modules字段的说明

添加和修改modules属性

  • 然后通过快捷键 ctrl+` 呼出终端 在终端中执行命令 egret build -e

八、微信小程序和小游戏自动化测试 - 图4

  • 在入口文件main.ts的rungame函数中新建类型为PocoManager的对象,并且传入this.stage

八、微信小程序和小游戏自动化测试 - 图5

  • 运行代码,启动游戏
  • 最后在在终端中输入python -m poco.utils.net.stdbroker ws://*:5003 tcp://*:15004 ,打开代理服务器broker
  • 其中websocket端口默认为5003,如果有更改的需要,可以在新建pocomanager的时候传入端口参数

八、微信小程序和小游戏自动化测试 - 图6

2)使用AirtestIDE连接

AirtestIDE支持Android和iOS手机连接,可以在手机上打开Egret页面(或者微信小程序/游戏),然后通过AirtestIDE进行连接,Windows和MacOS版本IDE都可以使用。连接基本原理为:

image

具体步骤如下:

  • 通过usb连接Android手机,确认adb devices连接ok,在电脑上执行如下命令,将手机的5003端口映射到电脑的5003端口
  1. adb reverse tcp:5003 tcp:5003
  • 在电脑上启动broker:
  1. python -m poco.utils.net.stdbroker "ws://*:5003" "tcp://*:15004"
  • 启动broker之后,在手机上访问Egret的页面(需要使用全屏模式保证坐标准确)。访问的时候,broker会打印手机连接上的log,如下:
  1. ~ python -m poco.utils.net.stdbroker "ws://*:5003" "tcp://*:15004"
  2. server listens on ("0.0.0.0", 5003) transport websocket
  3. server listens on ("0.0.0.0", 15004) transport socket
  4. StdBroker on.
  5. server on accept. <poco.utils.net.transport.ws.MyWsApp object at 0x1100620d0>
  • 打开AirtestIDE连接手机,选择poco Std-broker模式,即可以看到UI层级结构。同时broker会打印连接日志:
  1. server on accept. <poco.utils.net.transport.ws.MyWsApp object at 0x10d03d2d0>
  2. accept from: ('127.0.0.1', 56872)
  3. received_message from ('127.0.0.1', 56323) {"id":"2a0ce828-132e-4d15-a645-55493d7eaf4b","jsonrpc":"2.0","result":{"children"

AirtestIDE界面如下:

image

在AirtestIDE里编写脚本并运行,还可以查看报告

image