野火IM解决方案

野火IM是专业级即时通讯和实时音视频整体解决方案，由北京野火无限网络科技有限公司维护和支持。

主要特性有：私有部署安全可靠，性能强大，功能齐全，全平台支持，开源率高，部署运维简单，二次开发友好，方便与第三方系统对接或者嵌入现有系统中。详细情况请参考在线文档。

主要包括一下项目：

野火IM Vue Electron Demo，演示如何将野火IM的能力集成到Vue Electron项目。

前置说明

1. 本项目所使用的PC SDK是需要付费的，价格请参考费用详情
2. PC SDK支持试用，具体请看试用说明
3. 本项目默认只能连接到官方服务，购买或申请试用之后，替换PC SDK，即可连到自行部署的服务

分支说明

1. master：基于Vue 3开发，是未来的开发重心
2. vue2：基于Vue 2开发，进入维护模式，不在开发新功能，鉴于Vue 2已经终止支持且不再维护，建议客户升级到Vue 3版本

环境依赖

mac系统

1. 最新版本的Xcode
2. nodejs v18.19.0
3. npm v10.2.3
4. python 2.7.X
5. git
6. npm install -g node-gyp@8.3.0

windows系统

1. nodejs v18.19.0
2. python 2.7.X
3. git
4. npm 6.14.15
5. npm install --global --vs2019 --production windows-build-tools
6. npm install -g node-gyp@8.3.0

第5步安装windows开发环境的安装内容较多，如果网络情况不好可能需要等较长时间，选择早上网络较好时安装是个好的选择

linux系统

1. nodejs v18.19.0
2. python2.7X
3. git
4. binutils

开发

1. npm config set electron_mirror https://repo.huaweicloud.com/electron/设置electron镜像，建议使用华为镜像，也可以使用其他镜像。
2. npm ci，建议使用华为镜像npm ci --registry=https://mirrors.huaweicloud.com/repository/npm/
3. npm run dev

注意避免使用cnpm，我们使用cnpm出现过一些奇怪问题的情况。如果您使用cnpm当遇到问题时请切换到npm试一下。另外代码路径中，不能有中文或者有空格，否则可能开发和打包过程中可能有问题。

vue-devtool 调试

1. npm install -g vue-devtools
2. 启动vue-devtools
3. 根据第 2 步的提示，将script注入到public/index.html的head里面
4. 项目目录下执行npm run dev

打包

打包为当前平台架构软件

npm run package

yarn

1. yarn install --ignore-engines
2. yarn run package

GitHub 在线打包

1. fork 本仓库
2. 新增、修改功能等
3. 阅读.github/workflows/github-actions-package.yml里面的注释，并根据实际情况修改，比如是否打包Linux版本等
4. 浏览器访问 GitHub fork后的仓库， actions -> 打包 vue-pc-chat -> run workflow -> 选择分支等 -> Run workflow，具体可以参考这儿

交叉打包

打包为其它平台架构软件

#打包windows系统amd64架构
npm run cross-package-win

#打包windows系统x86架构
npm run cross-package-win32

#打包linux系统amd64架构
npm run cross-package-linux

#打包linux系统arm64架构
npm run cross-package-linux-arm64

#打包mac系统
npm run cross-package-mac

Electron版本

目前master的使用的Electron版本是13.6.9。如果您使用的SDK是8的，请切换到分支electron_8 。旧版本将进入维护阶段不再添加新的功能，正在开发中的朋友们可以联系我们更新到最新SDK。SDK是跟版本无关的，如果您的应用是其他版本的Electron，也可以使用我们提供的SDK。

音视频

默认附带免费版本音视频，关于野火音视频可以参考野火音视频使用说明和野火音视频简介。如果使用音视频高级版，请参考音视频高级版切换方法。

常见开发问题

1. 如何调试？PC使用了Electron，内嵌Chrome浏览器，跟在浏览器上开发调试是一样的。快捷键Ctrl +g(MAC下是CMD+g)打开开发者模式。

2. 打包时，如果一直显示installing production dependencies platform=win32 arch=ia32 appDir=C:\<your path>\pc-chat\dist， 或者提示下载什么之类的，可将dep目录下对应平台的electron依赖，解压到对应的目录。

   // windows
   C:\Users\<你的用户名>\.electron-gyp
   // mac/linux
   ~/.electron-gyp

