electron-builder参数详解
electron-builder 是一个用于打包和构建 Electron 应用的工具,支持 macOS、Windows 和 Linux 平台,并提供了丰富的参数配置选项。
1、安装:
npm install electron-builder --save-dev
2、参数详解
命令:
-
electron-builder build
:构建应用程序(默认命令) -
electron-builder install-app-deps
:安装应用程序依赖项 -
electron-builder node-gyp-rebuild
:重建本地原生代码 -
electron-builder create-self-signed-cert
:为 Windows 应用程序创建自签名代码签名证书 -
electron-builder start
:使用 electron-webpack 在开发模式下运行应用程序 -
electron-builder publish
:根据发布配置发布文件
构建选项:
-
--mac, -m, -o, --macos
:构建适用于 macOS 的应用程序,接受目标列表 [数组] -
--linux, -l
:构建适用于 Linux 的应用程序,接受目标列表 [数组] -
--win, -w, --windows
:构建适用于 Windows 的应用程序,接受目标列表 [数组] -
--x64
:构建适用于 x64 架构的应用程序 [布尔值] -
--ia32
:构建适用于 ia32 架构的应用程序 [布尔值] -
--armv7l
:构建适用于 armv7l 架构的应用程序 [布尔值] -
--arm64
:构建适用于 arm64 架构的应用程序 [布尔值] -
--universal
:构建适用于通用架构(仅限 macOS) [布尔值] -
--dir
:构建未打包的目录。适用于测试。 [布尔值] -
--prepackaged, --pd
:预打包应用程序的路径(用于打包成可分发格式) -
--projectDir, --project
:项目目录的路径。默认为当前工作目录。 -
--config, -c
:electron-builder 配置文件的路径。默认为electron-builder.yml
(或json
,或json5
,或js
,或ts
)
发布选项:
-
--publish, -p
:发布构建的文件(到 GitHub 发布),[可选值:'onTag', 'onTagOrDraft', 'always', 'never', undefined]
electron-builder publish
发布一组构建的文件
选项:
-
-v, --version
:用于搜索上传发布的应用程序/构建版本(某些发布器使用) [字符串] -
--help
:显示帮助信息 [布尔值] -
-f, --files
:要上传到发布器的文件 [数组] [必需] -
-c, --config
:electron-builder 配置文件的路径。默认为electron-builder.yml
(或json
,或json5
,或js
,或ts
),[字符串]
其他:
-
--help
:显示帮助信息 [布尔值] -
--version
:显示版本号 [布尔值]
3、使用示例
编译成安装包
electron-builder
编译成未打包的应用程序目录
electron-builder --dir
跳过编译打包成安装包
electron-builder --prepackaged ./dist/win-unpacked --win nsis
指定平台和目标
electron-builder --win --x64
electron-builder --mac --arm64
4、使用配置文件
配置 package.json
在 package.json 文件中添加以下脚本:
"scripts": {"electron:dev": "concurrently vite \"electron .\"","electron:build": "npm run build && electron-builder","electron:exe": "npm run build && electron-builder --dir","electron:package": "electron-builder --prepackaged ./dist/win-unpacked --win nsis"
}