7.1 IDE设置、快捷键交互¶

AirtestIDE提供了一些额外的配置选项，在主界面的菜单栏中选择选项-设置可进入设置界面：

1. Core¶

语言设置¶

Language可设置AirtestIDE语言为中文zh_CN/英文en_US。

皮肤主题设置¶

在Theme下拉菜单中，可以选择AirtestIDE的皮肤主题，目前提供的主题有两款，分别是深色主题DarkShadow和浅色主题MoonLight。

2. Device¶

查看手机屏幕坐标¶

勾选 Show Real-time Cursor Coordinate 选项，可以实时在手机屏幕画面上显示出鼠标位置的坐标，方便大家获取坐标。此时 点击鼠标右键 ，还可以自动将当前坐标信息复制到剪贴板中，在代码里只需要直接粘贴即可插入点击位置的坐标。

在勾选了实时显示坐标的情况下，再勾选 Relative Coordinate 选项，将会以(0, 0) 到 (1, 1) 为范围显示出相对坐标。使用相对坐标可以避免跨分辨率的操作点超出屏幕的问题，使坐标操作兼容性更好。

Windows窗口嵌入模式¶

由于部分windows应用在默认嵌入方案中可能会有无法嵌入、嵌入后无法对应用进行操作、黑屏等问题，因此我们提供了一种备用嵌入方案，Connect windows without embedding 这个选项之后即可使用备用方案进行windows模式操作。

假如勾选了该选项，在嵌入windows窗口时，请使用windows的显示桌面，将桌面上的应用全部最小化，然后仅将AirtestIDE和被测应用恢复到桌面中。点击AirtestIDE的 选定窗口 按钮，使用绿色框将被测应用框选后，IDE的设备面板将消失，接下来就可以正常地进行录制操作。

手机屏幕显示效果¶

当已经连接好Android手机时，AirtestIDE会在Device窗口显示出手机实时同步画面。如果觉得清晰度较低，可以修改 Mobile Device Display Pixels 的值，数字越大，清晰度越高。默认为800，取值范围为300-2000之间。

如果还是觉得手机实时画面清晰度不够高，可以在连接手机之前，在下拉菜单中勾选 Use Javacap 模式（不勾选的情况下，默认使用Minicap连接手机），再进行连接。在Javacap模式下，能够看到清晰度更高的手机画面，但是延迟会比默认的Minicap模式要稍微高一些。

3. Editor¶

启动模式¶

有些少部分用户由于显卡兼容性问题，可能在启动AirtestIDE时，不能看到脚本编辑窗口和log窗口中的文字，或者是启动后会闪退，但是通过双击文件夹中的兼容性模式启动.bat脚本能够正常启动AirtestIDE。

为了能够无需每次启动都要双击脚本，我们在设置中新增了一个选项：

默认情况下会选择default模式，如果启动有问题的用户，可以尝试选中下拉菜单中的另外三个选项，并且重启AirtestIDE，查看接下来是否能正常显示脚本编辑窗口和log查看窗口。如果能够生效，未来启动AirtestIDE时都将会以这个配置项来启动，无需每次都手工双击兼容性模式启动.bat脚本来启动AirtestIDE了。

字体大小¶

可以调节编辑窗口和Log窗口内的文字大小，默认是14px。在AirtestIDE中，还可以通过按住ctrl+鼠标滚轮来实现改变文字大小。

代码补全 AutoComplete¶

Auto Complete 提供了一个编辑窗中的python代码自动补全功能，默认为不勾选此功能，因为在部分机器上可能会造成性能降低。

打开此选项后，可以在AirtestIDE中编辑代码时，享受到airtest和poco库的代码自动补全提示，如果希望能够对更多python库进行更好的自动补全，建议参考 python环境部署，在部署了本地Python环境以后，在IDE设置的Custom Python Path 选项里设置好对应的python.exe路径，即可使用到更强大的python代码自动补全效果。

