巧妙规避 Electron 打包墙内失败的坑

2024-01-09 05:12:26

好的项目应具备启动成功也易于打包的条件。Electron 虽说是跨平台的桌面应用程序开发框架，但对于构建成的应用进行打包，国内网络环境相对复杂、资源较难获取，往往会造成打包过程出错。本文将从实际发生打包错误的角度，来分析出错的原因并提供相应的解决方案。

因缺少资源文件而造成的打包错误

比如，项目中使用了request包，通过 npm 安装后，运行项目时没有问题，但打包时提示缺少资源文件，具体报错信息如下：

1371 WARN Download:request: C:\xxx\xxx\xxx\node_modules\request\request.js: Downloading package request (not found in cache)
1371 INFO Download:request: C:\xxx\xxx\xxx\node_modules\request\request.js: Could not find https://registry.npmjs.org/request/latest in cache

出现这种问题，主要是由于项目中使用了官方 NPM 源，而墙内无法连接到官方 NPM 源，导致 NPM 无法下载所需依赖包，从而造成打包失败。

解决方案

切换到淘宝镜像

在运行项目前，通过命令npm config set registry https://registry.npm.taobao.org将 NPM 的源切换为淘宝镜像，再重新执行npm install。
使用npm-install命令强制下载资源

在 npm 安装完依赖包后，可以在项目的根目录下运行命令npm-install --force-resolving强制将所有依赖包下载到本地。

因资源已损坏而造成的打包错误

如果项目中使用第三方模块（比如electron-forge）时，在本地可以运行成功，但在打包成 exe 时出现错误，比如：

1371 WARN Download:electron-forge: C:\xxx\xxx\xxx\node_modules\electron-forge\electron-forge.js: Downloading package electron-forge (not found in cache)
1371 INFO Download:electron-forge: C:\xxx\xxx\xxx\node_modules\electron-forge\electron-forge.js: Could not find https://registry.npmjs.org/electron-forge/latest in cache

这说明打包脚本无法下载到electron-forge包，这可能是因为包已损坏，导致下载失败。

解决方案

删除已有下载的electron-forge包

在命令行中输入命令rm -rf node_modules/electron-forge删除已有下载的electron-forge包。
重新下载electron-forge包

重新运行npm install命令下载electron-forge包。
重新打包

完成上述步骤后，即可重新打包。