应用分发

首先,你需要下载Electron的 prebuilt binaries进行分发.

接着,把应用所在目录命名为 'app',并像下面例子一样放到Electron的 resources目录(macOS 中是指 Electron.app/Contents/Resources/,Linux 和 Windows 中是指 resources/)里,下面的例子是把Electron的预构建二进制文件的位置假定为 electron/:

macOS中示例:

  1. electron/Electron.app/Contents/Resources/app/
  2. ├── package.json
  3. ├── main.js
  4. └── index.html

Windows 和 Linux中示例:

  1. electron/resources/app
  2. ├── package.json
  3. ├── main.js
  4. └── index.html

最后,运行 Electron.app (Linux的 electron, Windows的 electron.exe), Electron就会作为您的应用进行启动. electron 目录将被部署并可以分发给用户.

将应用程序打包成单一文件

除了通过拷贝所有的资源文件来分发你的应用程序之外, 您还可以打包成asar归档以避免将源代码直接暴露给用户.

要把 app文件夹打包成 asar，你要把 app重命名为 app.asar，并像下面例子一样放到Electron的 resources目录，Electron就会试图读取存档并从中启动。

macOS中示例:

  1. electron/Electron.app/Contents/Resources/
  2. └── app.asar

Windows 和 Linux中示例:

  1. electron/resources/
  2. └── app.asar

更多细节详见应用程序包.

更换名称与下载二进制文件

在使用 Electron 打包你的应用程序之后，你可能需要在分发给用户之前修改打包的名字。

Windows

你可以重命名 electron.exe并使用类似rcedit之类的软件编辑它的图标和属性信息.

macOS

在macOS中也可以重命名 Electron.app,但同时也要重命名以下两个文件中的 CFBundleDisplayName， CFBundleIdentifier和 CFBundleName字段:

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

你也可以重命名 应用帮助 以避免在应用程序监视器中显示 Electron Helper，但是请确保你已经修改了 应用帮助的程序名称。

改过名称的应用构造示例：

  1. MyApp.app/Contents
  2. ├── Info.plist
  3. ├── MacOS/
  4. │   └── MyApp
  5. └── Frameworks/
  6.     ├── MyApp Helper EH.app
  7.     |   ├── Info.plist
  8.     |   └── MacOS/
  9.     |       └── MyApp Helper EH
  10.     ├── MyApp Helper NP.app
  11.     |   ├── Info.plist
  12.     |   └── MacOS/
  13.     |       └── MyApp Helper NP
  14.     └── MyApp Helper.app
  15.         ├── Info.plist
  16.         └── MacOS/
  17.             └── MyApp Helper

Linux

您可以将 electron重命名为任何名称。

打包工具

除了手动打包外, 你也可以使用第三方打包工具:

通过重编译源代码来更换名称

你也可以直接修改和重编译 atom.gyp 文件,达到彻底更换Electron名称

grunt-build-atom-shell

手动对Electron的代码修改或重编译一般都很复杂晦涩,所以可以创建一个自动处理的Grunt任务:grunt-build-atom-shell.

该任务会从源代码中自动处理 .gyp 文件并重编译应用程序的本地 Node模块以匹配这个新名称.

创建一个自定义 Electron 分支

如果你只是为了构建应用而已,即便是生产级的应用也无需创建分支,你只需使用类似 electron-packager 或 electron-builder 之类的工具即可重构Electron,而不需要去创建分支.

只有你希望将自定义C++ 代码补丁到Electron并且无法提交至upstream或被已被官方版本拒绝时,你才需要创建分支.

通过 surf-build 创建一个自定义版本

  1. 通过npm安装Surf: npm install -g surf-build@latest

  2. 创建一个新的 S3 bucket 并按照以下结构创建文件夹：

  1.     - atom-shell/
  2.       - symbols/
  3.       - dist/

  1. 设置以下环境变量：

    • ELECTRON_GITHUB_TOKEN - 可以在GitHub上创建发行版的令牌
    • ELECTRON_S3_ACCESS_KEY, ELECTRON_S3_BUCKET, ELECTRON_S3_SECRET_KEY - 上传 Node.js 的 headers 以及符号的位置
    • ELECTRON_RELEASE - true即上传部分将被运行但不设置离开, surf-build仅进行CI-type的检查, 适合每次运行都拉取请求.
    • CI - 必须 true ,否则无效.
    • GITHUB_TOKEN - 设置与 ELECTRON_GITHUB_TOKEN相同
    • SURF_TEMP - 在Windows上设置为 C:\Temp ,防止路径过长的问题.
    • TARGET_ARCH - 设置 ia32或 x64

  2. 在 script/upload.py中,务必设置 ELECTRON_REPO 到你的fork(MYORG/electron), 尤其是你本身是Electron的贡献者.

  3. surf-build -r https://github.com/MYORG/electron -s YOUR_COMMIT -n 'surf-PLATFORM-ARCH'

  4. 可能需要等待很长时间才能完成构建.