feat(serve): merge #93, add support for custom electron args

Author: nklayman

__tests__/commands.spec.js

@@ -340,6 +340,39 @@ describe('electron:serve', () => {
     expect(mainConfig.node.shouldBe).toBe('expected')
   })
 
+  test('Custom launch arguments is used if provided', async () => {
+    let watchCb
+    fs.watchFile.mockImplementation((file, cb) => {
+      // Set callback to be called later
+      watchCb = cb
+    })
+    await runCommand('electron:serve', {
+      pluginOptions: {
+        electronBuilder: {
+          mainProcessFile: 'customBackground',
+          mainProcessArgs: ['--a-flag', 'a-value']
+        }
+      }
+    })
+
+    expect(execa).toHaveBeenCalledTimes(1)
+    expect(execa.mock.calls[0][1]).toEqual([
+      'dist_electron',
+      '--a-flag',
+      'a-value'
+    ])
+
+    // Mock change of background file
+    watchCb()
+
+    expect(execa).toHaveBeenCalledTimes(2)
+    expect(execa.mock.calls[0][1]).toEqual([
+      'dist_electron',
+      '--a-flag',
+      'a-value'
+    ])
+  })
+
   test('process.env.IS_ELECTRON is set to true', async () => {
     await runCommand('electron:serve')
     expect(process.env.IS_ELECTRON).toBe('true')

docs/guide/configuration.md

@@ -62,7 +62,11 @@ module.exports = {
       mainProcessFile: 'src/myBackgroundFile.js',
       // Provide an array of files that, when changed, will recompile the main process and restart Electron
       // Your main process file will be added by default
-      mainProcessWatch: ['src/myFile1', 'src/myFile2']
+      mainProcessWatch: ['src/myFile1', 'src/myFile2'],
+      // [1.0.0-rc.4+] Provide a list of arguments that Electron will be launched with during "electron:serve",
+      // which can be accessed from the main process (src/background.js).
+      // Note that it is ignored when --debug flag is used with "electron:serve", as you must launch Electron yourself
+      mainProcessArgs: ['--arg-name', 'arg-value']
     }
   }
 }

index.js

@@ -187,6 +187,7 @@ module.exports = (api, options) => {
         mainProcessFile,
         ...(pluginOptions.mainProcessWatch || [])
       ]
+      const mainProcessArgs = pluginOptions.mainProcessArgs || []
 
       console.log('\nStarting development server:\n')
       // Run the serve command
@@ -265,11 +266,23 @@ module.exports = (api, options) => {
             console.log(`$WEBPACK_DEV_SERVER_URL=${server.url}`)
           } else {
             // Launch electron with execa
-            console.log('\nLaunching Electron...')
+            if (mainProcessArgs) {
+              console.log(
+                '\nLaunching Electron with arguments: ' +
+                  mainProcessArgs.join(' ') +
+                  ' ...'
+              )
+            } else {
+              console.log('\nLaunching Electron...')
+            }
             child = execa(
               require('electron'),
-              // Have it load the main process file built with webpack
-              [outputDir],
+              [
+                // Have it load the main process file built with webpack
+                outputDir,
+                // Append other arguments specified in plugin options
+                ...mainProcessArgs
+              ],
               {
                 cwd: api.resolve('.'),
                 env: {