前言
在将 Electron 代码开发完成后,如果想要投入生产环境,那就必须经过很关键的一步——打包。
今天就将 MacOS 上使用 electron-builder 打包 Electron 应用的过程做一个记录。
为什么要打包
我上一篇文章《使用 VSCode 调试 Electron 主进程代码》介绍了在开发环境下运行 Electron 程序的方法,既然可以正常运行了,那为什么还需要经过打包的步骤呢?原因如下:
- 为了实现跨平台的目的
在打包之前,如果我将源码拷贝一份到其他操作系统(比如 windows)上,那要正常运行的话,必须在对应的系统上安装适配该系统的 Electron 执行程序。
为了减小跨平台的复杂度,我们需要针对各个不同的平台,将程序代码打包成适配平台的应用程序,达到直接使用的目的。
- 为了减小代码体积
一个最基本的 Electron 程序,其开发环境代码体积大约 170MB,因为有较多开发依赖(devDependencies
),对于程序的传输极不友好。
可以通过打包的手段,排查掉众多开发依赖,精简应用代码体积。
环境
- 操作系统:
macOS Catalina 10.15.7
- Electron Version: 16.0.6
- electron-builder: 22.14.5
- 程序代码:《使用 VSCode 调试 Electron 主进程代码》中用到的
electron-quick-start
目录
打包步骤
- 安装 electron-builder
mkdir electron-builder cd electron-builder yarn init -y yarn add electron-builder -D
这里建议将 electron-builder 安装在单独的目录,方便复用。
- 添加打包指令(也可直接在终端执行)
// electron-quick-start/package.json { "name": "myApp", …… "scripts": { …… "build": "../electron-builder/node_modules/.bin/electron-builder" }, …… }
执行 npm run build
之后,终端信息如下:
> Executing task: npm run build < > myApp@1.0.0 build > ../electron-builder/node_modules/.bin/electron-builder • electron-builder version=22.14.5 os=19.6.0 • writing effective config file=dist/builder-effective-config.yaml • packaging platform=darwin arch=x64 electron=16.0.6 appOutDir=dist/mac • default Electron icon is used reason=application icon is not set • skipped macOS application code signing reason=cannot find valid "Developer ID Application" identity or custom non-Apple code signing certificate, see https://electron.build/code-signing allIdentities= 0 identities found Valid identities only 0 valid identities found • building target=macOS zip arch=x64 file=dist/myApp-1.0.0-mac.zip • building target=DMG arch=x64 file=dist/myApp-1.0.0.dmg • building block map blockMapFile=dist/myApp-1.0.0.dmg.blockmap • building block map blockMapFile=dist/myApp-1.0.0-mac.zip.blockmap
在 electron-quick-start
下生成的 dist 文件夹,其文件结构如下:
./dist ├── builder-debug.yml ├── builder-effective-config.yaml ├── latest-mac.yml ├── mac │ └── myApp.app ├── myApp-1.0.0-mac.zip ├── myApp-1.0.0-mac.zip.blockmap ├── myApp-1.0.0.dmg └── myApp-1.0.0.dmg.blockmap
- 打包配置
可根据自己的需要,在 package.json
中增加配置项。
// electron-quick-start/package.json { "name": "myApp", …… "scripts": { …… "build": "../electron-builder/node_modules/.bin/electron-builder" }, …… "build": { "productName": "myFirstApp", // 指定打包成的程序名称,可包含空格 "appId": "bianchengsanmei", "directories": { "output": "build" // 指定打包程序的输出目录 }, "mac": { "target": "dmg" }, "dmg": { "backgroundColor": "#fff" } } }
具体相关配置可查看 electron-builder 官方文档。
打包前后体积比较
开发环境总体积:
打包生成的 .dmg
安装包体积:
可以看到,通过打包,使得程序体减少了一大半。
总结
以上就是一次简单的 Electron 应用打包过程,希望能够对你有所帮助。
~ 本文完,感谢阅读!
学习有趣的知识,结识有趣的朋友,塑造有趣的灵魂!
你来,怀揣期望,我有墨香相迎! 你归,无论得失,唯以余韵相赠!
知识与技能并重,内力和外功兼修,理论和实践两手都要抓、两手都要硬!