diff --git a/docs-translations/zh-CN/tutorial/quick-start.md b/docs-translations/zh-CN/tutorial/quick-start.md index d267d3146051..9faddf1bb09e 100644 --- a/docs-translations/zh-CN/tutorial/quick-start.md +++ b/docs-translations/zh-CN/tutorial/quick-start.md @@ -1,7 +1,6 @@ # 快速入门 -## 简介 -Electron 可以让你使用纯 JavaScript 调用丰富的原生 APIs 来创造桌面应用。你可以把它看作是专注于桌面应用而不是 web 服务器的,io.js 的一个变体。 +Electron 可以让你使用纯 JavaScript 调用丰富的原生 APIs 来创造桌面应用。你可以把它看作一个专注于桌面应用的 Node.js 的变体,而不是 Web 服务器。 这不意味着 Electron 是绑定了 GUI 库的 JavaScript。相反,Electron 使用 web 页面作为它的 GUI,所以你能把它看作成一个被 JavaScript 控制的,精简版的 Chromium 浏览器。 @@ -14,13 +13,13 @@ Electron 可以让你使用纯 JavaScript 调用丰富的原生 APIs 来创造 在一般浏览器中,网页通常会在沙盒环境下运行,并且不允许访问原生资源。然而,Electron 用户拥有在网页中调用 io.js 的 APIs 的能力,可以与底层操作系统直接交互。 ## 主进程与渲染进程的区别 -主进程使用 BrowserWindow 实例创建网页。每个 BrowserWindow 实例都在自己的渲染进程里运行着一个网页。当一个 BrowserWindow 实例被销毁后,相应的渲染进程也会被终止。 +主进程使用 `BrowserWindow` 实例创建页面。每个 `BrowserWindow` 实例都在自己的渲染进程里运行页面。当一个 `BrowserWindow` 实例被销毁后,相应的渲染进程也会被终止。 -主进程管理所有页面和与之对应的渲染进程。每个渲染进程都是相互独立的,并且只关心他们自己的网页。 +主进程管理所有页面和与之对应的渲染进程。每个渲染进程都是相互独立的,并且只关心他们自己的页面。 -由于在网页里管理原生 GUI 资源是非常危险而且容易造成资源泄露,所以在网页面调用 GUI 相关的 APIs 是不被允许的。如果你想在网页里使用 GUI 操作,其对应的渲染进程必须与主进程进行通讯,请求主进程进行相关的 GUI 操作。 +由于在页面里管理原生 GUI 资源是非常危险而且容易造成资源泄露,所以在页面调用 GUI 相关的 APIs 是不被允许的。如果你想在网页里使用 GUI 操作,其对应的渲染进程必须与主进程进行通讯,请求主进程进行相关的 GUI 操作。 -在 Electron,我们提供用于在主进程与渲染进程之间通讯的 [ipc][1] 模块。并且也有一个远程进程调用风格的通讯模块 [remote][2]。 +在 Electron,我们提供几种方法用于主进程和渲染进程之间的通讯。像 [ipcRenderer][1] 和 [ipcMain][2] 模块用于发送消息, [remote][3] 模块用于 RPC 方式通讯。这些内容都可以在一个 FAQ 中查看 [how to share data between web pages][4]。 # 打造你第一个 Electron 应用 大体上,一个 Electron 应用的目录结构如下: @@ -42,53 +41,72 @@ your-app/ `main.js` 应该用于创建窗口和处理系统事件,一个典型的例子如下: ```javascript -var app = require('app'); // 控制应用生命周期的模块。 -var BrowserWindow = require('browser-window'); // 创建原生浏览器窗口的模块 +const electron = require('electron'); +// 控制应用生命周期的模块。 +const {app} = electron; +// 创建原生浏览器窗口的模块。 +const {BrowserWindow} = electron; -// 保持一个对于 window 对象的全局引用,不然,当 JavaScript 被 GC, -// window 会被自动地关闭 -var mainWindow = null; +// 保持一个对于 window 对象的全局引用,如果你不这样做, +// 当 JavaScript 对象被垃圾回收, window 会被自动地关闭 +let win; -// 当所有窗口被关闭了,退出。 -app.on('window-all-closed', function() { - // 在 OS X 上,通常用户在明确地按下 Cmd + Q 之前 - // 应用会保持活动状态 - if (process.platform != 'darwin') { +function createWindow() { + // 创建浏览器窗口。 + win = new BrowserWindow({width: 800, height: 600}); + + // 加载应用的 index.html。 + win.loadURL(`file://${__dirname}/index.html`); + + // 启用开发工具。 + win.webContents.openDevTools(); + + // 当 window 被关闭,这个事件会被触发。 + win.on('closed', () => { + // 取消引用 window 对象,如果你的应用支持多窗口的话, + // 通常会把多个 window 对象存放在一个数组里面, + // 与此同时,你应该删除相应的元素。 + win = null; + }); +} + +// This method will be called when Electron has finished +// initialization and is ready to create browser windows. +// Some APIs can only be used after this event occurs. +app.on('ready', createWindow); + +// Quit when all windows are closed. +app.on('window-all-closed', () => { + // On OS X it is common for applications and their menu bar + // to stay active until the user quits explicitly with Cmd + Q + if (process.platform !== 'darwin') { app.quit(); } }); -// 当 Electron 完成了初始化并且准备创建浏览器窗口的时候 -// 这个方法就被调用 -app.on('ready', function() { - // 创建浏览器窗口。 - mainWindow = new BrowserWindow({width: 800, height: 600}); - - // 加载应用的 index.html - mainWindow.loadURL('file://' + __dirname + '/index.html'); - - // 打开开发工具 - mainWindow.openDevTools(); - - // 当 window 被关闭,这个事件会被发出 - mainWindow.on('closed', function() { - // 取消引用 window 对象,如果你的应用支持多窗口的话, - // 通常会把多个 window 对象存放在一个数组里面, - // 但这次不是。 - mainWindow = null; - }); +app.on('activate', () => { + // On OS X it's common to re-create a window in the app when the + // dock icon is clicked and there are no other windows open. + if (win === null) { + createWindow(); + } }); + +// In this file you can include the rest of your app's specific main process +// code. You can also put them in separate files and require them here. ``` 最后,你想展示的 `index.html` : ```html
+