Skip to content

五、详解IDE的脚本编辑窗口

1. 前言

在AirtestIDE的脚本编辑窗中,提供了很多与脚本编写相关的小功能,可以帮助我们更好地编写Airtest/Poco自动化脚本,本文我们将详细了解脚本编辑窗的功能和使用技巧。

2. 图片编辑器功能

在AirtestIDE的脚本编辑窗里编写Airtest的图像脚本,我们可以利用图片编辑器的功能,来预览图像脚本在当前画面的匹配率,以及修改图像的各个参数。

1)进入图像编辑器

在脚本编辑区内双击图片,即可弹出图片编辑器。修改后点击OK按钮实施修改,Cancel按钮则为放弃修改。

enter

2)图片截图预览功能

我们提供了一个可以预览该截图在当前画面上的匹配率的功能,在图片编辑器内点击 Snapshot Recognition 按钮,将会截取当前的手机屏幕画面,并且进行一次识别,识别成功的话会在截图上面标注出识别区域,方便大家进行截图的调试。

image-20211009154002568

同时,在屏幕截图显示区域点击鼠标右键,弹出的右键菜单中可以选择再次对手机设备截图、重新进行识别等操作。

3)参数修改说明

注解

目前图片识别中,每次识别时,只要识别结果的可信度>阈值 threshold 即认为是识别通过。如果识别到错误的位置,可以通过调节 threshold 进行准确度调整。

① filename(图像文件名)

设置图像文件的名称,修改后点击OK保存时,会提示是否确认修改:

image-20211009155017641

确认修改之后,会在当前脚本目录下将该图片复制1个副本并且命名为新修改的名称:

image-20211009155328574

② threshold(浮点类型)

设置图像匹配的阈值,范围是[0.0, 1.0],默认0.7。

③ target_pos(整型)

设置了在匹配结果图像上的操作位置,标记点为1-9,默认为5

image

④ rgb(bool类型)

设置在对识别结果进行可信度计算时是否使用rgb三通道(彩色识别),默认为False(即采用灰度图像进行可信对计算)。

⑤ scale_max(整型)

设置匹配的最大范围。在Airtest1.2.0版本,我们新增了1个图像识别的算法:mstpl。该算法拥有2个特有的参数:scale_stepscale_maxscale_max 默认值800, 取值范围 [700 , 2000],推荐值 740, 800, 1000。

⑥ scale_step(浮点类型)

设置搜索比例步长。也是Airtest1.2.0版本新增的mstpl算法的特有参数,默认值0.01,取值范围 [0.001, 0.1],推荐值 0.02, 0.005, 0.001。

3. 单独调试功能

IDE支持我们选中1行或者多行脚本右键单独执行,该功能可以帮助我们调试编写的Airtest或者Poco脚本的运行效果:

debug

debug02

注意

部分版本的IDE 在选中Poco脚本右键单独运行时,会报 poco is not defined 的错误,这是因为此时仅仅只选中的Poco脚本,但未选中Poco的初始化脚本,导致单独运行时没有额外初始化Poco,解决办法是选中待调试的Poco脚本时,同时选中Poco的初始化脚本。

4. 其它技巧

1)查看图片保存位置

在IDE的脚本编辑窗口,把鼠标移动到图片上面,即可显示该图像保存的路径:

image-20211009164236233

2)图片/代码模式切换

Airtest图像脚本,本质上也是Python脚本,我们可以在IDE的脚本编辑窗口,右键选择 图片/代码模式切换 ,切换到纯代码查看:

mode_change

注意

在我们对整个桌面进行自动化测试时,为避免IDE脚本编辑窗口的图像会识别结果造成影响,我们可以将IDE最小化,或者利用 图片/代码模式切换 功能,将图片转换成纯代码,避免错误识别到脚本编辑窗口的图像脚本上去。

3)快捷功能

点击脚本编辑窗口右上角的下拉按钮,即可唤出脚本编辑窗口给我们提供的快捷功能(或者右键点击脚本名称唤出):

image-20211009165132511

① 打开当前项目目录

用于快速打开当前项目的文件夹。

② 打开报告文件目录

用于快速打开IDE生成的报告文件夹。

③ 导出报告

用于快速导出报告,未导出的报告只能在本地查看,导出的报告可以发送给别人查看(在非本地查看)。

④ 压缩当前脚本.zip

快速压缩整个脚本文件,方便发送。

⑤ 清理多余图片

一键清理脚本中未使用到的图片文件。

⑥ 文件异常恢复

恢复异常脚本或者找回历史版本。

4)快速注释与取消注释

在IDE的脚本编辑窗口,选中1行或者多行脚本,按下 ctrl+/ 键即可快速注释脚本。

同理,选中1行或者多行已经注释的脚本,再次按下 ctrl+/ 键即可快速取消注释。

5)快速缩进与取消缩进

在IDE的脚本编辑窗口,选中1行或者多行脚本,按下 Tab 键即可快速实现缩进,需要多次缩进则按下多次 Tab

选中1行或者多行脚本,按下 shift+Tab 键即可快速实现取消缩进,需要取消多个缩进,则多次按下 shift+Tab 键即可。