tianyazjq / vue-pc-chat

野火IM PC 客户端,支持Windows、MacOS,Linux,支持国产操作系统和国产CPU

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

野火IM解决方案

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

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

主要包括一下项目:

GitHub仓库地址(主站) 码云仓库地址(镜像) 说明 备注
android-chat android-chat 野火IM Android SDK源码和App源码 可以很方便地进行二次开发,或集成到现有应用当中
ios-chat ios-chat 野火IM iOS SDK源码和App源码 可以很方便地进行二次开发,或集成到现有应用当中
pc-chat pc-chat 基于Electron开发的PC平台应用
web-chat web-chat Web平台的Demo, 体验地址
wx-chat wx-chat 微信小程序平台的Demo
server server IM server
app server app server 应用服务端
robot_server robot_server 机器人服务端
push_server push_server 推送服务器
docs docs 野火IM相关文档,包含设计、概念、开发、使用说明,在线查看

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

环境依赖

mac系统

  1. 最新版本的Xcode
  2. nodejs 10.16.X
  3. npm 6.9.0
  4. python 2.7.X
  5. git
  6. npm install -g node-gyp

windows系统

  1. nodejs v10.16.x
  2. python 2.7.X
  3. git
  4. npm 6.9.0
  5. npm install --global --vs2015 windows-build-tools
  6. npm install -g node-gyp

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

linux系统

  1. nodejs10.16.X
  2. python2.7X
  3. git

开发

  1. npm install
  2. npm run dev

打包

打包为当前平台架构软件

npm run package

交叉打包

打包为其它平台架构软件

#打包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系统amd64架构
npm run cross-package-mac

常见开发问题

  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版本并放到缓存目录。

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

  5. 有些杀毒软件会对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. 使用cnpm后打包失败,在某些平台cnpm是会出现问题的,请使用npm。

  10. npm installUnexpected end of JSON input while parsing near...错误

    如果常见问题4解决不了,可以尝试 npm config set registry http://registry.npm.taobao.org/ ,然后在按常见问题4的步骤进行

  11. 音视频相关问题,请参考以下文档

    1. av readme
    2. 音视频常见问题
  12. 纯内网环境,不能显示表情

    1. src/assets/twemoji目录上传到一个内网能访问的服务器,比如部署app server的服务器
    2. 确保通过http(s)://base_twemoji_url/72x72/1f1e6.png能访问到对应表情,此处1f1e6.png蓝底白字大写字母A
    3. 修改twemoji.js,将https://static.wildfirechat.net/twemoji/assets/替换成新部署的http(s)://base_twemoji_url/,需要注意,最后一个/不能省略
  13. 想自己部署表情图片 请常见问题12

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

    1. 尝试执行node node_modules/electron/install.js,需要保证网络能畅通访问 github
    2. 如果上一步还是失败的话,请参考这儿

截图

License

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

About

野火IM PC 客户端,支持Windows、MacOS,Linux,支持国产操作系统和国产CPU

License:Other


Languages

Language:HTML 39.0%Language:Vue 30.8%Language:JavaScript 26.7%Language:CSS 3.1%Language:Python 0.4%Language:Shell 0.0%