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

1. 前言

本次更新为Airtest库更新，主要是新增了设备释放接口、大量断言的语句，新增了对Android 12L的支持，对安装接口的增强，和若干bug的修复。

2. Airtest版本提升至1.2.7

1）新增了device.disconnect()接口

原先的Airtest，在脚本长时间运行、或是使用了AirtestIDE反复连接多个不同手机时，可能会 建立大量adb连接未释放 ，一直占用资源。

这也会导致在部分手机上，反复切换横屏和竖屏应用时，会有概率 出现屏幕有一半内容变成黑屏 的问题。

因此，1.2.7版本的Airtest新增了device.disconnect()接口，用于：

• 在脚本中允许手动调用，让设备创建出的所有adb连接都强制释放掉，dev.disconnect()，如果还要继续使用这个设备对象，最好重新再创建一次 dev = connect_device("android:///")
• 同时对连接的创建进行了更进一步的清理操作，避免黑屏问题的发生

2）新增了大量的断言语句

在脚本编写中，断言语句是非常重要的组成部分，但airtest旧版只支持 assert_exists 和 assert_equal 两种类型的断言语句。

现在Airtest1.2.7版本，将所有断言语句单独放在 airtest/core/assertions.py 中，增加了更多类型，方便脚本编写工作。

目前Airtest1.2.7支持的断言列表:

• assert_exists
• assert_not_exists
• assert_equal
• assert_not_equal
• assert_true
• assert_false
• assert_is
• assert_is_not
• assert_is_none
• assert_is_not_none
• assert_in
• assert_not_in
• assert_is_instance
• assert_not_is_instance
• assert_greater
• assert_greater_equal
• assert_less
• assert_less_equal

我们也可以在Airtest的API文档中，找到所有断言接口及其说明：https://airtest.readthedocs.io/en/latest/all_module/airtest.core.assertions.html 。

3）支持设置断言时附带当前截图

Airtest1.2.7除了让断言语句更加丰富以外，还支持设置断言时，是否附带截取当前画面的图片，然后显示在Airtest报告中，这样报告的断言内容会更加清晰，也更具有airtest的截图特色：

# 默认情况下，断言截图会开启
assert_exists()

# 如不需要断言时截取当前画面，则可以设置关闭断言的截图
assert_exists(截图,snapshot=False)

4）新增对Android12L的支持

Airtest1.2.7已增加 minicap 对android 12L的支持，Poco的支持可以将pocoui更新至1.0.88版本。

5）安装接口pm_install的增强

Airtest1.2.7对 pm_install 接口进行了较大的增强：

• 支持了安装参数的传入（与 adb.install 保持一致），
• 支持了中文路径、一些包含特殊符号路径
• 对路径的改动同时影响到了 adb.pull() 和 adb.push() 接口，支持了中文路径、包含斜杠的路径（比如 \g 这样的字符也会有问题）、包含特殊符号（空格、括号等）的路径
• 在 pm_install 安装完毕后，会进行 adb shell rm apk 的操作，但在部分低配机型上可能会在这一步卡住超时（实际已经删除完毕，但代码一直不结束，导致整个脚本卡死），因此增加timeout 30秒自动结束

6）logwrap增加截图参数

如果希望把自定义的函数也显示到airtest的报告中，可以使用 @logwrap，例如：

@logwrap
def func1():
    pass

如果希望在报告显示 func1内容的同时，还附带一张当前设备的截图的话，可以增加 snapshot=True 参数在 func1() 的定义中：

@logwrap
def func1(snapshot=True):
    pass

7）若干bug的修复

• 尝试修复偶现的一个报告读取不到图片导致生成报告失败的问题
• 兼容了adb 获取屏幕信息超时的情况
• 修复了一个 adb.text() 在输入字母+数字时可能会导致乱序的问题，同时支持空格

8）新增了3个PR的支持

• 在Windows环境下，初始化 airtest.core.win.Windows 对象时，允许开发者选择性跳过 connect() 方法中的 set_foreground() 功能
• 在 Android.get_render_resolution 中增加应用包名参数，
  使得 get_render_resolution 能够获取到除top activity以外的应用的渲染区域
• 修复win和linux的 start_app 缺少的传参

【tips】关于本版本更新内容的更多示例，可以持续关注我们后续的推文，后续都会展开给同学们介绍对应的接口实例。

3. 如何更新

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

pip install -U airtest

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

4. 其它问题

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

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

---

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

官方答疑 Q 群：117973773

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