野火IM是一款專業(yè)級即時通訊和實時音視頻軟件，能夠幫助用戶快速的部署私人的IM平臺，私有部署安全可靠，性能強(qiáng)大，功能齊全，全平臺支持，開源率高，部署運維簡單，二次開發(fā)友好，方便與第三方系統(tǒng)對接或者嵌入現(xiàn)有系統(tǒng)中。

【需要環(huán)境】

　　nodejs v10.16.x

　　python 2.7.X

　　git

　　npm 6.9.0

　　npm install --global --vs2015 windows-build-tools

　　npm install -g node-gyp

【常見開發(fā)問題】

　　如何調(diào)試？PC使用了Electron，內(nèi)嵌Chrome瀏覽器，跟在瀏覽器上開發(fā)調(diào)試是一樣的?？旖萱ICtrl +g(MAC下是CMD+g)打開開發(fā)者模式。

　　打包時，如果一直顯示installing production dependencies platform=win32 arch=ia32 appDir=C:\<your path>\pc-chat\dist， 或者提示下載什么之類的，可將dep目錄下對應(yīng)平臺的electron依賴，解壓到對應(yīng)的目錄。

　　// windows

　　C:\Users\<你的用戶名>\.electron-gyp

　　// mac/linux

　　~/.electron-gyp

　　打包時，如果下載electron版本超時，可以點這里手動下載electron版本并放到緩存目錄。

　　windows上需要嚴(yán)格按照環(huán)境進(jìn)行安裝，mac上環(huán)境比較簡單一些，安裝node和node-gyp就可以了 另外如果還有問題，請試試命令npm cache clean --force ，然后刪掉node_modules，再重新在非管理員權(quán)限下npm install

　　有些殺毒軟件會對electron打包的軟件報病毒，詳情請參考electron報病毒 。安裝時可能被殺毒軟件限制安裝，這時候可以讓用戶使用綠色免安裝版（打包后release目錄下的unpacked目錄）。如果運行時報錯，請在殺毒軟件里加上例外。另外有條件的公司可以考慮去360官方或其他殺軟的官方提交檢測。

　　ubuntu下，啟動時，若提示，A JavaScript error occurred in the main process Uncaught Exception:Error: Cannot open /opt/wildfirechat/resources/app.asar/marswrapper.node: Error: libdouble-conversion.so.1: cannot open shared object file: No such file or directory，可安裝libdouble-conversion1解決

　　win平臺野火客戶端依賴Visual C++ Redistributable Package runtime。如果用戶PC上沒有安裝就需要安裝之后才能運行，請從微軟官方下載安裝。注意這個安裝包是有32位/64位區(qū)分的，需要安裝對應(yīng)架構(gòu)的版本。

　　MAC應(yīng)用截屏?xí)r只能截屏空白桌面，無法截圖窗口內(nèi)容。這是因為沒有通過mac系統(tǒng)的安全許可，在設(shè)置-》安全與隱私-》切換到隱私那個標(biāo)簽-》屏幕錄制-》在野火IM PC應(yīng)用前打勾，并重啟應(yīng)用。

　　使用cnpm后打包失敗，在某些平臺cnpm是會出現(xiàn)問題的，請使用npm。

　　npm install 報Unexpected end of JSON input while parsing near...錯誤

　　如果常見問題4解決不了，可以嘗試　 npm config set registry http://registry.npm.taobao.org/ ，然后在按常見問題4的步驟進(jìn)行

　　音視頻常見問題

　　純內(nèi)網(wǎng)環(huán)境，不能顯示表情

　　將src/assets/twemoji目錄上傳到一個內(nèi)網(wǎng)能訪問的服務(wù)器，比如部署app server的服務(wù)器

　　確保通過http(s)://base_twemoji_url/72x72/1f1e6.png能訪問到對應(yīng)表情，此處1f1e6.png藍(lán)底白字大寫字母A

　　修改twemoji.js，將https://static.wildfirechat.net/twemoji/assets/替換成新部署的http(s)://base_twemoji_url/，需要注意，最后一個/不能省略

　　想自己部署表情圖片 請常見問題12

　　一直提示：Electron failed to install correctly, please delete node_modules/electron and try installing again

　　嘗試執(zhí)行node node_modules/electron/install.js，需要保證網(wǎng)絡(luò)能暢通訪問 github

　　windows 7 無法正常啟動，顯示黑屏

　　background.js 里面找到下面代碼，并取消//app.disableHardwareAcceleration();前面的注釋

　　// pls refer to: https://blog.csdn.net/youyudexiaowangzi/article/details/118676790

　　// windows 7 下面，如果啟動黑屏，請將下面注釋打開

　　//app.disableHardwareAcceleration();