3. 打包时，如果下载electron版本超时，可以国内的electron镜像。比如使用华为的electron镜像的命令是：npm config set electron_mirror https://mirrors.huaweicloud.com/electron/。

4. windows上需要严格按照环境进行安装，mac上环境比较简单一些，安装node和node-gyp就可以了 另外如果还有问题，请试试命令npm cache clean --force ，然后删掉node_modules，再重新在非管理员权限下npm ci --registry=https://mirrors.huaweicloud.com/repository/npm/

有些杀毒软件会对electron打包的软件报病毒，详情请参考electron报病毒 。安装时可能被杀毒软件限制安装，这时候可以让用户使用绿色免安装版（打包后release目录下的unpacked目录）。如果运行时报错，请在杀毒软件里加上例外。另外有条件的公司可以考虑去360官方或其他杀软的官方提交检测。

6. 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 解决

7. win平台野火客户端依赖Visual C++ Redistributable Package runtime。如果用户PC上没有安装就需要安装之后才能运行，请从微软官方下载安装 https://www.microsoft.com/zh-CN/download/details.aspx?id=48145 。注意这个安装包是有32位/64位区分的，需要安装对应架构的版本。

8. MAC应用截屏时只能截屏空白桌面，无法截图窗口内容。这是因为没有通过mac系统的安全许可，在设置-》安全与隐私-》切换到隐私那个标签-》屏幕录制-》在野火IM PC应用前打勾，并重启应用。

9. npm install 报Unexpected end of JSON input while parsing near...错误

   如果常见问题4解决不了，可以尝试　 npm config set registry https://mirrors.huaweicloud.com/repository/npm/ ，然后在按常见问题4的步骤进行

10. 音视频相关问题，请参考以下文档

    1. av readme
    2. 音视频常见问题

11. 纯内网环境，不能显示表情

    1. 将src/assets/twemoji目录上传到一个内网能访问的服务器，比如部署app server的服务器
    2. 确保通过http(s)://base_twemoji_url/72x72/1f1e6.png能访问到对应表情，此处1f1e6.png蓝底白字大写字母A
    3. 修改config.js，将https://static.wildfirechat.net/twemoji/assets/ 替换成新部署的http(s)://base_twemoji_url/，需要注意，最后一个/不能省略
    4. 动态表情类似处理

12. 想自己部署表情图片

    请常见问题11

13. 一直提示：Electron failed to install correctly, please delete node_modules/electron and try installing again。见上面 使用国内Electron镜像 问题。

14. windows 7 无法正常启动，显示黑屏或白屏

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

       // pls refer to: https://blog.csdn.net/youyudexiaowangzi/article/details/118676790
       // windows 7 下面，如果启动黑屏，请将下面注释打开
       //app.disableHardwareAcceleration();

15. MAC打包的版本是Universal版本，可以同时支持x64架构和arm64架构。Universal版本比单架构版本要大一下，如果想要打包单架构的版本，可以把野火SDK瘦身到对应单一架构，然后打包对应平台。具体实现方法请自行查找。

16. MAC系统要求签名才可以运行，有可能需要对野火的SDK重新签名才可以，签名的方法请网络搜索。

17. Linux Arm64版本打包时，在linux+arm64的环境下打包deb格式的版本时会出问题，因为有个依赖软件fpm是x64架构的，必须在x64架构的机器下交叉打包，系统可以是windows/mac/linux都行（mac的arm64机器也可以，因为mac系统有rosetta可以运行x64软件）。

18. 压力测试发现，Vue 内置的keep-alive组件，可能有缓慢的内存泄漏问题，可将HomePage.vue里面的keep-alive移除，由于activated和deactivated回调，要使用keep-alive组件才生效，需要妥善处理这两个回调里面的逻辑。

19. 如果使用专业版IM服务且使用野火对象存储服务，需要使野火对象存储服务支持https，PC客户端和Web客户端需要使用HTTPS上传。

20. 打包失败，提示Error in script "<stdin>" on line 75 -- aborting creation process

    系统的用户名是中文，或者项目放在中文路径下，会导致打包失败，请避免使用中文用户名或中文路径进行打包，可参考这儿

21. Windows 打包失败，提示ERR_ELECTRON_BUILDER_CANNOT_EXECUTE

    每次打包之前，打开任务管理器，查看是否有electron进程运行，必须全部杀掉才能正常打包。可参考github issue

截图

License

1. Under the Creative Commons Attribution-NoDerivs 3.0 Unported license. See the LICENSE file for details.