跳到主内容

应用打包

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

使用工具​

有一些现有的工具可以用来打包和分发你的 Electron 应用。我们推荐使用 Electron Forge。你可以直接查看其文档，或参考 Electron 教程中的打包和分发部分。

手动打包​

如果你偏好手动方法，有 2 种方式可以分发你的应用

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

使用预构建二进制文件​

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

注意

下例中使用 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)​

与其通过复制所有源文件来分发你的应用，不如将你的应用打包成 asar 存档，以提高在 Windows 等平台上读取文件的性能，尤其是在你尚未使用 Parcel 或 Webpack 等打包工具的情况下。

要使用 asar 存档替换 app 文件夹，你需要将存档重命名为 app.asar，并将其放在 Electron 的 resources 目录中，如下所示，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 重命名为你想要的任何名称，你还需要在以下文件中重命名 CFBundleDisplayName、CFBundleIdentifier 和 CFBundleName 字段

    • 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")，然后重新构建。

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