环境:
Linux CentOS8 x64
electron:27.1.0
electron-forge: 7.1.0
electron dev依赖包
"devDependencies": {
"@electron-forge/cli": "^7.1.0",
"@electron-forge/maker-deb": "^7.1.0",
"@electron-forge/maker-rpm": "^7.1.0",
"@electron-forge/maker-squirrel": "^7.1.0",
"@electron-forge/maker-zip": "^7.1.0",
"@electron-forge/plugin-auto-unpack-natives": "^7.1.0",
"@electron/rebuild": "^3.3.0",
"@vitejs/plugin-vue": "3.1.0",
"electron": "^27.1.0"
}
异常记录
Cannot make for rpm, the following external binaries need to be installed: rpmbuild
An unhandled rejection has occurred inside Forge:
Error: Cannot make for rpm, the following external binaries need to be installed: rpmbuild
出现这个错误,代表你的系统上缺少环境依赖包,需要进行安装。
安装命令:dnf install rpm-build.x86_64
;有的异常给出的并不是包名,
而是命令,所以这个时候就需要查询这个命令是在哪个包中再进行安装。
也可以通过dnf search <包名>命令进行尝试性的检索,看看能不能找到。
libexec/platform-python3.6" links out of the package
An unhandled rejection has occurred inside Forge:
Error: /tmp/electron-packager/tmp-9UkTiG/resources/app/node_modules/@serialport/bindings-cpp/build/node_gyp_bins/python3: file "../../../../../usr/libexec/platform-python3.6" links out of the package
出现这个错误是一个bug,这里需要修改forge.config.js文件或等同的配置项内容,添加hooks项。
修改后的文件内容如下:
const path = require('path')
const fs = require('node:fs/promises');
module.exports = {
packagerConfig: {
asar: true,
...
},
makers: [
...
],
plugins: [
...
],
hooks: {
packageAfterPrune: async (_config, buildPath) => {
const gypPath = path.join(
buildPath,
'node_modules',
'@serialport',
'bindings-cpp',
'build',
'node_gyp_bins'
);
await fs.rm(gypPath, {recursive: true, force: true});
}
}
};
注意:其他配置内容保留你自己的即可。
'@serialport','bindings-cpp'这里是我这边的模块名称,替换你自己的模块命令。
导致这个错误的原因相关的文档记录:
node_gyp_bins导致下游包构建失败
在 Mac 上启用 asar 时,Electron forge 会抛出“.../python3.8”链接超出包”错误
Cannot make for deb, the following external binaries need to be installed: dpkg, fakeroot
An unhandled rejection has occurred inside Forge:
Error: Cannot make for deb, the following external binaries need to be installed: dpkg, fakeroot
at MakerDeb.ensureExternalBinariesExist
如果你构建deb格式的包,那么可能就会出现上面这种错误,还是需要安装这2个依赖包。
在安装之前先执行
yum -y install epel-release
添加扩展仓库包。
安装命令:yum install dpkg-1.20.9-4.el8.x86_64
自己确认是否需要额外安装的包:dpkg-devel.x86_64 dpkg-dev.noarch
fakeroot安装命令:dnf install fakeroot.x86_64 fakeroot-libs.x86_64
Package name must start with an ASCII number or letter
Error: Package name must start with an ASCII number or letter
at DebianInstaller.sanitizeName
这里是构建名称的强制条件,我这边没有通过forge.config.js文件单独配置名称,所以我这里修改的是package.json文件的内容。
"name": "test-exec-name",
You may need to re-bundle the app using Electron Packager's "executableName" option.
An unhandled rejection has occurred inside Forge:
Error: could not find the Electron app binary at "/path1/path2/...". You may need to re-bundle the app using Electron Packager's "executableName" option.
这里也就是根据你提供的name名称,并未找到二进制文件目录,要不你单独指定,要不你就统一名称,例如:name和productName名称保持一致。
这是关于deb marker配置项:https://js.electronforge.io/interfaces/_electron_forge_maker_deb.InternalOptions.MakerDebConfigOptions.html
error: License field must be present in package: (main package)
这个错误很明确,就是你没有声明许可协议。在package.json包中添加"license": "GPL"即可,协议的值根据你自己的需要进行修改。