2016-01-28 14:17:48 +00:00
|
|
|
|
# 使用原生 node 模組
|
2016-01-28 10:20:39 +00:00
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
原生的 Node 模組 Electron 都有支援,但自從 Electron 使用了與 Node 官方不同的 V8 版本後,當你要建置原生模組的時候,你需要手動指定 Electron 標頭的位置。
|
2016-01-28 10:20:39 +00:00
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
## 原生 Node 模組的相容性
|
2016-01-28 10:20:39 +00:00
|
|
|
|
|
2016-03-31 23:49:59 +00:00
|
|
|
|
原生模組可能在 Node 開始使用一個新版本的 V8 時毀損,為了確保你想要用的模組能正確與 Electron 一起運行,你應該檢查是否支援 Electron 內部 Node 版本,你可以查看 [releases](https://github.com/electron/electron/releases) 或是使用 `process.version` (範例請見 [Quick Start](https://github.com/electron/electron/blob/master/docs/tutorial/quick-start.md)) 來檢查哪個 Node 版本是現在的 Electron 使用的。
|
2016-01-28 10:20:39 +00:00
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
你可以考慮給你自己的模組使用 [NAN](https://github.com/nodejs/nan/),因為它可以較輕易的支援多種版本的 Node,它對於移植舊的模組到新版本的 Node 以便與 Electron 一起運作也是很有用的。
|
2016-01-28 10:20:39 +00:00
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
## 如何安裝原生模組
|
2016-01-28 10:20:39 +00:00
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
三種安裝原生模組的方式:
|
2016-01-28 10:20:39 +00:00
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
### 簡單的方法
|
2016-01-28 10:20:39 +00:00
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
最直接重新建置原生模組的方法是透過 [`electron-rebuild`](https://github.com/paulcbetts/electron-rebuild) 套件,這個套件處理了手動下載標頭和建制原生模組的步驟:
|
2016-01-28 10:20:39 +00:00
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
npm install --save-dev electron-rebuild
|
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
# 每次你執行 "npm install", 執行這句
|
2016-01-28 10:20:39 +00:00
|
|
|
|
./node_modules/.bin/electron-rebuild
|
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
# 在 Windows 上如果你有狀況,試試看:
|
2016-01-28 10:20:39 +00:00
|
|
|
|
.\node_modules\.bin\electron-rebuild.cmd
|
|
|
|
|
```
|
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
### 使用 npm
|
2016-01-28 10:20:39 +00:00
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
你也可以使用 `npm` 安裝模組,步驟與 Node 模組的安裝相同,除了你需要設定一些環境變數:
|
2016-01-28 10:20:39 +00:00
|
|
|
|
|
|
|
|
|
```bash
|
2016-11-04 23:13:39 +00:00
|
|
|
|
export npm_config_disturl=https://atom.io/download/electron
|
2016-01-28 10:20:39 +00:00
|
|
|
|
export npm_config_target=0.33.1
|
|
|
|
|
export npm_config_arch=x64
|
|
|
|
|
export npm_config_runtime=electron
|
|
|
|
|
HOME=~/.electron-gyp npm install module-name
|
|
|
|
|
```
|
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
### 使用 node-gyp
|
2016-01-28 10:20:39 +00:00
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
要把 Node 模組與 Eletron 的標頭一起建置,你需要告訴 `node-gyp` 下載標頭到哪裡,以及要使用哪個版本:
|
2016-01-28 10:20:39 +00:00
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
$ cd /path-to-module/
|
2016-11-04 23:13:39 +00:00
|
|
|
|
$ HOME=~/.electron-gyp node-gyp rebuild --target=0.29.1 --arch=x64 --dist-url=https://atom.io/download/electron
|
2016-01-28 10:20:39 +00:00
|
|
|
|
```
|
|
|
|
|
|
2016-01-28 14:17:48 +00:00
|
|
|
|
`HOME=~/.electron-gyp` 改變了尋找開發標頭的地方,`--target=0.29.1` 是 Eletron 的版本, `--dist-url=...` 指定了下載標頭到哪, `--arch=x64` 指出模組要建置在 64 位元系統。
|