一、详解IDE的选项功能¶
在AirtestIDE的顶部菜单栏中,选项
这一设置包含了非常多实用的功能,今天我们来详细了解下。
1. 语言设置¶
单击选项
设置,然后在下拉框中选择语言
,可以设置AirtestIDE的语言为中文(zh)或者英文(en)。
2. 皮肤主题设置¶
单击选项
设置,然后在下拉框中选择皮肤
,可以设置AirtestIDE的主题为暗黑主题或者是浅色主题MoonLight
。
3. 更多设置¶
在IDE的选项-设置
中,还存在更多的功能:
1)Device¶
在Device下,我们可以设置显示坐标、选择Windows无嵌入模式以及设置设备窗口显示的手机分辨率等等:
① 实时坐标显示与相对坐标¶
仅勾选 实时坐标显示
选项,可以实时在手机屏幕画面上显示出鼠标位置的绝对坐标,方便大家查看以及获取坐标位置。此时 点击鼠标右键 ,还可以自动将当前坐标信息复制到剪贴板中,在代码里只需要直接粘贴即可插入点击位置的坐标。
在勾选了实时显示坐标
的情况下,再勾选 相对坐标
选项,将会以(0, 0) 到 (1, 1) 为范围显示出相对坐标。使用相对坐标可以避免跨分辨率的操作点超出屏幕的问题,使坐标操作兼容性更好。
(图示左侧显示的是绝对坐标;右侧显示的是相对坐标)
注意
不过需要注意的是,目前IDE仅支持在移动设备(安卓真机/模拟器、iOS真机等)上显示绝对/相对坐标,不支持在Windows窗口/桌面上显示坐标;所以即使同学们勾选了此设置,对于IDE连接的Windows窗口或者桌面都是无效的。对于Windows窗口/桌面,我们可以截取一张画面截图,然后用画图工具打开并且查看坐标位置。
② Windows窗口嵌入模式¶
由于部分windows应用在默认嵌入方案中可能会有无法嵌入、嵌入后无法对应用进行操作、黑屏等问题,因此我们提供了一种备用嵌入方案,勾选Windows窗口无嵌入模式
这个选项之后,即可使用备用方案进行windows模式操作。
假如勾选了该选项,在嵌入windows窗口时,请使用windows的显示桌面
,将桌面上的应用全部最小化,然后仅将AirtestIDE和被测应用恢复到桌面中。点击AirtestIDE的 选定窗口
按钮,使用绿色/红色框将被测应用框选后,IDE的设备面板将消失,接下来就可以正常地进行录制操作:
③ 手机设备显示分辨率¶
当已经连接好Android
手机时,AirtestIDE会在Device窗口显示出手机实时同步画面。如果觉得清晰度较低,可以修改 手机设备显示分辨率
的值,数字越大,清晰度越高。默认为800,取值范围为300-2000之间。
如果还是觉得手机实时画面清晰度不够高,可以在连接手机之前,在下拉菜单中勾选 Use Javacap
模式(不勾选的情况下,默认使用Minicap连接手机),再进行连接。在Javacap模式下,能够看到清晰度更高的手机画面,但是延迟会比默认的Minicap模式要稍微高一些。
2)Editor¶
在Editor下,我们可以设置IDE的启动模式、字体大小、编辑器主题以及开启自动补全等等。
① 兼容模式¶
有些少部分用户由于显卡兼容性问题,可能在启动AirtestIDE时,不能看到脚本编辑窗口和log窗口中的文字,或者是启动后会闪退,但是通过双击文件夹中的兼容性模式启动.bat
脚本能够正常启动AirtestIDE。
为了能够无需每次启动都要双击脚本,我们在设置中新增了一个选项:
默认情况下会选择default
模式,如果启动有问题的用户,可以尝试选中下拉菜单中的另外三个选项,并且重启AirtestIDE,查看接下来是否能正常显示脚本编辑窗口和log查看窗口。如果能够生效,未来启动AirtestIDE时都将会以这个配置项来启动,无需每次都手工双击兼容性模式启动.bat
脚本来启动AirtestIDE了。
② 字体大小¶
可以调节编辑窗口和Log窗口内的文字大小,默认是14px
。
在AirtestIDE中,还可以通过按住ctrl+鼠标滚轮
来实现改变文字大小。
③ 编辑器主题¶
我们根据AirtestIDE
提供的两款不同配色的皮肤,分别添加了几种对应的编辑框代码主题可供选择,当鼠标悬停在主题名称上面时,可以看到预览图片:
④ 自动补全¶
自动补全
提供了一个编辑窗中的python代码自动补全功能,默认为不勾选此功能,因为在部分机器上可能会造成性能降低。
打开此选项后,可以在AirtestIDE中编辑代码时,享受到airtest
和poco
库的代码自动补全提示,如果希望能够对更多python库进行更好的自动补全,建议参考 python环境部署 ,在部署了本地Python环境以后,在IDE设置的自定义Python.exe路径
选项里设置好对应的python.exe路径,即可使用到更强大的python代码自动补全效果。
如果修改了 自定义Python.exe路径
的路径,需要重启IDE后才能让新的代码补全生效。
3)Airtest¶
在Airtest部分,我们可以设置自定义的Launcher文件路径、可以设置默认Log存放路径,还可以设置IDE使用本地的Python环境:
① 自定义Launcher文件路径¶
自定义Launcher文件路径
选项可以设置一个自定义的launcher.py
文件的路径,通常情况下这个选项无需设置,若想了解更多详情请参考我们下一小节的教程:Airtest启动器介绍。
IDE默认使用 sample
目录下的启动器文件:
点击重置
可以清空这个选项,点击编辑
将打开一个简单的编辑窗口,用于快速编辑这个launcher.py
文件。
② 默认Log存放路径¶
默认Log存放路径
用于指定在AirtestIDE中运行脚本时的log目录,IDE将会把产生的log文件、截图数据默认放置在这个目录下。
点击重置
按钮将会把log目录设置为系统默认的temp目录,点击清理
按钮将会自动帮忙清空该目录下的文件,释放硬盘空间,请操作前确认好没有需要保留的重要log文件。
③ 自定义Python.exe路径¶
自定义Python.exe路径
允许使用本地的python.exe
来跑在AirtestIDE里写好的脚本。由于AirtestIDE内置了一个python3.6.5环境,假如你希望能够使用自己的本地python环境(可以跑一些本地安装了的第三方库等等),可以通过设置这个选项来改变运行脚本默认使用的python.exe
。
点击打开
可以打开文件选择窗口,请务必选择一个本地安装的python.exe
路径。点击Reset
将会将填写内容清空。
在mac系统下,需要设置python可执行文件路径,如果使用的是系统python,使用which python
指令来获取python可执行文件所在路径(如果是python3,需要使用which python3
):
>which python3
/Library/Frameworks/Python.framework/Version/3.6/bin/python3
将该路径填写到AirtestIDE的设置窗口即可,请注意填写的是bin/
目录下的可执行文件,而不是python所在目录。
假如使用了虚拟环境,就需要填写虚拟环境目录下的python可执行文件路径了,例如在mac系统中可能是 /Users/username/.virtualenvs/your_env/bin/python3
。
注意:
-
如果希望使用本地Python环境运行脚本,需要事先部署airtest和pocoui相关环境,请参考运行脚本里的
本地python环境运行脚本
的内容进行环境部署。 -
AirtestIDE设置了本地的
python.exe
路径后,会默认使用AirtestIDE/sample/custom_launcher.py
来启动脚本,如果使用了自己的launcher.py,请在AirtestIDE中设置自己的launcher.py的脚本路径。关于launcher.py的介绍,请查看Airtest启动器介绍的内容。
4)Poco¶
在Poco部分,我们可以设置UI树的刷新间隔时间、框选Windows窗口的区域位置和自定义渲染分辨率等等:
① 刷新间隔(s)¶
刷新间隔(s)
选项用于配置Poco辅助窗中刷新Poco-UI树的间隔时间,单位为秒,默认为2s。
② Windows窗口区域位置¶
在IDE连接了Windows游戏窗口后(该Windows游戏已经提前嵌入了Poco-sdk),如果想要使用Poco来查看界面元素,可以通过Windows窗口区域位置
来设置窗口位置,这是为了能够在Windows窗口上显示poco元素标记用的,不设置不会对脚本运行产生任何影响。
③ 采用渲染分辨率¶
AirtestIDE 可适应90%以上全面屏不适配的问题, 对于剩下未支持的10%手机, IDE支持用户自定义设置渲染分辨率:
勾选采用渲染分辨率,然后输入竖屏模式下的渲染分辨率,点击OK即可。渲染分辨率为用逗号隔开的四个数字,数字分别代表竖屏模式下的 offset_x, offset_y, offset_width, offset_heigt.
比如本例中在 1080*2220 分辨率下的大鱼来了,它在手机上会有两个黑边,上黑边高度为 100px ,画面高度为2020px ,下黑边高度为 100px ,所以它的渲染分辨率则为(0 ,100 ,1080 ,2020)
5)Selenium¶
在Selenium部分,我们可以设置chrome浏览器的路径、设置使用firefox等:
① Chrome Path¶
点击chrome path 的空白框即可设置Chrome.exe
的路径,借此运行Selenium相关功能,详情请查阅selenium教程。
② Use Firefox instead of Chrome¶
如果您安装了geckodriver,并在path环境变量中配置了它,并选中“Use Firefox instead of Chrome”复选框,则不需要设置Chrome路径。 不过,我们 强烈建议您改用Chrome,因为Firefox浏览器不支持录制功能 。
注意
以上设置,修改之后均需要点击右下角的OK按钮保存设置,修改设置之后直接关闭设置窗口将不生效。