此文章来源于项目官方公众号：“AirtestProject”
版权声明：允许转载，但转载必须保留原链接；请勿用作商业或者非法用途
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时遇到了一些问题无法解决，特别是录屏相关的问题，可以通过此网站向我们的开发者快速提单：airtest.netease.com/issue_creat… 。
可以在标题中加入“Airtest1.2.9”之类的字眼，方便我们快速筛选和排查。
