快速入门

这不意味着 Electron 是绑定了 GUI 库的 JavaScript。相反，Electron 使用 web 页面作为它的 GUI，所以你能把它看作成一个被 JavaScript 控制的，精简版的 Chromium 浏览器。

在 Electron 里，运行 里 main 脚本的进程被称为主进程。在主进程运行的脚本可以以创建 web 页面的形式展示 GUI。

由于 Electron 使用 Chromium 来展示页面，所以 Chromium 的多进程结构也被充分利用。每个 Electron 的页面都在运行着自己的进程，这样的进程我们称之为渲染进程。

在一般浏览器中，网页通常会在沙盒环境下运行，并且不允许访问原生资源。然而，Electron 用户拥有在网页中调用 Node.js 的 APIs 的能力，可以与底层操作系统直接交互。

主进程使用 BrowserWindow 实例创建页面。每个 BrowserWindow 实例都在自己的渲染进程里运行页面。当一个 BrowserWindow 实例被销毁后，相应的渲染进程也会被终止。

主进程管理所有页面和与之对应的渲染进程。每个渲染进程都是相互独立的，并且只关心他们自己的页面。

在 Electron，我们提供几种方法用于主进程和渲染进程之间的通讯。像 和 ipcMain 模块用于发送消息， 模块用于 RPC 方式通讯。这些内容都可以在一个 FAQ 中查看 how to share data between web pages。

打造你第一个 Electron 应用

大体上，一个 Electron 应用的目录结构如下：

package.json的格式和 Node 的完全一致，并且那个被 main 字段声明的脚本文件是你的应用的启动脚本，它运行在主进程上。你应用里的 package.json 看起来应该像：

  1. {
  2.   "name"    : "your-app",
  3.   "version" : "0.1.0",
  4.   "main"    : "main.js"
  5. }

注意：如果 main 字段没有在 package.json 声明，Electron会优先加载 index.js。

main.js 应该用于创建窗口和处理系统事件，一个典型的例子如下：

  1. const electron = require('electron');
  2. // 控制应用生命周期的模块。
  3. const {app} = electron;
  4. // 创建原生浏览器窗口的模块。
  5. const {BrowserWindow} = electron;
  7. // 保持一个对于 window 对象的全局引用，如果你不这样做，
  8. let mainWindow;
  11.   // 创建浏览器窗口。
  12.   mainWindow = new BrowserWindow({width: 800, height: 600});
  14.   // 加载应用的 index.html。
  15.   mainWindow.loadURL(`file://${__dirname}/index.html`);
  17.   // 启用开发工具。
  18.   mainWindow.webContents.openDevTools();
  20.   // 当 window 被关闭，这个事件会被触发。
  21.   mainWindow.on('closed', () => {
  22.     // 取消引用 window 对象，如果你的应用支持多窗口的话，
  23.     // 通常会把多个 window 对象存放在一个数组里面，
  24.     // 与此同时，你应该删除相应的元素。
  25.     mainWindow = null;
  26.   });
  27. }
  29. // Electron 会在初始化后并准备
  30. // 创建浏览器窗口时，调用这个函数。
  31. // 部分 API 在 ready 事件触发后才能使用。
  33. // 当全部窗口关闭时退出。
  34. app.on('window-all-closed', () => {
  35.   // 在 macOS 上，除非用户用 Cmd + Q 确定地退出，
  37.   if (process.platform !== 'darwin') {
  38.     app.quit();
  39.   }
  40. });
  42. app.on('activate', () => {
  43.   // 在 macOS 上，当点击 dock 图标并且该应用没有打开的窗口时，
  44.   // 绝大部分应用会重新创建一个窗口。
  45.   if (mainWindow === null) {
  46.     createWindow();
  47.   }
  48. });
  50. // 在这文件，你可以续写应用剩下主进程代码。
  51. // 也可以拆分成几个文件，然后用 require 导入。

最后，你想展示的 index.html ：

运行你的应用

是一个 npm 模块，包含所使用的 Electron 预编译版本。 如果你已经用 npm 全局安装了它，你只需要按照如下方式直接运行你的应用：

  1. electron .

如果你是局部安装，那运行：

  1. ./node_modules/.bin/electron .

如果你手工下载了 Electron 的二进制文件，你也可以直接使用其中的二进制文件直接运行你的应用。

  1. $ ./electron/electron your-app/
  1. $ ./Electron.app/Contents/MacOS/Electron your-app/

Electron.app 里面是 Electron 发布包，你可以在 这里 下载到。

以发行版本运行

在你完成了你的应用后，你可以按照 应用部署 指导发布一个版本，并且以已经打包好的形式运行应用。

参照下面例子

复制并且运行这个库 electron/electron-quick-start。