五、详解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_step 和 scale_max 。scale_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 键即可。