轻松掌握在AirtestIDE中切换为本地Python环境的详细指南

此文章来源于项目官方公众号：“AirtestProject”
版权声明：允许转载，但转载必须保留原链接；请勿用作商业或者非法用途

一、前言

最近有一些新入门的小伙伴们都在问如何在AirtestIDE内使用更多的依赖库，为了解决这个问题，我们建议将AirtestIDE的Python环境切换为本地Python环境，并在本地环境中添加所需的依赖库。本周推文将一步一步指导大家如何将AirtestIDE的Python环境转换为本地环境。

二、操作步骤

2.1　确认本地的python环境

先确保你的电脑已安装Python。在Windows系统中，打开命令窗口，输入python，按回车，看看是否显示已安装的Python环境。如果还未安装python，先进行安装。我们比较建议的是使用Python 3.12以下的版本

2.2 安装python环境（已安装的同学可以忽略）

首先到python官网下载自己所需的python版本exe，官网地址：https://www.python.org/downloads/，双击安装包，点击进入安装流程。

一直点next，直到进入安装流程

等待安装结束后，可以进入环境变量中，看到已经添加好对应的python环境了，重复2.1的操作可以看到python环境已经安装好了。

2.3 安装Airtest、Poco、Airtest-selenium依赖库

点击进入命令行，通过执行以下命令安装Airtest、Poco、Airtest-selenium依赖库

# 使用 pip 安装Airtest框架 
pip install airtest

# 使用 pip 安装poco框架 
pip install pocoui

#使用 pip 安装airtest-selenium框架 （需要同时下载安装selenium库）
pip install airtest-selenium
pip install selenium

安装完毕后可以检查一下自己的依赖库是否安装好了

其中，需要注意：

1. 若运行代码时，在cv2模块报 ImportError: DLL load failed: 找不到指定模块 的错，本问题的根本原因应该是DLL文件的缺失，有几种解决方案：

   1. 我们将它们放入了IDE的目录中，可以直接在官网下载一个最新版本的AirtestIDE，在解压后的目录中找到api-ms-win-downlevel-shlwapi-l1-1-0.dll和IEShims.dll两个DLL文件，将他们复制到C:\Windows\System32目录，重新运行代码即可解决

   2. 若在win.py中import win32api时报DLL load failed，可以尝试重新安装pywin32模块：

      pip uninstall pywin32
      pip install pywin32==223
      

   3. 如果使用了python3.7，请安装 Visual C++ redistributable 2015 ，下载地址：https://www.microsoft.com/en-us/download/details.aspx?id=48145 参考 文档：https://pypi.org/project/opencv-contrib-python/

   4. 如果使用的python版本低于3.7，请直接运行:

      > pip uninstall opencv-contrib-python   
      # 若以下安装语句运行失败，可以尝试更新pip到最新版本后重试   
      > pip install opencv-contrib-python==3.2.0.7  
      

2. 请勿安装pocoui，如果同时安装了 poco 和 pocoui ，则运行脚本时会出现冲突，请确保python环境里面只安装了正确的 pocoui 。

3. pip指令运行失败的话，国内用户请在pip install 指令后面加上

4. -i　https://pypi.tuna.tsinghua.edu.cn/simple （清华源）后重试，参考：https://mirrors.tuna.tsinghua.edu.cn/help/pypi/。

5. 使用本地python环境出现 no moudle named ...的报错的话

   如果在IDE中设置了使用本地Python环境运行脚本，但出现“没有名为airtest的模块”等错误，这通常是因为本地环境中没有安装所需的库。可以参考如何部署本地Python环境的指南来安装这些库。连接如下：https://airtest.doc.io.netease.com/IDEdocs/3.4run_script/0_run_script/#1python

   如果已经安装了airtest等库，但IDE仍然报告找不到库，可能是因为本地存在多个Python环境。需要检查在哪个环境中安装了库，以及IDE设置中使用的是哪个环境。

2.4　将AirtestIDE的python环境更换成本地的python环境

首先打开AirtestIDE的选项-设置，进入到下述界面，点击自定义python.exe路径右侧的打开按钮，选择刚刚安装好Airtest等依赖库的python.exe，点击ok即可。

2.5 新建脚本

与使用AirtestsIDE的默认python环境一致，新建好脚本后，一样会默认生成对应的初始化脚本。

但使用IDE的内置Python环境运行脚本时，脚本编辑器会高亮显示当前执行的代码行。然而，如果选择使用本地Python环境运行脚本，这种高亮显示功能将不可用。

在更换完环境之后，可以先跑一下初始脚本的内容，确认一下是否会出现缺失库的报错，然后根据缺失的内容进行下载即可。大家如果不清楚自己使用的是本地的python环境还是AirtestIDE自带环境的话，可以参考图下所圈出来的内容看看，一般使用本地的python环境的话，会显示的是本地python路径的，而AirtestIDE的默认环境则是AirtestIDE的路径。\

到这里我们将AirtestIDE更换成本地的python环境操作就结束了，在这个基础上，大家可以在本地的python环境内新增自己所需要的依赖库，在AirtestIDE的python环境中是无法添加新的依赖库的，比较限制，使用本地的python环境后就可以使用更多的依赖库去优化以及拓展自己的脚本内容啦~

三、小结

本周我们介绍了如何去将AirtestIDE的python环境更换成本地的Python环境，通过在本地环境内安装python，安装所需的依赖库，在AirtestIDE的设置中更换python的路径，就可以在AirtestIDE中使用本地的python环境啦~

如果大家在使用过程中有一些新的使用方式或者遇到了问题，又或者有任何想要深入了解的知识点，欢迎在官方交流群（526033840）里告诉我们或者提交issue。

---

AirtestIDE下载：airtest.netease.com/
Airtest 教程官网：airtest.doc.io.netease.com/
搭建企业私有云服务：airlab.163.com/b2b

官方答疑 Q 群：526033840