前言
同学们催了很久的 关闭运行过程中截图的功能 和 python3.8、3.9安装airtest库的支持 终于来啦!
除了这些功能以外,1.1.7版本的airtest还跟新了很多小功能,并且修复了一系列的bug,赶紧查看下文一睹为快吧!
新增功能
1.用户自由选择是否保存截图
新增自由选择是否保存脚本运行过程中截图的功能,支持用2种方式实现。
1)运行命令传入--no-image参数
使用 airtest run xx.air
命令运行脚本时,可以传入 --no-image
这个新增的参数,就能够在任务运行过程中不再保存截图,示例:
airtest run test.air --device Android:/// --log logs/ --no-image 复制代码
2)脚本中设置ST.SAVE_IMAGE
如需在脚本中设置是否保存截图,我们可以使用 settings
新增的一个配置 ST.SAVE_IMAGE
,它的默认值为 True
, 如果改为 False
,就不保存截图,直到这个值再次设为 True
,示例:
from airtest.core.api import * # 暂时关闭截图 ST.SAVE_IMAGE = False touch((100, 100)) # 这条语句将不会保存当前画面图片 # 继续截图 ST.SAVE_IMAGE = True touch((100, 100)) 复制代码
(未截图的touch)
(截了图的touch)
2.把log()内容print到终端查看
之前我们调用 log()
接口来保存对应log到airtest报告中,但不方便我们在终端查看。所以1.1.7版本也同时将它print到当前终端,方便同学们查看。
3.python3.8、3.9支持安装airtest
去掉了 requirements.txt
里 opencv-contrib-python
的版本依赖,目前python3.8和python3.9都能安装airtest库了。
注意:python3.9如果安装完毕还不能使用airtest,报错 ImportError: numpy.core.multiarray failed to import
,可以手工将 numpy
版本号降级至1.19.3就能使用了。
pip install -U numpy==1.19.3 复制代码
4.start_recording()新增控制视频清晰度的参数
Android的录屏接口,start_recording()
修改了参数,增加了一个更简单的 bit_rate_level
参数,可以设置1-5的清晰度级别,默认为1,数字越大会越清晰, 示例:
from airtest.core.api import connect_device, sleep dev = connect_device("Android:///") # Record the screen with the lowest quality dev.start_recording(bit_rate_level=1) sleep(30) dev.stop_recording(output="test.mp4") 复制代码
5.简化生成报告的LogToHtml的参数传递
重新整理了 LogToHtml
里面路径相关的参数 logfile
和 logdir
,现在支持通过修改 ST.LOG_DIR
和 ST.LOG_FILE
,来自主设置 log
文件夹和 log.txt
的文件名。修改完毕后,还可以直接用 LogToHtml
生成报告,同时简化了参数的传递,示例:
from airtest.report.report import LogToHtml # 假设脚本为当前目录下的run.air, log目录为当前目录下的./log # 默认将认为log存放在ST.LOG_DIR中,如果ST.LOG_DIR为空,则尝试寻找当前目录下的log文件夹 rpt = LogToHtml("run.air") rpt.report() 复制代码
自定义 ST.LOG_DIR
和 ST.LOG_FILE
的示例:
from airtest.core.helper import set_logdir from airtest.report.report import * new_logfile = "log123.txt" new_logdir = "logs_new" # set logfile = "logs_new/log123.txt ST.LOG_FILE = new_logfile set_logdir(new_logdir) touch([100,100]) rpt = LogToHtml(r"D:/test/2234.air") # LogToHtml将会默认选择ST.LOG_FILE作为logfile,ST.LOG_DIR作为log_root,生成对应的log.html内容 rpt.report() 复制代码
bug修复
1.修复在 log()
接口中,如果 desc
参数包含关键词 assert
,可能会导致步骤被错误认定为 assert
步骤的问题。
2.修复了报告中缩略图没有被正确缩小的BUG(之前报告缩略图一般都只有3-5K大小,上个版本有问题,导致缩略图还是正常图片的大小)。
3.修复了在高版本android手机中,adb.start_app_timing
获取不到app启动时间的问题。
4.修复了 get_top_activity
在获取含有符号的包名时会报错的问题(java允许命名时出现符号的包名时会报错的问题(java允许命名时出现符号的包名时会报错的问题(java允许命名时出现符号)。
5.adb.file_size
更换了获取文件大小的命令,兼容更低版本的android手机,顺便修改了 minitouch
和 maxtouch
的安装过程,更简洁一点。
6.修复了多线程同时截图时的 generator already executing
报错。在获取sdk版本时偶尔会失败,尝试增加重试次数,但是是否修复此问题还有待观察。
7.修复部分手机初始化 minitouch
失败的问题,因为会有额外的log,导致正则匹配失败。
8.初始化 RotationWatcher
的时机改为在 get_display_info
的时候,避免在特殊情况下,因为它没有及时初始化,导致横竖屏转换时不能正确获取屏幕信息的问题。(假设连手机时是竖屏,开始运行后切换成了横屏,接下来运行纯poco脚本的 click
语句,就会导致点击位置横竖屏错误。因为poco语句在点击时不涉及截图,导致没有走到 rotationwatcher
的初始化逻辑里。)
9.Android.get_top_activity_name_and_pid
的功能与 get_top_activity
重复,因此删除一个。
如何更新
1.使用本地python环境的同学,可使用 pip install -U airtest
命令把本地python环境中的airtest库更新到最新版本。
2.使用AirtestIDE的同学,需要先把本地python环境的airtest库更新到最新版本之后,再在IDE的 选项-设置
中,自定义python.exe的路径。
3.另外如在安装airtest库的过程中,出现安装超时的报错,可以采用更换国内源的方式来安装:
# 使用阿里云 pip install airtest -i https://mirrors.aliyun.com/pypi/simple/ # 使用豆瓣源 pip install airtest -i https://pypi.doubanio.com/simple/ # 使用清华源 pip install airtest -i https://pypi.tuna.tsinghua.edu.cn/simple/ # 其他源...... 复制代码
关于airtest1.1.7的更多更新详情,可以查看github上的update文档:github.com/AirtestProj…
PS:为帮助新手同学更容易理解我们的API文档,我们 在一些核心API中新增了非常多的代码示例 供大家模仿学习,详情可以查看我们的官方API文档。(airtest.readthedocs.io/zh_CN/lates…