此文章来源于项目官方公众号：“AirtestProject”
版权声明：允许转载，但转载必须保留原链接；请勿用作商业或者非法用途
1. 前言
本次更新为Airtest库更新，主要是新增了设备释放接口、大量断言的语句，新增了对Android 12L的支持，对安装接口的增强，和若干bug的修复。
2. Airtest版本提升至1.2.7
1）新增了
device.disconnect()
接口
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
的增强
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 官网
：http://airtest.netease.com/
Airtest 教程官网
：https://airtest.doc.io.netease.com/
搭建企业私有云服务
：https://airlab.163.com/b2b
官方答疑 Q 群：117973773
呀，这么认真都看到这里啦，帮忙点个赞或者收藏支持下我把，灰常感谢~