#!/usr/bin/env node
// electron 可执行文件的路径
const electron = require('./');
// require('./') 即 require('electron')
// 这里的 electron 是一个可执行的二进制文件
// 在 Windows 系统中名字叫 `electron.exe`
// 在类 Unix 系统中名字叫 `electron`

const proc = require('child_process');

// 通过 Node.js 提供的 `spawn` 拉起 electron 进程
// 当调用 proc.spawn() 方法时，可以传递几个参数来控制子进程的创建和运行方式。下面是对这些参数的详细解释：
// electron: 这是一个变量，存储了 electron 可执行文件的路径。作为子进程要运行的应用程序。
// process.argv.slice(2): 这是一个数组，它包含了执行脚本时传递的命令行参数。process.argv 是一个包含命令行参数的数组，其中第一个元素是 Node.js 可执行文件的路径，第二个元素是脚本文件的路径，其余的元素是传递给脚本的命令行参数。slice(2) 是为了去除前两个元素（Node.js 和脚本文件的路径），只保留脚本的命令行参数。
// stdio: 'inherit': 这表示将子进程的标准输入、输出和错误输出直接连接到父进程，使得子进程的输出可以在父进程的控制台显示。也就是说，父进程和子进程共享相同的输入输出流，这样子进程的输出将直接打印到父进程的控制台上，使得它们的输出可以同时显示在一起。
// windowsHide: false: 这个选项在 Windows 系统上特别有用。它的值是一个布尔型。当设置为 false 时，子进程在 Windows 上创建时不会隐藏窗口，即子进程会在界面上显示出来。如果设置为 true，子进程会在后台运行，没有窗口显示。
// 所以，proc.spawn() 方法的调用是为了创建一个子进程，子进程将运行 electron 应用程序，并且传递给 electron 的命令行参数来自父进程执行此脚本时传递的命令行参数。同时，子进程的标准输入输出和错误输出与父进程共享，并且在 Windows 上不会隐藏子进程的窗口。这样做可以使得 electron 应用程序的输出显示在父进程（即此脚本）的控制台上，方便调试和查看输出信息。
const child = proc.spawn(electron, process.argv.slice(2), { stdio: 'inherit', windowsHide: false });
// 这等价于我们用鼠标双击了 Electron App 的图标启动了它
// 所以说这一点都不神奇，我们也可以复刻同样的操作 ---- 在插件中也是这个实现方式


// 这段代码的作用是在子进程关闭时，检查退出码。如果退出码为 null，则说明子进程是通过信号终止的，会输出一个错误信息并使得脚本以非零退出码退出。如果退出码是正常的，脚本会以子进程的退出码退出，以便让父进程了解子进程的执行结果
child.on('close', function (code, signal) {
  // 检查子进程的退出码（code）。如果退出码为 null，这意味着子进程是通过信号终止的而不是通过正常的退出码。例如手动使用 Ctrl+C 终止子进程。
  if (code === null) {
    console.error(electron, 'exited with signal', signal);
    // 如果子进程是通过信号终止的，则执行此行代码，意味着脚本将以非零退出码（1）退出。这表示脚本的执行出现了错误或异常情况
    process.exit(1);
  }
  // 如果子进程是通过正常的退出码终止的，那么执行此行代码，脚本将以与子进程相同的退出码退出。这样可以让父进程知道子进程的执行状态，通常约定 0 表示成功，非零表示出现错误
  process.exit(code);
});


// 在接收到 SIGINT 和 SIGTERM 终止信号时，优雅地终止子进程。它检查子进程是否已经被终止，如果子进程还在运行，会向子进程发送相应的终止信号，以便子进程有机会做一些清理工作，然后正常退出。这样做可以避免子进程的突然终止，有助于保持应用程序的稳定性和数据完整性。
const handleTerminationSignal = function (signal) {
  process.on(signal, function signalHandler () {
    if (!child.killed) {
      child.kill(signal);
    }
  });
};

handleTerminationSignal('SIGINT');
handleTerminationSignal('SIGTERM');

