非常教程

Electron参考手册

指南 | Guides

电子常见问题 | Electron FAQ

为什么我在安装Electron时遇到问题?

运行npm install electron时,有些用户偶尔会遇到安装错误。

在几乎所有情况下,这些错误都是网络问题的结果,而不是electronnpm包的实际问题。类似错误ELIFECYCLEEAI_AGAINECONNRESET,和ETIMEDOUT是这样的网络问题,所有的迹象。最好的解决方法是尝试切换网络,或者稍微等一会再尝试安装。

如果安装过程失败,您也可以直接electron/electron/releases下载Electron npm

Electron何时升级到最新的Chrome?

Chrome版本的Electron通常会在一个新的稳定Chrome版本发布后的一两周内出现。这一估算不能保证,取决于升级所涉及的工作量。

只使用Chrome的稳定频道。如果重要的修补程序在beta或dev通道中,我们会将其移回。

有关更多信息,请参阅安全性介绍。

Electron什么时候升级到最新的Node.js?

当新版本的Node.js发布时,我们通常会在升级Electron中的一个之前等待大约一个月的时间。所以我们可以避免受到新Node.js版本中引入的错误的影响,这经常发生。

Node.js的新功能通常由V8升级带来,因为Electron使用Chrome浏览器提供的V8,新的Node.js版本的闪亮新JavaScript特性通常已经在Electron中。

如何在网页之间共享数据?

要在网页(渲染器进程)之间共享数据,最简单的方法是使用浏览器中已有的HTML5 API。较好的选择是存储API,localStoragesessionStorage,和IndexedDB的。

或者,您可以使用特定于Electron的IPC系统将对象存储在主进程中作为全局变量,然后通过模块的remote属性从渲染器访问它们electron

// In the main process.
global.sharedObject = {
  someProperty: 'default value'
}
// In page 1.
require('electron').remote.getGlobal('sharedObject').someProperty = 'new value'
// In page 2.
console.log(require('electron').remote.getGlobal('sharedObject').someProperty)

几分钟后,我的应用程序的窗口/托盘就消失了。

当用于存储窗口/托盘的变量被垃圾收集时,会发生这种情况。

如果遇到此问题,以下文章可能会有所帮助:

  • 内存管理
  • 变量范围(https://msdn.microsoft.com/library/bzt2dkta(v = vs.94%29.aspx)

如果你想快速修复,你可以通过改变你的代码来使变量变成全局变量:

const {app, Tray} = require('electron')
app.on('ready', () => {
  const tray = new Tray('/path/to/icon.png')
  tray.setTitle('hello world')
})

对此:

const {app, Tray} = require('electron')
let tray = null
app.on('ready', () => {
  tray = new Tray('/path/to/icon.png')
  tray.setTitle('hello world')
})

我无法在Electron中使用jQuery / RequireJS / Meteor / AngularJS。

由于集成的Node.js Electron,也有插入像DOM一些额外的符号moduleexportsrequire。这导致一些库的问题,因为他们想要插入具有相同名称的符号。

要解决这个问题,可以关闭Electron中的节点集成:

// In the main process.
const {BrowserWindow} = require('electron')
let win = new BrowserWindow({
  webPreferences: {
    nodeIntegration: false
  }
})
win.show()

但是,如果您想保留使用Node.js和Electron API的功能,则必须在包含其他库之前重命名页面中的符号:

<head>
<script>
window.nodeRequire = require;
delete window.require;
delete window.exports;
delete window.module;
</script>
<script type="text/javascript" src="jquery.js"></script>
</head>

require('electron').xxx 未定义。

当使用Electron的内置模块时,您可能会遇到如下错误:

> require('electron').webFrame.setZoomFactor(1.0)
Uncaught TypeError: Cannot read property 'setZoomLevel' of undefined

这是因为你有本地或全局安装的npm electron模块,这会覆盖Electron的内置模块。

要验证您是否使用了正确的内置模块,可以打印electron模块的路径:

console.log(require.resolve('electron'))

然后检查它是否在以下形式:

"/path/to/Electron.app/Contents/Resources/atom.asar/renderer/api/lib/exports/electron.js"

如果它是类似的node_modules/electron/index.js,那么你必须删除npm electron模块,或者重新命名它。

npm uninstall electron
npm uninstall -g electron

但是,如果您正在使用内置模块但仍然出现此错误,则很可能是您在错误的过程中使用了该模块。例如electron.app只能在主进程中使用,而electron.webFrame只能在渲染进程中使用。

Electron

Electron 是一个使用 JavaScript, HTML 和 CSS 等 Web 技术创建原生程序的框架,它负责比较难搞的部分,你只需把精力放在你的应用的核心上即可。

主页 https://electron.atom.io/
源码 https://github.com/electron/electron
发布版本 1.7.9

Electron目录

1.指南 | Guides
2.指南·开发 | Guides: Development
3.Webview 组件 |
4.加速器 | Accelerator
5.API
6.API·对象 | API·Objects
7.app
8.autoUpdater
9.浏览器总览 | BrowserView
10.浏览器窗口 | BrowserWindow
11.浏览器窗口代理 | BrowserWindowProxy)
12.ClientRequest
13.剪贴板 | clipboard
14.内容追踪 | contentTracing
15.小型文字档案 | Cookies
16.crashReporter
17.调试器 | Debugger
18.desktopCapturer
19.dialog
20.电子下载 | DownloadItem
21.环境变量 | Environment Variables
22.无框窗口 | Frameless Window
23.globalShortcut
24.IncomingMessage
25.ipcMain
26.IPC渲染器 | ipcRenderer
27.语言环境 | Locales
28.画面 | Menu
29.MenuItem
30.本地图像 | nativeImage
31.net
32.通知 | Notification
33.权限监控 | powerMonitor
34.权限存储拦截器 | powerSaveBlocker
35.处理 | process
36.协议 | protocol
37.远程 | remote
38.sandbox
39.屏幕 | screen
40.会话 | session
41.shell
42.系统表现 | systemPreferences
43.触摸板 | TouchBar
44.触摸板按钮 | TouchBarButton
45.触摸板颜色选择器 | TouchBarColorPicker
46.触摸板组 | TouchBarGroup
47.触摸板标签 | TouchBarLabel
48.触摸板弹出框 | TouchBarPopover
49.触摸板清理 | TouchBarScrubber
50.触摸板分段控制 | TouchBarSegmentedControl
51.触摸板滑块 | TouchBarSlider
52.触摸板间隔 | TouchBarSpacer
53.Tray
54.网页内容 | webContents
55.网页框架 | webFrame
56.网页要求 | WebRequest
57.窗口开启 | window.open