【更新公告】Airtest更新至1.2.4

1. 前言

本次更新为Airtest更新，版本提升至1.2.4版本。

PS：AirtestIDE暂未更新，1.2.12版本的IDE自带的Airtest版本仍是1.2.3版本，不是最新的1.2.4版本。

2. 更新详情

1）新增对Android12的支持

新增Android 12的minicap截图支持。

如果在1.2.12版本的IDE中，连接不上Android12的设备，可以在本地python环境把Airtest更到1.2.4版本后，连接Android12的设备跑一个脚本之后，再用1.2.12版本的IDE来连接该设备。（当然，后续更新了AirtestIDE的版本之后，就可以直接连接，无需进行这些操作）

2）修复了1个启动录屏失败的问题

安卓在录屏强制中止的情况下，下一次启动录屏时优先清理之前的录屏再开始新录屏，有效避免了启动录屏失败的问题。

旧版本在录屏强制终止的情况下，重新开始录屏可能会出现如下的报错（需要手动结束录屏或者单独运行结束录屏的脚本之后才能正常重新开启录屏）：

3）优化了部分手机的输入问题

部分手机如oppo/vivo等，在没有安装/启用yosemite输入法时无法使用，改用 adb shell input text 输入（不支持中文）。

4）优化了 wake 接口解锁操作

wake 接口先尝试使用 keyevent224 和 82 解锁android屏幕，如果解锁失败，再尝试用yosemite解锁。

5）修复了部分极限情况的图像识别异常问题

计算置信度过程加入极限值噪点，修复纯色状态时置信度异常高的问题。RGB模式对极限值进行裁剪，修复色相角度计算异常的问题。

3. 如何更新

1）使用了AirtestIDE

因为本次更新只涉及Airtest框架更新，所以我们即使使用最新的1.2.12版本IDE自带的Python环境也是无法享受到的；

但是我们可以在AirtestIDE设置使用本地Python环境，然后在本地Python环境中将 Airtest 更新至1.2.4版本，这样在IDE运行脚本时，就会使用最新的Airtest框架。

2）使用本地Python环境/其它编辑器

使用本地Python环境同学，可以直接在对应的Python环境中，使用下述命令更新 Airtest：

pip install -U airtest

使用其它编辑器，比如pycharm的同学，可以直接找到当前项目使用的Python解释器，然后升级 Airtest 至1.2.4版本：

4. 更新注意事项

1）pip install 超时/报错

如果在下载/更新airtest库时，出现超时问题，请更换国内源来pip，比如使用清华源：

pip install -U airtest -i https://pypi.tuna.tsinghua.edu.cn/simple

如果出现报错，不能安装，则优先排查python版本的支持问题，airtest支持3≤python≤3.9。（python2不支持）

2）更新后numpy报错

如更新后出现类似 ImportError:numpy.core.multiarray failed to import 的报错，可以尝试将 numpy 库的版本降至1.19.3版本以下：

# 安装指定版本的库（命令参考）
pip install numpy==1.17.2

如果python环境里面的numpy版本＞1.9.13，安装时会出现类似 airtest 1.2.4 requires numpy≤1.19.3。请先将环境里面的numpy版本降低至要求以下，再来安装最新的airtest。

3）其它关于1.2.4版本Airtest的问题

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

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

---

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

官方答疑 Q 群：654700783

呀，这么认真都看到这里啦，帮忙点个推荐支持一下呗，灰常感谢~