feat: specify path to custom Electron build (Electron.app)

Closes #760

.travis.yml

@@ -16,6 +16,7 @@ language: c
 cache:
   directories:
     - node_modules
+    - nsis-auto-updater/node_modules
     - $HOME/.electron
 
 before_install:

README.md

@@ -1,5 +1,5 @@
 # electron-builder [![npm version](https://img.shields.io/npm/v/electron-builder.svg)](https://npmjs.org/package/electron-builder) [![donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=W6V79R2RGCCHL)
-A complete solution to package and build a ready for distribution Electron app for MacOS, Windows and Linux with "auto update" support out of the box.
+A complete solution to package and build a ready for distribution Electron app for MacOS, Windows and Linux with “auto update” support out of the box.
 
 * NPM packages management:
   * [Native application dependencies](http://electron.atom.io/docs/latest/tutorial/using-native-node-modules/) compilation (only if the [two-package.json project structure](#two-packagejson-structure) is used).

package.json

@@ -1,6 +1,6 @@
 {
   "name": "electron-builder",
-  "description": "Complete solution to build ready for distribution and 'auto update' Electron App installers",
+  "description": "A complete solution to package and build a ready for distribution Electron app for MacOS, Windows and Linux with “auto update” support out of the box",
   "version": "0.0.0-semantic-release",
   "main": "out/index.js",
   "files": [

src/metadata.ts

@@ -200,6 +200,11 @@ export interface BuildMetadata {
    */
   readonly nodeGypRebuild?: boolean
 
+  /**
+  The path to custom Electron build (e.g. `~/electron/out/R`). Only macOS supported, file issue if need for Linux or Windows.
+   */
+  readonly electronDist?: string
+
   readonly icon?: string | null
 
   // deprecated

src/packager/dirPackager.ts

@@ -1,10 +1,12 @@
 import { Promise as BluebirdPromise } from "bluebird"
-import { emptyDir } from "fs-extra-p"
+import { emptyDir, copy } from "fs-extra-p"
 import { warn } from "../util/log"
 import { PlatformPackager } from "../platformPackager"
+import { debug7zArgs, spawn } from "../util/util"
+import { path7za } from "7zip-bin"
+import * as path from "path"
 
 const downloadElectron: (options: any) => Promise<any> = BluebirdPromise.promisify(require("electron-download"))
-const extract: any = BluebirdPromise.promisify(require("extract-zip"))
 
 //noinspection JSUnusedLocalSymbols
 const __awaiter = require("../util/awaiter")
@@ -29,11 +31,19 @@ function subOptionWarning (properties: any, optionName: any, parameter: any, val
 }
 
 export async function pack(packager: PlatformPackager<any>, out: string, platform: string, arch: string, electronVersion: string, initializeApp: () => Promise<any>) {
-  const zipPath = (await BluebirdPromise.all<any>([
-    downloadElectron(createDownloadOpts(packager.devMetadata.build, platform, arch, electronVersion)),
-    emptyDir(out)
-  ]))[0]
-  await extract(zipPath, {dir: out})
+  const electronDist = packager.devMetadata.build.electronDist
+  if (electronDist == null) {
+    const zipPath = (await BluebirdPromise.all<any>([
+      downloadElectron(createDownloadOpts(packager.devMetadata.build, platform, arch, electronVersion)),
+      emptyDir(out)
+    ]))[0]
+
+    await spawn(path7za, debug7zArgs("x").concat(zipPath, `-o${out}`))
+  }
+  else {
+    await emptyDir(out)
+    await copy(path.resolve(packager.info.projectDir, electronDist, "Electron.app"), path.join(out, "Electron.app"))
+  }
 
   if (platform === "darwin" || platform === "mas") {
     await(<any>require("./mac")).createApp(packager, out, initializeApp)

test/src/macPackagerTest.ts

@@ -1,5 +1,5 @@
 import test from "./helpers/avaEx"
-import { assertPack, platform, modifyPackageJson, signed, app } from "./helpers/packTester"
+import { assertPack, platform, modifyPackageJson, signed, app, appThrows } from "./helpers/packTester"
 import OsXPackager from "out/macPackager"
 import { move, writeFile, deleteFile, remove } from "fs-extra-p"
 import * as path from "path"
@@ -11,6 +11,7 @@ import { SignOptions, FlatOptions } from "electron-osx-sign-tf"
 import { Arch } from "out"
 import { Target } from "out/platformPackager"
 import { DmgTarget } from "out/targets/dmg"
+import { DIR_TARGET } from "out/targets/targetFactory"
 
 //noinspection JSUnusedLocalSymbols
 const __awaiter = require("out/util/awaiter")
@@ -204,6 +205,14 @@ test.ifOsx("disable dmg icon, bundleVersion", () => {
   })
 })
 
+test.ifOsx("electronDist", appThrows(/ENOENT: no such file or directory/, {
+  targets: Platform.OSX.createTarget(DIR_TARGET),
+}, {
+  projectDirCreated: projectDir => modifyPackageJson(projectDir, data => {
+    data.build.electronDist = "foo"
+  })
+}))
+
 class CheckingMacPackager extends OsXPackager {
   effectiveDistOptions: any
   effectiveSignOptions: SignOptions