非常教程

Electron参考手册

指南 | Guides

使用本机节点模块 | Using Native Node Modules

Electron支持本地节点模块,但由于Electron很可能使用与系统中安装的Node二进制文件不同的V8版本,因此在构建本地模块时必须手动指定Electron头文件的位置。

如何安装本地模块

三种安装本地模块的方法:

使用npm

通过设置一些环境变量,您可以npm直接使用来安装模块。

为Electron安装所有依赖关系的示例:

# Electron's version.
export npm_config_target=1.2.3
# The architecture of Electron, can be ia32 or x64.
export npm_config_arch=x64
export npm_config_target_arch=x64
# Download headers for Electron.
export npm_config_disturl=https://atom.io/download/electron
# Tell node-pre-gyp that we are building for Electron.
export npm_config_runtime=electron
# Tell node-pre-gyp to build module from source code.
export npm_config_build_from_source=true
# Install all dependencies, and store cache to ~/.electron-gyp.
HOME=~/.electron-gyp npm install

为电子安装模块和重建

您也可以选择像其他Node项目一样安装模块,然后使用该electron-rebuild软件包为Electron重建模块。该模块可以获得Electron版本,并处理手动下载头文件和为您的应用程序构建本机模块的步骤。

一个electron-rebuild使用它安装并重建模块的例子:

npm install --save-dev electron-rebuild

# Every time you run "npm install", run this:
./node_modules/.bin/electron-rebuild

# On Windows if you have trouble, try:
.\node_modules\.bin\electron-rebuild.cmd

手动建立电子

如果您是开发本地模块的开发人员,并且想要针对Electron进行测试,则可能需要手动为Electron重新构建模块。您可以node-gyp直接使用以构建Electron:

cd /path-to-module/
HOME=~/.electron-gyp node-gyp rebuild --target=1.2.3 --arch=x64 --dist-url=https://atom.io/download/electron

HOME=~/.electron-gyp变化在哪里可以找到发展的头。该--target=1.2.3是电子版本。该--dist-url=...指定在哪里下载的头。该--arch=x64模块是为64位系统构建的。

故障排除

如果您安装了本机模块并且发现它无法正常工作,则需要检查以下内容:

  • 模块的体系结构必须与Electron的体系结构(ia32或x64)相匹配。
  • 升级Electron后,通常需要重新构建模块。
  • 当有疑问时,先运行electron-rebuild

依赖于prebuild

prebuild 提供了一种轻松发布本地Node模块的方法,该模块具有用于多个版本的Node和Electron的预先构建的二进制文件。

如果模块为Electron中的使用提供二进制文件,请确保省略--build-from-sourcenpm_config_build_from_source环境变量以充分利用预先构建的二进制文件。

依赖于node-pre-gyp

node-pre-gyp工具提供了一种使用预先构建的二进制文件部署本地节点模块的方法,许多流行模块正在使用它。

通常,这些模块在Electron下工作良好,但有时当Electron使用比Node更新版本的V8时,并且有ABI更改时,可能会发生不好的事情。所以通常建议始终从源代码构建本地模块。

如果你正在跟踪的npm安装模块的方式,那么这是自动进行的,如果不是,你必须通过--build-from-sourcenpm,或设置npm_config_build_from_source环境变量。

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