我们很高兴地宣布 Electron Forge v6.0.0 现已发布!此版本标志着 Forge 自 2018 年以来的第一个主要版本,并将项目从 electron-userland
移至 Github 上的主 electron
组织。
继续阅读以了解新功能以及您的应用如何采用 Electron Forge!
什么是 Electron Forge?
Electron Forge 是一个用于打包和分发 Electron 应用的工具。它将 Electron 的构建工具生态系统统一到一个可扩展的单一接口中,以便任何人都可以立即开始制作 Electron 应用。
主要特性包括:
- 📦 应用打包和代码签名
- 🚚 可定制的 Windows、macOS 和 Linux 安装程序(DMG、deb、MSI、PKG、AppX 等)
- ☁️ 面向云提供商(GitHub、S3、Bitbucket 等)的自动化发布流程
- ⚡️ 易于使用的 webpack 和 TypeScript 样板模板
- ⚙️ 支持原生 Node.js 模块
- 🔌 可扩展的 JavaScript 插件 API
v6 有什么新功能?
完全重写
从 v1 到 v5,Electron Forge 基于现已停产的 electron-compile
项目。Forge 6 是对该项目的完全重写,采用了新的模块化架构,可以扩展以满足任何 Electron 应用的需求。
在过去几年中,Forge v6.0.0-beta
已达到与 v5 的功能对等,并且代码改动率显著放缓,使得该工具已准备好进行普遍采用。
对于版本 5 及以下,Electron Forge 发布到 npm 上的 electron-forge
包。从 v6 重写开始,Forge 则被构建为一个包含许多较小项目的 monorepo 项目。
官方支持
从历史上看,Electron 维护者对构建工具持不发表意见的态度,将这项任务留给了各种社区包。然而,随着 Electron 项目的成熟,新的 Electron 开发者越来越难以理解他们需要哪些工具来构建和分发他们的应用。
为了帮助指导 Electron 开发者的分发过程,我们决定将 Forge 作为 Electron 官方的“一应俱全”的构建管道。
在过去的一年里,我们一直在缓慢地将 Forge 集成到官方的 Electron 文档中,并且最近我们将 Forge 从其在 electron-userland/electron-forge
的旧位置迁移到了 electron/forge 仓库。现在,我们终于准备好向广大受众发布 Electron Forge 了!
初始化新的 Forge 项目
可以使用 create-electron-app
CLI 脚本来构建新的 Electron Forge 项目。
yarn create electron-app my-app --template=webpack
cd my-app
yarn start
npm init electron-app@latest my-app -- --template=webpack
cd my-app
npm start
该脚本将在 my-app
文件夹中创建一个 Electron 项目,包含完整的 JavaScript 打包和预配置的构建管道。
更多信息请参阅 Forge 文档中的入门指南。
导入现有项目
Electron Forge CLI 也包含一个用于导入现有 Electron 项目的命令。
cd my-app
yarn add --dev @electron-forge/cli
yarn electron-forge import
cd my-app
npm install --save-dev @electron-forge/cli
npm exec --package=@electron-forge/cli -c "electron-forge import"
当您使用 import
命令时,Electron Forge 将添加一些核心依赖项并创建一个新的 forge.config.js
配置。如果您有任何现有的构建工具(例如 Electron Packager、Electron Builder 或 Forge 5),它将尝试迁移尽可能多的设置。您的一些现有配置可能需要手动迁移。
手动迁移的详细信息可以在 Forge 的导入文档中找到。如果您需要帮助,请访问我们的 Discord 服务器!
为什么要切换到 Forge?
如果您已经有了用于打包和发布 Electron 应用的工具,采用 Electron Forge 所带来的好处仍然可能超过最初的切换成本。
我们认为使用 Forge 有两个主要好处:
-
Forge 会尽快在 Electron 中支持应用构建的新功能。在这种情况下,您无需自己接入新的工具支持,或等待其他包最终实现该支持后再升级。最近的例子请参阅 macOS 通用二进制文件和 ASAR 完整性检查。
-
Forge 的多包架构使其易于理解和扩展。由于 Forge 由许多责任清晰的小包组成,因此更容易理解代码流程。此外,Forge 可扩展的 API 设计意味着您可以针对高级用例编写自己的额外构建逻辑,与提供的配置选项分开。有关编写自定义 Forge 插件、makers 和发布器的更多详细信息,请参阅文档的扩展 Electron Forge 部分。
重大变更 (Breaking changes)
Forge 6 在 Beta 阶段花费了很长时间,其发布节奏逐渐放缓。然而,我们在 2022 年下半年加快了开发速度,并在 v6.0.0 稳定版发布之前,利用最后几个版本推进了一些最终的重大变更。
如果您是 Electron Forge 6 Beta 用户,请参阅v6.0.0 GitHub 版本说明,了解最近 Beta 版本 (>=6.0.0-beta.65
) 中的重大变更列表。
完整的变更和提交列表可以在仓库的 CHANGELOG.md 中找到。
提交您的反馈!
告诉我们您需要什么!Electron Forge 团队一直在寻求改进项目,以便更好地适应用户需求。
您可以通过提交功能请求、提交问题或仅告知我们您的反馈来帮助我们改进 Electron Forge!您也可以加入我们的官方 Electron Discord 服务器,那里有专门用于讨论 Electron Forge 的频道。
如果您想对 https://forge.electron.js.cn 上的 Forge 文档提供任何反馈,我们有一个与 electron-forge/electron-forge-docs 仓库同步的 GitBook 实例。