目录
- 概述
- 环境配置
- 安装Python环境
- 安装Visual C++环境
- 安装node-gyp
- 安装Robot.js
- 解决安装报错思路
- 其他常见安装报错
1. 概述
!!!前情提要:本文仅介绍windows的安装方法,其他系统可参考文档中官方的方法进行安装
根据Robot.js仓库介绍,安装前需要使用到node-gyp库以及其环境。
node-gyp 是一个是一个用 Node.js 编写的跨平台命令行工具,用于为 Node.js 编译原生插件模块。
Robot.js运行需要 node-gyp 库以及其环境支撑,所以这里直接采用 node-gyp 的配置环境方法,而不再使用 Robot.js 文档中配置环境的方法
。
而node-gyp 需要Python 、 Visual C++ 两部分配置支持。
总结:Robot.js需要配置Python 、 Visual C++ 、node-gyp、Node.js等四项配置,缺少一项则无法正常使用
注:本文未直接使用或安装windows-build-tools模块,所产生的奇怪报错无解决方案
2. 环境配置
安装python环境
根据 node-gyp 文档,需要安装受支持的python版本。支持版本包括:
可选Python官方下载地址,或者淘宝镜像地址,国内推荐使用镜像地址下载更快。
这里以安装3.10版本为例子,使用文中的python版本,可选32位或者64位或者免安装程序。
打开下载的文件 选中下方复选框【Add python.exe to PATH】 点击 Install Now 进行快速安装(如需自定义安装路径则选择Customize installation,然后使用默认配置,在路径选择界面进行自定义,然后安装)
如果提示:Setup was successful则安装成功,关闭安装程序即可
安装Visual C++环境
根据 node-gyp 文档指出,运行此库需要安装Visual C++环境。此处可参考本文或者 node-gyp 原文的方法
这里通过安装 Visual Studio Community 一键配置环境。由于 Visual 2015 版本最高支持 Node18 ,如高于Node18建议下载 Visual 2017及更高版本,本文选择下载Visual 2022版本。(如还未安装Node.js,可点击此处进行安装)
下载并运行会进入 Visual Studio 安装界面,关闭或者跳过默认推荐。 菜单栏中选择【可用】选项,选择 Visual Studio Community 2022 版本,点击安装(如已存在Visual版本,则可选中修改选项对工作负载进行编辑)。
在弹出的工作负荷选项界面,下滑找到并选择【使用C++的桌面开发】选项,并使用默认配置,点击安装并等待完成
安装node-gyp
在配置好上述环境后
使用命令npm install -g node-gyp
进行全局安装,安装无报错即说明安装成功
3. 安装Robot.js
打开项目命令行并运行命令
npm install robotjs
就会发现能够正常使用Robot.js了
解决安装报错思路
首先要尝试看控制台报错
红色字体ERR!
忽略,真正报错的信息看gyp
后面的关键词。比如上图中看似是ERR,实际是info,根据info说明gyp已经获取到了node-gyp模块、node环境以及python环境,那么出现问题的地方就在Visual C++环境
方面。所以我们只需要关注出现gyp ERR!
的地方,如下:
重点看 Visual 的报错:
find VS msvs_version not set from command line or npm config
说明未获取或者未从命令行设置Visual版本
find VS "C:\Program Files\Microsoft Visual Studio\2022\Community"
说明Visual已安装,但仍存在其他问题
find VS - "Visual Studio C++ core features" missing
说明Visual缺少C++核心配置
再看后面星号之间的提示(重点:
这里会介绍解决报错的信息):
find VS You need to install the latest version of Visual Studio
说明你需要安装最新版本的Visual,实际上根据Node版本安装(VS2013最高支持Node8,VS2015最高支持Node18)
find VS including the "Desktop development with C++" workload.
说明你的Visual没有安装Desktop development with C++ 工作负载
解决方法:在Visual安装程序中选中【使用C++的桌面开发】,点击安装并等待完成即可(详细可见上文步骤)
其他常见安装报错:
gyp ERR! find Python - "python" is not in PATH or produced an error
说明Python没有配置环境变量,具体方法可百度
gyp ERR! find VS not looking for VS2015 as it is only supported up to Node.js 18
说明你的Visual版本不支持你的Node版本,实际上这种情况较少,大多情况是由于没有安装Desktop development with C++工作负载而造成的(解决方法见上文)。