electron打包配置及其常见错误

electron基本配置

1. 通用配置：

"build":{
  "appId": "com.example.myapp",
  "productName": "MyApp",
  "directories": {
    "output": "dist"
  },
  "files": [
    "dist/**/*"
  ],
  "nsis": {
     "oneClick": false,
     "perMachine": true,
     "allowToChangeInstallationDirectory": true
  },
     "extends": null,
     "electronDownload": {
        "mirror": "https://npmmirror.com/mirrors/electron/"
  	}
}

• "appId"：指定了应用的唯一标识符。
• "productName"：指定了应用的产品名称。
• "directories.output"：指定了打包输出目录。
• "files"：指定了要包含在打包中的文件。
• 通常配置在package.json中 也可以配置在electron配置中 具体配置查阅文档。

1. 针对不同平台的配置：

"mac": {
  "icon": "build/icon.icns",
  "target": "dmg"
},
"win": {
  "icon": "build/icon.ico",
  "target": "nsis"
},
"linux": {
  "icon": "build/icon.png",
  "target": "AppImage"
}

• "icon"：指定了应用在不同平台上的图标文件路径。
• "target"：指定了在不同平台上打包的目标格式，如 "dmg" (macOS), "nsis" (Windows), "AppImage" (Linux) 等。

2. 自定义安装程序配置：

jsonCopy Code"win": {
  "target": [
    {
      "target": "nsis",
      "arch": [
        "x64",
        "ia32"
      ]
    }
  ]
}

• 在 不同平台上，可以通过 "arch" 属性指定不同架构的安装程序，可以根据你的需求添加或删除架构。

常见错误

1. 网络问题：

⨯ Get "https://github.com/electron/electron/releases/download/v18.2.2/electron-v18.2.2-win32-x64.zip"

• 这种报错属于网络问题，由于远程下载文件时获取不到文件导致下载错误。
• 可以通过手动下载文件electron-v18.2.2-win32-x64.zip下载下来，然后放到C:\Users\Administrator\AppData\Local\electron文件夹下。
• 或者通过配置.npmrc下载地址，或者加速之类的方法使其可以下载到electron-v18.2.2-win32-x64.zip文件。

Get "https://github.com/electron-userland/electron-builder-binaries/releases/download/winCodeSign-2.6.0/winCodeSign-2.6.0.7z"

• 这种报错和上面类似。
• 可以通过配置下载地址解决，列如：

 "electronDownload": {
        "mirror": "https://npmmirror.com/mirrors/electron/"
  	}

2. snap 报错

snap install snapcraft --classic

• 这种报错时因为打包时触发了snap打包行为。
• 需要指定打包后缀，列如：

"linux": {
  "icon": "build/icon.png",
  "target": "AppImage"
}

• 打包成别的后缀请参考文档 Snapcraft 指南 (Linux) | Electron (electronjs.org)

3. 运行时报错

二进制文件无法执行

• 这种报错时由于架构和cpu不符合导致无法运行，需打包对应架构。

一般情况下运行只有这种报错，如果有别的报错那就是打包时出现了问题，逐步排查一下。