跳转到主要内容

应用程序打包

要使用 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") 并重新构建。

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