使用native Node modules

原文:https://github.com/electron/electron/blob/master/docs/tutorial/using-native-node-modules.md
譯者:Lin

Electron支持native Node modules切诀,但是因為Electron非常有可能從安裝在你系統(tǒng)的Node二進制文件中使用一個不同版本的V8绰寞,你必須要在編譯native modules時手動指定本地Electron頭部熊锭。

<h2 id="how-to-install-native-modules">如何安裝本地模塊</h2>

三種方法安裝native modules:

<h3 id="using-npm">使用<code>npm</code></h3>

通過設(shè)置一些環(huán)境變量,你可以直接使用npm來安裝模塊枉证。

一個Electron所有依賴的例子:

# Electron的版本阱州。
export npm_config_target=1.2.3
# Electron架構(gòu),可以是ia32或者x64.
export npm_config_arch=x64。
export npm_config_target_arch=x64
# 下載Electron的頭部光酣。
export npm_config_disturl=https://atom.io/download/electron
# 告訴node-pre-gyp我們要編譯Electron。
export npm_config_runtime=electron
# 告訴node-pre-gyp從源碼中編譯模塊脉课。
export npm_config_build_from_source=true
# 安裝所有依賴救军,并且將緩存存儲在~/.electron-gyp。
HOME=~/.electron-gyp npm install

<h3 id="installing-modules-and-rebuilding-for-electron">安裝模塊并且重新編譯Electron</h3>

你可以像其他Node項目一樣選擇安裝模塊倘零,然后使用electron-rebuild 包重新編譯Electron的模塊唱遭。這個模塊可以得到Electron的版本并且處理手動步驟中的下載頭部和為你的應(yīng)用編譯native modules。

安裝electron-rebuild并且使用它重編譯模塊的例子:

npm install --save-dev electron-rebuild

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

# Windows中如果你遇到了問題呈驶,請嘗試:
.\node_modules\.bin\electron-rebuild.cmd

<h3 id="manually-building-for-electron">手動編譯Electron</h3>

如果你是一個開發(fā)人員開發(fā)了一個native module并且想使用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是Electron的版本司致。--dist-url=...指明從哪里下載頭部。--arch=x64`說明模塊在64位系統(tǒng)中編譯聋迎。

<h2 id="troubleshooting">排除故障</h2>

如果你安裝了一個native modules并且發(fā)現(xiàn)它沒有工作脂矫,你需要檢查以下方面:

  • 模塊的架構(gòu)是否和Electron的架構(gòu)相同(ia32或者x64)。
  • 你升級Electron之后霉晕,你是否重新編譯了模塊庭再。
  • 當(dāng)有疑問的時候,首先應(yīng)該重新運行electron-rebuild娄昆。

<h2 id="modules-that-rely-on-prebuild">依賴于<code>prebuild</code>的模塊</h2>

prebuild 提供一個方法佩微,可以非常容易的使用預(yù)編譯二進制文件發(fā)布基于多個Electron和Node版本的native Node modules。

如果模塊提供Electron使用的二進制文件萌焰,為了充分的利用預(yù)編譯的二進制文件情確保刪掉--build-from-sourcenpm_config_build_from_source兩個環(huán)境變量哺眯。

<h2 id="modules-that-rely-on-node-pre-gyp">依賴于<code>node-pre-gyp</code>的模塊</h2>

node-pre-gyp tool提供一個方法,可以使用預(yù)編譯二進制文件來展開/有效利用native Node modules扒俯,許多流行模塊都使用了這個奶卓。

通常這些模塊可以非常好的在Electron下工作,但是有時候當(dāng)Electron使用了一個比Node新的版本的V8撼玄,并且有ABI改變的時候夺姑,不好的事情就會發(fā)生。所以通常情況下建議使用源代碼編譯本地模塊掌猛。

如果你遵循npm的方式盏浙,則請在默認(rèn)情況下安裝模塊,如果不是,則你需要在npm中輸入--build-from-source或者設(shè)置npm_config_build_from_source環(huán)境變量废膘。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末竹海,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子丐黄,更是在濱河造成了極大的恐慌斋配,老刑警劉巖,帶你破解...
    沈念sama閱讀 216,470評論 6 501
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件灌闺,死亡現(xiàn)場離奇詭異艰争,居然都是意外死亡,警方通過查閱死者的電腦和手機桂对,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,393評論 3 392
  • 文/潘曉璐 我一進店門甩卓,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人接校,你說我怎么就攤上這事猛频。” “怎么了蛛勉?”我有些...
    開封第一講書人閱讀 162,577評論 0 353
  • 文/不壞的土叔 我叫張陵鹿寻,是天一觀的道長。 經(jīng)常有香客問我诽凌,道長毡熏,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,176評論 1 292
  • 正文 為了忘掉前任侣诵,我火速辦了婚禮痢法,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘杜顺。我一直安慰自己财搁,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 67,189評論 6 388
  • 文/花漫 我一把揭開白布躬络。 她就那樣靜靜地躺著尖奔,像睡著了一般。 火紅的嫁衣襯著肌膚如雪穷当。 梳的紋絲不亂的頭發(fā)上提茁,一...
    開封第一講書人閱讀 51,155評論 1 299
  • 那天,我揣著相機與錄音馁菜,去河邊找鬼茴扁。 笑死,一個胖子當(dāng)著我的面吹牛汪疮,可吹牛的內(nèi)容都是我干的峭火。 我是一名探鬼主播毁习,決...
    沈念sama閱讀 40,041評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼躲胳!你這毒婦竟也來了蜓洪?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 38,903評論 0 274
  • 序言:老撾萬榮一對情侶失蹤坯苹,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后摇天,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體粹湃,經(jīng)...
    沈念sama閱讀 45,319評論 1 310
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,539評論 2 332
  • 正文 我和宋清朗相戀三年泉坐,在試婚紗的時候發(fā)現(xiàn)自己被綠了为鳄。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,703評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡腕让,死狀恐怖孤钦,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情纯丸,我是刑警寧澤偏形,帶...
    沈念sama閱讀 35,417評論 5 343
  • 正文 年R本政府宣布,位于F島的核電站觉鼻,受9級特大地震影響俊扭,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜坠陈,卻給世界環(huán)境...
    茶點故事閱讀 41,013評論 3 325
  • 文/蒙蒙 一萨惑、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧仇矾,春花似錦庸蔼、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,664評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至粗合,卻和暖如春萍嬉,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背隙疚。 一陣腳步聲響...
    開封第一講書人閱讀 32,818評論 1 269
  • 我被黑心中介騙來泰國打工壤追, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人供屉。 一個月前我還...
    沈念sama閱讀 47,711評論 2 368
  • 正文 我出身青樓行冰,卻偏偏與公主長得像溺蕉,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子悼做,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,601評論 2 353

推薦閱讀更多精彩內(nèi)容