記錄編譯electerm踩過的坑
最近導師給了個任務,讓我改一個ssh工具,首選的有PuTTY和electerm。PuTTY這個軟體感覺有點古老,而且是C寫的,我就選了electerm
electerm是github上的一個開源專案,基於electron編寫,而electron是一個跨平臺的開發框架。有了electron我們可以用nodejs來開發桌面應用,大名鼎鼎的vscode就是用electron開發的
之前沒接觸過nodejs,更別說electron了,作為小白開始一點點摸索。首先在計算機上安裝nodejs
安裝nodejs
這裡使用nvm安裝nodejs,nvm是nodejs的版本控制工具。有了nvm,我們可以在計算機上安裝並管理多個不同版本的nodejs,可以從github獲取Windows版本的nvm安裝包進行安裝,詳細安裝配置過程省去
安裝完nvm之後,就可以安裝nodejs。安裝nodejs的最新版14.8.0,另外,npm也會附帶安裝好。安裝完後,配置全域性依賴包路徑,也就是說多個版本的node可以共用同一個依賴包路徑
配置完後安裝cnpm,這是淘寶npm映象,之後就可以用cnpm命令代替npm命令
編譯electerm
下載依賴包
從github上下載electerm原始碼,用vscode開啟。按照github頁面上的提示,在命令列內輸入cnpm i
,表示下載軟體需要的依賴包。執行完後,路徑內會出現node_modules資料夾,表示依賴包檔案
在這一步,一開始就遇到了問題,檢視錯誤提示,大意是python語法錯誤,原來程式執行還需要python環境,但是本機上安裝的是python3,而需要python2,之後就安裝python2,進行一系列配置,這一步終於完成
webpack打包
接下來執行cnpm start
,表示啟動webpack-dev-server對原始檔進行打包編譯。在這一步又出現了錯誤,其中一個依賴檔案丟擲了異常,"[git-rev-sync] no git repository found",意思是找不到git倉庫
對於這個錯誤,我們只要在專案根路徑建立git倉庫就能解決。最好首先刪除下載的依賴包資料夾node_modules,在命令列輸入git init
建立一個空的git倉庫,接著執行git add .
和git commit -m "init"
將本專案提交到倉庫中。然後重新執行上一步cnpm i
cnpm start
進行打包,這一步就能完成
啟動app
在上一步成功執行後,webpack-dev-server會一直處於執行中,並提示我們
Project is running at http://localhost:XXXX/
一開始我開啟瀏覽器輸入了這個地址,結果並沒有出現軟體介面,F12開啟開發者工具,發現報錯了
後來在electerm專案頁面上才看到要在另一個命令列終端中輸入cnpm run app
這個命令,而不是直接在瀏覽器中開啟。執行這個命令,就會彈出electerm的軟體介面
本以為成功編譯並運行了軟體,結果在軟體介面上彈出了一個錯誤
Error: The module '\...\electerm-1.4.4\node_modules\[email protected]@node-pty\build\Release\conpty.node'
was compiled against a different Node.js version using NODE_MODULE_VERSION 72.
This version of Node.js requires NODE_MODULE_VERSION 80.
Please try re-compiling or re-installing the module (for instance, using `npm rebuild` or `npm install`).
at process.func [as dlopen] (electron/js2c/asar.js:140:31)
at Object.Module._extensions..node (internal/modules/cjs/loader.js:1034:18)
at Object.func [as .node] (electron/js2c/asar.js:140:31)
at Module.load (internal/modules/cjs/loader.js:815:32)
at Module._load (internal/modules/cjs/loader.js:727:14)
at Function.Module._load (electron/js2c/asar.js:769:28)
at Module.require (internal/modules/cjs/loader.js:852:19)
at require (internal/modules/cjs/helpers.js:74:18)
at new WindowsPtyAgent (\...\electerm-1.4.4\node_modules\[email protected]@node-pty\lib\windowsPtyAgent.js:35:36)
at new WindowsTerminal (\...\electerm-1.4.4\node_modules\[email protected]@node-pty\lib\windowsTerminal.js:49:24)
at Object.spawn (\...\electerm-1.4.4\node_modules\[email protected]@node-pty\lib\index.js:28:12)
at Terminal.localInit (\...\electerm-1.4.4\src\app\server\session.js:135:21)
at Terminal.init (\...\electerm-1.4.4\src\app\server\session.js:69:36)
at exports.terminal (\...\electerm-1.4.4\src\app\server\session.js:812:14)
at \...\electerm-1.4.4\src\app\server\server.js:44:22
at Layer.handle [as handle_request] (\...\electerm-1.4.4\node_modules\[email protected]@express\lib\router\layer.js:95:5)
意思就是node_pty的NODE_MODULE_VERSION和electron所需要的不一致。查了很多資料,最後看到官方文件上有這個問題的解決方法,對於裡面所描述的第一個方法,使用electron rebuild
重新編譯模組,我試了多次但不起作用。最後還是使用了手動編譯的方法
- 全域性安裝node-gyp,
cnpm install node-gyp -g
,node-gyp就是用來編譯模組的 - 刪除./node_modules/[email protected]@node-pty/build資料夾
- 使用命令列進入./node_modules/node-pty,
cd .\node_modules\node-pty\
- 重新編譯node-pty,
node-gyp rebuild --target=9.1.2 --arch=x64 --dist-url=https://electronjs.org/headers
- 執行
cnpm start
,啟動後在另一個命令列終端上執行cnpm run app
- electerm成功執行
原本以為能在一週內編譯成功的,結果硬是拖到了一週半,太難了=。=