window搭建基于Electron的hyper开发环境踩坑

原创

已于 2024-01-24 11:38:12 修改 · 2.2k 阅读

19 ·

CC 4.0 BY-SA版权

文章标签：

#electron #javascript #前端

于 2024-01-22 14:09:08 首次发布

本文记录了作者在Hyper终端进行二次开发时遇到的挑战，包括Windows-build-tools安装问题、依赖库下载超时、VisualStudio集成、node-pty和node-gyp编译错误等，以及如何通过国内镜像和手动下载Chrome插件解决这些问题。

背景

个人需要在hyper终端基础上做一些二次开发，记录搭建开发环境中遇到的问题；
hyper官网：https://hyper.is/
在hyper github页面中，对个人开发环境的介绍如下：
在这里插入图片描述

步骤可以简单分为：

安装windows-build-tools；
yarn （安装依赖库）；
yarn run dev;
在新窗口中 yarn run app；

安装windows-build-tools

如上述描述，在终端（管理员权限）执行yarn global add windows-build-tools ，出现长时间加载后仍未响应的问题，网上一些回答表示就是需要较长时间，但用时超过12H后仍未加载成功，显然是不合理的。
此问题猜测为windows-build-tools会主动安装Visual Studio环境，且使用安装源为国外源，导致无法成功安装；
解决方案：执行命令更换为yarn global add windows-build-tools@4.0.0 指定此版本可以安装成功，用时预计2~3分钟；

安装依赖库

执行yarn 安装依赖库时，主要遇到以下问题：

下载依赖文件提示连接超时（Connection Timeout）：
- 首先是众所周知的镜像源地址问题，通过yarn config set registry http://registry.npm.taobao.org/ 命令设置镜像源地址为国内镜像即可；
- 若执行上述操作后仍提示连接超时，且连接路径仍为默认镜像源（设置镜像源未生效），检查目录下是否存在 .yarnrc 文件，将其删除即可；

visualstudio编译相关异常报错，如找不到头文件、编译器版本不正确（MSBuild相关异常提示）等

 C:\Users\xxx\Desktop\TEMP\hyper-canary\hyper-canary\target\node_modules\node-addon-api\napi.h(4,10): fatal error C1083:
  ????????: �node_api.h�: No such file or directory [C:\Users\xxx\Desktop\TEMP\hyper-canary\hyper-canary\target\node_modules\native-process-working-directory\build\native-process-working-directory.vcxproj]

此类异常现象与windows-build-tools安装有关系，首先确保windows-buil