【更新公告】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 。

可以在标题中加入“Airtest1.2.9”之类的字眼，方便我们快速筛选和排查。

最后： 下方这份完整的软件测试视频学习教程已经整理上传完成，朋友们如果需要可以自行免费领取 【保证100%免费】

这些资料，对于【软件测试】的朋友来说应该是最全面最完整的备战仓库，这个仓库也陪伴上万个测试工程师们走过最艰难的路程，希望也能帮助到你!