【更新公告】Airtest更新至1.2.9版本

1. 前言

本次更新为Airtest库更新,版本提升至1.2.9,主要新增 对Android13的支持新增Windows和iOS的录屏接口 等。

2. 更新功能

1)新增对Android13的支持

Airtest1.2.9版本新增了对Android13设备的支持,有该系统设备连接/自动化需求的同学,请务必把使用的Airtest刚更新至1.2.9版本。

2)新增Windows、iOS录屏接口,优化Android录屏

目前录屏功能不仅支持Android设备,还支持了windows、iOS设备!

函数 start_recording() 的参数修改如下:

  • max_time : 录屏最长时间限制,默认为1800,单位是秒
  • output : 录像保存文件地址, 默认为 None ,将会自动保存在log目录下,自动以当前时间命名

特别注意:原先 output 参数在 stop_recording 中,现在改为在 start_recording 里!

  • fps=10 :输出视频的帧率,目前暂时限定不超过10fps,默认为10(仅对ffmpeg和cv2生效)
  • mode="ffmpeg" : 保存视频的后台,可选 'ffmpeg' 'cv2' 'yosemite',三种模式的区别如下:

ffmpeg :对机型兼容较好,但cpu占用较高,第一次运行将会预先下载ffmpeg,有一定的额外空间占用(几十M)

cv2 :无需占用额外空间,生成的视频体积比ffmpeg更大

yosemite :Android旧版本的录屏方案,假如当前设备是Android,默认会使用这个模式录屏,必须要事先安装 Yosemite.apk ,并支持旧的参数,帧率比ffmpeg和cv2要高,但兼容性差,有一些手机不支持

  • snapshot_sleep=0.001 : 截图间隔
  • orientation=0 : 视频朝向模式 1 为竖屏;模式 2 为横屏;模式 0 为方形填充,默认是0

其中大部分参数使用默认值即可,最重要的参数有两个:

① 新增参数 orientation
当跑测过程中大部分时间是竖屏时,可以考虑将 orientation=1 ,或 orientation="portrait"

② 当跑测过程中大部分是横屏,可以 orientation=2 ,或 orientation="lanscape" ,适合游戏等横屏应用;

③ 横竖屏都有可能的话,可以不指定参数,默认值为0,会用一个正方形来容纳视频内容,方便横竖屏转换

output=xxx.mp4,默认将录屏文件存放在log目录下,如果有重命名需求的话可以传这个参数,否则直接所有参数用默认值即可

录屏代码示例:

Record 30 seconds of video and export to the current directory test.mp4:

>>> from airtest.core.api import connect_device, sleep
>>> dev = connect_device("Android:///")
>>> save_path = dev.start_recording(output="test.mp4")
>>> sleep(30)
>>> dev.stop_recording()
>>> print(save_path)

>>> # the screen is portrait
>>> portrait_mp4 = dev.start_recording(output="portrait.mp4", orientation=1)  # or orientation="portrait"
>>> sleep(30)
>>> dev.stop_recording()

>>> # the screen is landscape
>>> landscape_mp4 = dev.start_recording(output="landscape.mp4", orientation=2)  # or orientation="landscape"
3)IOS支持传入udid参数

iOS的初始化字符串中,支持传入名为 serialno/udid/uuid 的字段,用于设置这台iOS的设备udid,示例:

>>> connect_device("iOS:///http://localhost:8100/?mjpeg_port=9100&&udid=00008020-001270842E88002E")  # iOS with mjpeg port and udid
>>> connect_device("iOS:///http://localhost:8100/?mjpeg_port=9100&&uuid=00008020-001270842E88002E")  # udid/uuid/serialno are all ok

该名称无论使用 udid/uuid/serialno 中任何一个名字传入都可以生效,可以在连接后,通过以下方式获取到这个值:

dev = connect_device("iOS:///http://localhost:8100/?udid=00008020-001270842E88002E")
print(dev.uuid)

增加这个参数的主要原因是,在wda中获取不到ios手机的udid,但在某些情况下可能需要用到这个值,因此支持主动传入保存。

3. 问题修复

1)修复了部分windows下,游戏无法正确截屏的问题

迭代了windows的 snapshot ,修复了部分游戏截屏图像重复、黑屏等问题,同时修复了在双屏下的截图区域错误问题。

2)修改了报告中对于运行结果是否成功的判定

原先的逻辑是:只要整个运行过程中出现 traceback ,就认为此次任务运行失败。

【图】1.2.7版本Airtest跑测结果示意

但通常会遇到一种情况是:在运行过程中会出现一些不太重要的脚本异常,我们希望脚本不卡在这里,而是 catch 住异常后继续往下跑,只要能跑到最后就算脚本成功。

【图】1.2.9版本Airtest跑测结果示意

因此将脚本的成功判断改为:当步骤列表的最后一个步骤有traceback,才认为本次脚本运行失败。

3)对报告中一些显示效果做了一点微调

① 做了一些样式调整,修复了一些显示问题;

② 报告html支持上下左右按键切换预览图片。

4. 如何更新

因本次更新仅更新了Airtest库,所以同学们目前只能在自己本地python环境中,将Airtest更新到最新版本:

pip install -U airtest

对于使用AirtestIDE的同学,可以等我们发布1.2.15版本的IDE,或者在旧版本AirtestIDE中设置使用本地python环境,然后将本地python环境的Airtest库升级到最新版本即可。

5. 其它问题

如同学们在使用新版的Airtest时遇到了一些问题无法解决,特别是录屏相关的问题,可以通过此网站向我们的开发者快速提单:https://airtest.netease.com/issue_create


Airtest官网https://airtest.netease.com/
Airtest教程官网https://airtest.doc.io.netease.com/
搭建企业私有云服务https://airlab.163.com/b2b

官方答疑 Q 群:117973773

呀,这么认真都看到这里啦,帮忙点个推荐支持一下呗,灰常感谢~
可以在标题中加入“Airtest1.2.9”之类的字眼,方便我们快速筛选和排查。

posted @ 2023-02-23 16:03  AirtestProject  阅读(108)  评论(0编辑  收藏  举报