使用Electron Forge构建应用时遭遇依赖及平台配置错误

问题1：依赖缺失提示 #

执行npm run make时出现错误：

看起来你缺少运行Electron所需的部分依赖，请确保已安装Git且Node.js版本≥14.17.5

已安装Git，但问题仍存在。

package.json内容：

{
    "name": "OverStat",
    "version": "1.0.0",
    "main": "main.js",
    "devDependencies": {
        "@electron-forge/cli": "^6.0.4",
        "electron": "^22.0.0",
        "electron-reloader": "^1.2.3"
    },
    "scripts": {
        "start": "electron .",
        "make": "electron-forge make"
    },
    "dependencies": {
        "electron-builder": "^23.6.0"
    }
}

问题2：Win32平台无Make目标 #

重启VS Code后执行npm run make出现新错误：

✔ 检查系统环境
✔ 加载配置
✖ 解析构建目标
  › 未找到针对"win32"平台配置的构建目标。
◼ 执行打包命令
◼ 运行preMake钩子
◼ 生成分发文件
◼ 运行postMake钩子

Forge内部出现未处理的异常：
Error: Could not find any make targets configured for the "win32" platform.
at Task.task (D:\projects\electron learning\node_modules\@electron-forge\core\dist\api\make.js:122:27)
    at Task.run (D:\projects\electron learning\node_modules\listr2\dist\index.cjs:978:35)

forge.config.js内容：

module.exports = {
  packagerConfig: {},
  rebuildConfig: {},
  makers: [
    {
      name: '@electron-forge/maker-squirrel',
      config: {},
    },
    {
      name: '@electron-forge/maker-zip',
      platforms: ['darwin'],
    },
    {
      name: '@electron-forge/maker-deb',
      config: {},
    },
    {
      name: '@electron-forge/maker-rpm',
      config: {},
    },
  ],
};

解决方案 #

针对问题1：依赖缺失提示 #

• 检查Node.js版本：终端执行node -v，确认版本≥14.17.5，版本过低则升级Node.js。
• 验证Git配置：终端执行git --version，若命令未被识别，将Git安装目录下的bin文件夹添加到系统环境变量PATH，重启终端和VS Code。
• 重装依赖：删除node_modules文件夹和package-lock.json，执行npm install重新安装所有依赖。

针对问题2：Win32平台无Make目标 #

当前forge.config.js中，maker-zip仅配置了darwin（MacOS）平台，Windows平台的maker-squirrel可能未正确安装或配置，解决步骤：

1. 安装对应依赖：执行npm install --save-dev @electron-forge/maker-squirrel。
2. 修改forge.config.js，添加Windows平台的zip支持并确保squirrel构建器生效：

module.exports = {
  packagerConfig: {},
  rebuildConfig: {},
  makers: [
    {
      name: '@electron-forge/maker-squirrel',
      config: {},
    },
    {
      name: '@electron-forge/maker-zip',
      platforms: ['darwin', 'win32'], // 添加win32平台
    },
    {
      name: '@electron-forge/maker-deb',
      config: {},
    },
    {
      name: '@electron-forge/maker-rpm',
      config: {},
    },
  ],
};

3. 重新执行npm run make即可生成Windows平台的安装包。

内容的提问来源于stack exchange，提问作者Mfa