跳转到主要内容

应用程序打包

要使用 Electron 分发您的应用,您需要对其进行打包和品牌重塑。 为此,您可以使用专门的工具或手动方法。

使用工具

有几种工具可以用来打包和分发您的 Electron 应用。 我们建议使用 Electron Forge。 您可以直接查阅其文档,或参考 Electron 教程的打包与分发部分。

手动打包

如果您更喜欢手动方式,有两种方法可以分发您的应用程序

  • 使用预构建的二进制文件
  • 使用应用源代码存档

使用预构建的二进制文件

要手动分发您的应用,您需要下载 Electron 的预构建二进制文件。 接下来,包含您的应用的文件夹应命名为 app 并放置在 Electron 的资源目录中,如下例所示。

注意

在以下示例中,Electron 预构建二进制文件的位置用 electron/ 表示。

macOS
electron/Electron.app/Contents/Resources/app/
├── package.json
├── main.js
└── index.html
Windows 和 Linux
electron/resources/app
├── package.json
├── main.js
└── index.html

然后在 macOS 上执行 Electron.app,在 Linux 上执行 electron,或在 Windows 上执行 electron.exe,Electron 就会作为您的应用启动。 electron 目录将是您交付给用户的分发包。

使用应用源代码存档 (asar)

如果您没有使用像 Parcel 或 Webpack 这样的打包工具,除了通过复制所有源文件来交付您的应用之外,您还可以将您的应用打包成一个 asar 归档文件,以提高在 Windows 等平台上读取文件的性能。

要使用 asar 归档文件替换 app 文件夹,您需要将归档文件重命名为 app.asar,并将其放在 Electron 的资源目录下,如下所示,Electron 将尝试读取该归档文件并从中启动。

macOS
electron/Electron.app/Contents/Resources/
└── app.asar
Windows
electron/resources/
└── app.asar

您可以在 electron/asar 代码仓库中找到有关如何使用 asar 的更多详细信息。

使用下载的二进制文件进行品牌重塑

将您的应用捆绑到 Electron 中之后,您需要在分发给用户之前对 Electron 进行品牌重塑。

  • Windows: 您可以将 electron.exe 重命名为您喜欢的任何名称,并使用 rcedit 等工具编辑其图标和其他信息。

  • Linux: 您可以将 electron 可执行文件重命名为您喜欢的任何名称。

  • macOS: 您可以将 Electron.app 重命名为您想要的任何名称,并且还必须在以下文件中重命名 CFBundleDisplayNameCFBundleIdentifierCFBundleName 字段

    • Electron.app/Contents/Info.plist
    • Electron.app/Contents/Frameworks/Electron Helper.app/Contents/Info.plist

    您还可以重命名辅助应用以避免在“活动监视器”中显示 Electron Helper,但请确保您已重命名辅助应用可执行文件的名称。

    重命名后的应用结构将如下所示

MyApp.app/Contents
├── Info.plist
├── MacOS/
│ └── MyApp
└── Frameworks/
└── MyApp Helper.app
├── Info.plist
└── MacOS/
└── MyApp Helper
注意

也可以通过更改产品名称并从源代码构建来对 Electron 进行品牌重塑。为此,您需要在 `args.gn` 文件中设置与产品名称相对应的构建参数 (`electron_product_name = "YourProductName"`) 并重新构建。

请记住,不建议这样做,因为设置从源代码编译的环境并非易事,并且需要大量时间。