五、详解IDE的脚本编辑窗口¶
1. 前言¶
在AirtestIDE的脚本编辑窗中，提供了很多与脚本编写相关的小功能，可以帮助我们更好地编写Airtest/Poco自动化脚本，本文我们将详细了解脚本编辑窗的功能和使用技巧。
2. 图片编辑器功能¶
在AirtestIDE的脚本编辑窗里编写Airtest的图像脚本，我们可以利用图片编辑器的功能，来预览图像脚本在当前画面的匹配率，以及修改图像的各个参数。
1）进入图像编辑器¶
在脚本编辑区内双击图片，即可弹出图片编辑器。修改后点击OK按钮实施修改，Cancel按钮则为放弃修改。
2）图片截图预览功能¶
我们提供了一个可以预览该截图在当前画面上的匹配率的功能，在图片编辑器内点击 Snapshot Recognition 按钮，将会截取当前的手机屏幕画面，并且进行一次识别，识别成功的话会在截图上面标注出识别区域，方便大家进行截图的调试。
同时，在屏幕截图显示区域点击鼠标右键，弹出的右键菜单中可以选择再次对手机设备截图、重新进行识别等操作。
3）参数修改说明¶
注解
目前图片识别中，每次识别时，只要识别结果的可信度>阈值 threshold 即认为是识别通过。如果识别到错误的位置，可以通过调节 threshold 进行准确度调整。
① filename（图像文件名）¶
设置图像文件的名称，修改后点击OK保存时，会提示是否确认修改：
确认修改之后，会在当前脚本目录下将该图片复制1个副本并且命名为新修改的名称：
② threshold(浮点类型)¶
设置图像匹配的阈值，范围是[0.0, 1.0]，默认0.7。
③ target_pos(整型)¶
设置了在匹配结果图像上的操作位置，标记点为1-9，默认为5
④ 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脚本的运行效果：
注意
部分版本的IDE 在选中Poco脚本右键单独运行时，会报 poco is not defined 的错误，这是因为此时仅仅只选中的Poco脚本，但未选中Poco的初始化脚本，导致单独运行时没有额外初始化Poco，解决办法是选中待调试的Poco脚本时，同时选中Poco的初始化脚本。
4. 其它技巧¶
1）查看图片保存位置¶
在IDE的脚本编辑窗口，把鼠标移动到图片上面，即可显示该图像保存的路径：
2）图片/代码模式切换¶
Airtest图像脚本，本质上也是Python脚本，我们可以在IDE的脚本编辑窗口，右键选择 图片/代码模式切换 ，切换到纯代码查看：
注意
在我们对整个桌面进行自动化测试时，为避免IDE脚本编辑窗口的图像会识别结果造成影响，我们可以将IDE最小化，或者利用 图片/代码模式切换 功能，将图片转换成纯代码，避免错误识别到脚本编辑窗口的图像脚本上去。
3）快捷功能¶
点击脚本编辑窗口右上角的下拉按钮，即可唤出脚本编辑窗口给我们提供的快捷功能（或者右键点击脚本名称唤出）：
① 打开当前项目目录¶
用于快速打开当前项目的文件夹。
② 打开报告文件目录¶
用于快速打开IDE生成的报告文件夹。
③ 导出报告¶
用于快速导出报告，未导出的报告只能在本地查看，导出的报告可以发送给别人查看（在非本地查看）。
④ 压缩当前脚本.zip¶
快速压缩整个脚本文件，方便发送。
⑤ 清理多余图片¶
一键清理脚本中未使用到的图片文件。
⑥ 文件异常恢复¶
恢复异常脚本或者找回历史版本。
4）快速注释与取消注释¶
在IDE的脚本编辑窗口，选中1行或者多行脚本，按下 ctrl+/ 键即可快速注释脚本。
同理，选中1行或者多行已经注释的脚本，再次按下 ctrl+/ 键即可快速取消注释。
5）快速缩进与取消缩进¶
在IDE的脚本编辑窗口，选中1行或者多行脚本，按下 Tab 键即可快速实现缩进，需要多次缩进则按下多次 Tab 。
选中1行或者多行脚本，按下 shift+Tab 键即可快速实现取消缩进，需要取消多个缩进，则多次按下 shift+Tab 键即可。