#!/usr/bin/env node
// electron 可执行文件的路径
const electron = require('./');
// require('./') 即 require('electron')
// 这里的 electron 是一个可执行的二进制文件
// 在 Windows 系统中名字叫 `electron.exe`
// 在类 Unix 系统中名字叫 `electron`

const proc = require('child_process');

// 通过 Node.js 提供的 `spawn` 拉起 electron 进程
// 当调用 proc.spawn() 方法时，可以传递几个参数来控制子进程的创建和运行方式。下面是对这些参数的详细解释：
// electron: 这是一个变量，存储了 electron 可执行文件的路径。作为子进程要运行的应用程序。
// process.argv.slice(2): 这是一个数组，它包含了执行脚本时传递的命令行参数。process.argv 是一个包含命令行参数的数组，其中第一个元素是 Node.js 可执行文件的路径，第二个元素是脚本文件的路径，其余的元素是传递给脚本的命令行参数。slice(2) 是为了去除前两个元素（Node.js 和脚本文件的路径），只保留脚本的命令行参数。
// stdio: 'inherit': 这表示将子进程的标准输入、输出和错误输出直接连接到父进程，使得子进程的输出可以在父进程的控制台显示。也就是说，父进程和子进程共享相同的输入输出流，这样子进程的输出将直接打印到父进程的控制台上，使得它们的输出可以同时显示在一起。
// windowsHide: false: 这个选项在 Windows 系统上特别有用。它的值是一个布尔型。当设置为 false 时，子进程在 Windows 上创建时不会隐藏窗口，即子进程会在界面上显示出来。如果设置为 true，子进程会在后台运行，没有窗口显示。
// 所以，proc.spawn() 方法的调用是为了创建一个子进程，子进程将运行 electron 应用程序，并且传递给 electron 的命令行参数来自父进程执行此脚本时传递的命令行参数。同时，子进程的标准输入输出和错误输出与父进程共享，并且在 Windows 上不会隐藏子进程的窗口。这样做可以使得 electron 应用程序的输出显示在父进程（即此脚本）的控制台上，方便调试和查看输出信息。
const child = proc.spawn(electron, process.argv.slice(2), { stdio: 'inherit', windowsHide: false });
// 这等价于我们用鼠标双击了 Electron App 的图标启动了它
// 所以说这一点都不神奇，我们也可以复刻同样的操作 ---- 在插件中也是这个实现方式


// 这段代码的作用是在子进程关闭时，检查退出码。如果退出码为 null，则说明子进程是通过信号终止的，会输出一个错误信息并使得脚本以非零退出码退出。如果退出码是正常的，脚本会以子进程的退出码退出，以便让父进程了解子进程的执行结果
child.on('close', function (code, signal) {
  // 检查子进程的退出码（code）。如果退出码为 null，这意味着子进程是通过信号终止的而不是通过正常的退出码。例如手动使用 Ctrl+C 终止子进程。
  if (code === null) {
    console.error(electron, 'exited with signal', signal);
    // 如果子进程是通过信号终止的，则执行此行代码，意味着脚本将以非零退出码（1）退出。这表示脚本的执行出现了错误或异常情况
    process.exit(1);
  }
  // 如果子进程是通过正常的退出码终止的，那么执行此行代码，脚本将以与子进程相同的退出码退出。这样可以让父进程知道子进程的执行状态，通常约定 0 表示成功，非零表示出现错误
  process.exit(code);
});


// 在接收到 SIGINT 和 SIGTERM 终止信号时，优雅地终止子进程。它检查子进程是否已经被终止，如果子进程还在运行，会向子进程发送相应的终止信号，以便子进程有机会做一些清理工作，然后正常退出。这样做可以避免子进程的突然终止，有助于保持应用程序的稳定性和数据完整性。
const handleTerminationSignal = function (signal) {
  process.on(signal, function signalHandler () {
    if (!child.killed) {
      child.kill(signal);
    }
  });
};

handleTerminationSignal('SIGINT');
handleTerminationSignal('SIGTERM');