1. 快速开始

原文:https://github.com/electron/electron/blob/master/docs/tutorial/quick-start.md
译者:Lin

Electron提供包含了丰富的原生(操作系统)接口的运行时,使你能够使用纯粹的JavaScript创建桌面应用程序。你可以把它看作是一个变形的重点是在桌面应用程序而不是网页服务上的Node.js运行时。

这并不意味着Electron是一个将JavaScript绑定到图形用户界面(GUI)上的库。相反,Electron使用网页作为它的GUI,所以你也可以把它看成是一个使用JavaScript控制的极小的Chromium浏览器。

Main Process主进程

Electron中,运行package.json’的main脚本的过程叫做the main process(主进程)。运行主进程的脚本会创建一个网页作为一个GUI来显示。

Renderer Process渲染进程

自从Electron使用Chromium来显示网页,Chromium的多进程架构也被使用在Electron中。Electron中的每一个网页都运行在它自己的进程中,这个就叫做the renderer process(渲染进程)

一般的浏览器中,网页通常在一个沙盒环境中运行,并且不允许使用原生资源。然而,Electron的使用者有能力在网页中使用Node.js的借口来与底层的操作系统进行交互。

主线程和渲染线程的不同

主进程通过创建BrowserWindow实例来创建网页。每一个BrowserWindow实例运行网页在它自己的渲染进程中。当一个BrowserWindow实例被销毁的时候,对应的渲染进程也会被结束。
主进程管理所有的网页和他们对应的渲染进程。每一个渲染进程都是被隔离的,并且只会关心在它自己里面运行的网页。

网页中,不允许调用本地GUI相关的接口,因为在网页中管理本地GUI资源是非常危险的并且也非常容易泄漏资源。如果你想要在网页中执行GUI操作,网页的渲染进程必须和主进程请求通讯,然后使用主进程之行这些操作。

Electron中我们有几种在主进程和渲染进程之间通讯的方式。例如用来发送消息的ipcRendereripcMain模块,以及RPC通讯方式的remote模块。这里还有一个FAQ条目来分享如何在页面之间传输数据

编写你第一个Electron应用程序

一般来说,一个Electron应用程序是按照这样的方式来构造的:

your-app/
├── package.json
├── main.js
└── index.html

package.json的类型和Node模块的完全相同,指定脚本中main字段内是你的应用程序的启动脚本,它将会在主线程运行。一个你的package.json文件的例子看起来像这样:

{
    "name"    : "your-app",
    "version" : "0.1.0",
    "main"    : "main.js"
}

注意:如果package.json文件中不存在main字段,Electron 将会默认加载一个index.js。

main.js文件应该创建一个窗口并且处理系统事件,一个典型的例子是:

const {app, BrowserWindow} = require('electron')
const path = require('path')
const url = require('url')

// 保持一个窗口对象的全局引用,如果你不这样做,当JavaScript对象被回收之后窗口将会被自动关闭
let win

function createWindow () {
    // 创建一个浏览器窗口
    win = new BrowserWindow({width: 800, height: 600})

    // 加载应用的index.html
    win.loadURL(url.format({
        pathname: path.join(__dirname, 'index.html'),
        protocol: 'file:',
        slashes: true
    }))

    // 打开DevTools.
    win.webContents.openDevTools()

    // 监听窗口关闭
    win.on('closed', () => {
        // 移除窗口对象的引用,
        // 如果你的应用支持多窗口你通常会将所有窗口存储在数组中,
        // 这个时候你应该删除相应的元素。
        win = null
    })
}

// 当Electron完成初始化并且准备创建一个浏览器窗口的时候会调用这个方法。
// 一些接口只能在这个事件之后使用。
app.on('ready', createWindow)

// 当所有窗口都被关闭的时候退出。
app.on('window-all-closed', () => {
    // macOS系统下对于应用这是很常见的,它们的菜单栏保持活跃直到他们使用Cmd + Q键确定退出
    if (process.platform !== 'darwin') {
        app.quit()
    }
})

app.on('activate', () => {
    // macOS系统下这是很常见的,当应用在dock上的图标被点击的时候(并且当时没有其他窗口是打开的),就会在应用中重新创建一个窗口。
    if (win === null) {
        createWindow()
    }
})

// 在这个文件中你可以包含其他你的应用程序在主线程中运行的代码部分。
// 你也可以在把其他的代码放在其他的文件中,然后在这里require它们。

最后是你想展示的网页的index.html页面:

<!DOCTYPE html>
<html>
    <head>
    <meta charset="UTF-8">
    <title>Hello World!</title>
    </head>
    <body>
        <h1>Hello World!</h1>
        We are using node <script>document.write(process.versions.node)</script>,
        Chrome <script>document.write(process.versions.chrome)</script>,
        and Electron <script>document.write(process.versions.electron)</script>.
    </body>
</html>

运行你的应用程序

一旦你已经创建了最开始main.jsindex.htmlpackage.json文件,你将可以尝试在本地运行测试你的应用程序,来确保它是可以正常的工作。

electron

electron是一个包含了Electron的预编译版本的npm模块。
如果你安装了全局的npm,那么你只需要在你源代码的根目录下运行下面的命令就可以了:

electron .

如果你在本地安装了它,那么运行:

macOS / Linux

$ ./node_modules/.bin/electron .

Windows

$ .\node_modules\.bin\electron .
手动下载Electron二进制文件

如果你手动下载Electron的二进制文件,你也可以使用已经包含的二进制文件直接之行你的应用程序:

Windows

$ .\electron\electron.exe your-app\

Linux

$ ./electron/electron your-app/

macOS

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

Electron.app是Electron发布的包的一部分,你可以在这里下载它。

作为一个distribution运行

当你完成你的应用程序的编写之后,你可以遵循Application Distribution指南创建一个distribution,然后执行打包应用程序。

试试这个例子

在这个指导中通过使用electron/electron-quick-start仓库来克隆并运行。

注意:运行这个命令需要你的系统中有GitNode.js(并且包含了npm

# 克隆仓库
$ git clone https://github.com/electron/electron-quick-start
# 进入仓库
$ cd electron-quick-start
# 安装依赖
$ npm install
# 运行应用程序
$ npm start

更多的应用程序例子,查看最好的Electron社区创建的list of boilerplates

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容