如果修改了 Custom Python Path 的路径，需要重启IDE后才能让新的代码补全生效。

编辑框主题¶

我们根据AirtestIDE提供的两款不同配色的皮肤，分别添加了几种对应的编辑框代码主题可供选择，当鼠标悬停在主题名称上面时，可以看到预览图片：

4. Airtest¶

Airtest模块有3个配置选项，默认都不需要进行设置也能使用AirtestIDE进行脚本运行。

若需要对其中的内容进行设定，以下是一份设置样例：

设置launcher路径¶

Custom Launcher Path选项可以设置一个自定义的launcher.py文件的路径，通常情况下这个选项无需设置，若想了解更多详情请参考教程。

点击Reset可以清空这个选项，点击Edit将打开一个简单的编辑窗口，用于快速编辑这个launcher.py文件。

设置默认log文件存放路径¶

Default Log Path用于指定在AirtestIDE中运行脚本时的log目录，IDE将会把产生的log文件、截图数据默认放置在这个目录下。

点击Reset按钮将会把log目录设置为系统默认的temp目录，点击Clear按钮将会自动帮忙清空该目录下的文件，释放硬盘空间，请操作前确认好没有需要保留的重要log文件。

使用本地Python环境运行脚本（试用）¶

Custom Python Path允许使用本地的python.exe来跑在AirtestIDE里写好的脚本。由于AirtestIDE内置了一个python3.6.5环境，假如你希望能够使用自己的本地python环境（可以跑一些本地安装了的第三方库，可以让你使用本地的python2环境等等），可以通过设置这个选项来改变运行脚本默认使用的python.exe。

点击Open可以打开文件选择窗口，请务必选择一个本地安装的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相关环境，请参考第4章运行脚本里的使用本地python环境运行脚本章节进行环境部署。
AirtestIDE设置了本地的python.exe路径后，会默认使用 AirtestIDE/sample/custom_launcher.py 来启动脚本，如果使用了自己的launcher.py，请在AirtestIDE中设置自己的launcher.py的脚本路径。关于launcher.py的介绍，请查看文档

5. Poco¶

Poco元素刷新间隔¶

Refresh Interval选项用于配置Poco辅助窗中刷新Poco-UI树的间隔时间，单位为秒，默认为5s。

设置Poco-Windows模式下窗口位置¶

在嵌入了Windows游戏窗口后，如果想要使用Poco来查看界面元素，可以通过Windows Content Area Rect来设置窗口位置，这是为了能够在Windows窗口上显示poco元素标记用的，不设置不会对脚本运行产生任何影响。

6. Selenium¶

设置Chrome路径¶

点击可设置Chrome.exe的路径，借此运行Selenium相关功能，详情请查阅selenium教程。注意:如果您安装了geckodriver，并在path环境变量中配置了它，并选中“使用Firefox而不是Chrome”复选框，则不需要设置Chrome路径。不过，我们强烈建议您改用Chrome因为Firefox浏览器不支持录制功能。

7. 其他快捷键¶

在脚本编辑区/Log窗口内，Ctrl+鼠标滚轮可以实时调节文字大小。
脚本编辑区可以通过Ctrl+F进行内容搜索。
脚本编辑区可以通过 Ctrl+/ 进行代码注释/取消注释。
Poco模式切换时，会有插入代码的提示，如果确认模式请点击Yes。
Poco辅助窗内，Ctrl+F 可以隐藏/显示UI搜索框。

8.安卓助手¶

如何唤出小助手¶

目前这个小助手仅服务于Android平台的设备，不论是安卓真机还是安卓模拟器，都是适用的。召唤小助手的方式也非常简单，首先需要在IDE的设备窗口连接上一台安卓设备，然后找到设备画面右上角的 “Phone Assistant” ，点击并选择下拉列表的 “打开Android助手” 选项，此时小助手的弹框就显示出来了：