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 。
可以在标题中加入“Airtest1.2.9”之类的字眼,方便我们快速筛选和排查。