先决条件
Electron 是一个使用 JavaScript、HTML 和 CSS 构建桌面应用程序的框架。通过将 Chromium 和 Node.js 嵌入到单个二进制文件中,Electron 允许您使用一个 JavaScript 代码库创建可在 Windows、macOS 和 Linux 上运行的跨平台应用程序。
本教程将指导您完成使用 Electron 开发桌面应用程序并将其分发给最终用户的过程。
目标
本教程首先引导您从头开始组装一个最小的 Electron 应用程序,然后教您如何使用 Electron Forge 将其打包并分发给用户。
如果您更喜欢使用单命令样板启动项目,我们建议您从 Electron Forge 的 create-electron-app
命令开始。
假设
Electron 是一个用于 Web 应用程序的原生包装层,并在 Node.js 环境中运行。因此,本教程假定您大致熟悉 Node 和前端 Web 开发基础知识。如果您在继续之前需要进行一些背景阅读,我们推荐以下资源:
所需工具
代码编辑器
您需要一个文本编辑器来编写代码。我们推荐使用 Visual Studio Code,尽管您可以选择任何您喜欢的编辑器。
命令行
在整个教程中,我们将要求您使用各种命令行界面 (CLI)。您可以将这些命令键入到系统的默认终端中:
- Windows: 命令提示符或 PowerShell
- macOS: 终端
- Linux: 因发行版而异 (例如 GNOME Terminal, Konsole)
大多数代码编辑器也附带集成终端,您也可以使用它。
Git 和 GitHub
Git 是一种常用的源代码版本控制系统,而 GitHub 是一个基于 Git 构建的协作开发平台。尽管两者对于构建 Electron 应用程序并非严格必要,但我们将在本教程后面使用 GitHub Releases 设置自动更新。因此,我们将要求您:
如果您不熟悉 Git 的工作原理,我们建议您阅读 GitHub 的 Git 指南。如果您更喜欢使用图形界面而不是命令行,也可以使用 GitHub Desktop 应用程序。
我们建议您在开始教程之前创建一个本地 Git 仓库并将其发布到 GitHub,并在每一步之后提交代码。
如果您的系统尚未安装 Git,GitHub Desktop 将为您安装最新版本的 Git。
Node.js 和 npm
要开始开发 Electron 应用程序,您需要在系统上安装 Node.js 运行时及其捆绑的 npm 包管理器。我们建议您使用最新的长期支持 (LTS) 版本。
要检查 Node.js 是否正确安装,您可以在运行 node
和 npm
命令时使用 -v
标志。这些命令将打印出已安装的版本。
$ node -v
v16.14.2
$ npm -v
8.7.0
尽管您需要在本地安装 Node.js 来搭建 Electron 项目,但 Electron **不使用您系统的 Node.js 安装来运行其代码**。相反,它捆绑了自己独立的 Node.js 运行时。这意味着您的最终用户无需自行安装 Node.js 作为运行您应用程序的先决条件。
要检查您的应用程序中运行的 Node.js 版本,您可以在主进程或预加载脚本中访问全局 process.versions
变量。您也可以参考 https://releases.electronjs.org/releases.json。