# react-pc-chat
**Repository Path**: wfchat/react-pc-chat
## Basic Information
- **Project Name**: react-pc-chat
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 6
- **Created**: 2021-03-19
- **Last Updated**: 2024-09-07
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
## 野火IM解决方案
野火IM是专业级即时通讯和实时音视频整体解决方案，由北京野火无限网络科技有限公司维护和支持。
主要特性有：私有部署安全可靠，性能强大，功能齐全，全平台支持，开源率高，部署运维简单，二次开发友好，方便与第三方系统对接或者嵌入现有系统中。详细情况请参考[在线文档](https://docs.wildfirechat.cn)。
主要包括一下项目：
| [GitHub仓库地址(主站)](https://github.com/wildfirechat) | [码云仓库地址(镜像)](https://gitee.com/wfchat) | 说明 | 备注 |
| ------------------------------------------------------------ | ----------------------------------------------------- | ----------------------------------------------------------------------------------------- | ---------------------------------------------- |
| [android-chat](https://github.com/wildfirechat/android-chat) | [android-chat](https://gitee.com/wfchat/android-chat) | 野火IM Android SDK源码和App源码 | 可以很方便地进行二次开发，或集成到现有应用当中 |
| [ios-chat](https://github.com/wildfirechat/ios-chat) | [ios-chat](https://gitee.com/wfchat/ios-chat) | 野火IM iOS SDK源码和App源码 | 可以很方便地进行二次开发，或集成到现有应用当中 |
| [pc-chat](https://github.com/wildfirechat/pc-chat) | [pc-chat](https://gitee.com/wfchat/pc-chat) | 基于[Electron](https://electronjs.org/)开发的PC平台应用 | |
| [web-chat](https://github.com/wildfirechat/web-chat) | [web-chat](https://gitee.com/wfchat/web-chat) | Web平台的Demo, [体验地址](http://web.wildfirechat.cn) | |
| [wx-chat](https://github.com/wildfirechat/wx-chat) | [wx-chat](https://gitee.com/wfchat/wx-chat) | 微信小程序平台的Demo | |
| [server](https://github.com/wildfirechat/server) | [server](https://gitee.com/wfchat/server) | IM server | |
| [app server](https://github.com/wildfirechat/app_server) | [app server](https://gitee.com/wfchat/app_server) | 应用服务端 | |
| [robot_server](https://github.com/wildfirechat/robot_server) | [robot_server](https://gitee.com/wfchat/robot_server) | 机器人服务端 | |
| [push_server](https://github.com/wildfirechat/push_server) | [push_server](https://gitee.com/wfchat/push_server) | 推送服务器 | |
| [docs](https://github.com/wildfirechat/docs) | [docs](https://gitee.com/wfchat/docs) | 野火IM相关文档，包含设计、概念、开发、使用说明，[在线查看](https://docs.wildfirechat.cn/) | | |
## pc-chat说明
本工程是野火IM PC平台，详情可以阅读[docs](http://docs.wildfirechat.cn).
开发一套IM系统真的很艰辛，请路过的朋友们给点个star，支持我们坚持下去🙏🙏🙏🙏🙏
### 联系我们
> 商务合作请优先采用邮箱和我们联系。技术问题请到[野火IM论坛](http://bbs.wildfirechat.cn/)发帖交流。
1. heavyrain.lee 邮箱: heavyrain.lee@wildfirechat.cn 微信：wildfirechat
2. imndx 邮箱: imndx@wildfirechat.cn 微信：wfchat
### 问题交流
1. 如果大家发现bug，请在GitHub提issue
2. 其他问题，请到[野火IM论坛](http://bbs.wildfirechat.cn/)进行交流学习
3. 微信公众号
## 体验
可下载我们已编译好的可执行文件进行体验，[pc-chat 下载](https://github.com/wildfirechat/pc-chat/releases)
## 开发
#### 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
##### 开发
```
$ npm install
$ npm run copy-mac
$ npm run dev
```
> npm run copy-mac 是用来拷贝平台相关的功能库，如果功能库有更新，一定要再次运行拷贝。常见的错误是客户收到新的功能库，放到功能库目录后，忘记运行次命令，导致运行结果不正确。
> 开发、调试时，可用```Login/index_dev.js```替换```Login/index.js```，这样成功登录之后，刷新页面，不需要重新扫码登录。
##### 打包
1. ```npm install``` 安装依赖
2. ```npm run package-mac``` 打包mac版本，软件生成在release目录下
#### 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
##### 开发
0. 启动CMD终端 **（不能以管理员权限启动，要用普通权限）**
1. ```npm install```
2. 执行```node -p "process.arch"```, 确认node架构
3. ```node```为32位时，执行```npm run copy-win32```
4. ```node```为64位时，执行```npm run copy-win```
5. ```npm run dev```
> npm run copy-XXX 是用来拷贝平台相关的功能库，如果功能库有更新，一定要再次运行拷贝。常见的错误是客户收到新的功能库，放到功能库目录后，忘记运行次命令，导致运行结果不正确。
##### 打包
1. ```npm install``` 安装依赖（不能在管理员权限下运行，要用普通权限）
2. ```npm run package-win32``` 打包windows 32位版本，软件生成在release目录下
2. ```npm run package-win``` 打包window 64位版本，软件生成在release目录下
#### linux系统x64架构
##### 环境准备
> 请严格安装下面的版本安装对应依赖，否则无法打包
1. nodejs10.16.X
2. python2.7X
3. git
##### 开发
> 具体开发、集成相关说明，请参考[pc开发](https://docs.wildfirechat.cn/pc/)
```
$ npm install
$ npm run copy-linux
$ npm run dev
```
##### 打包
1. ```npm install``` 安装依赖
2. ```npm run package-linux``` 打包linux版本，软件生成在release目录下
#### linux系统arm64架构
##### 环境准备
> 请严格安装下面的版本安装对应依赖，否则无法打包
1. nodejs10.16.X
2. python2.7X
3. git
4. fpm
```
sudo apt-get update
sudo apt-get install ruby-dev build-essential
sudo gem install fpm -v 1.10.2
```
> fpm 1.11版本有问题，需要使用1.10.2版本
##### 开发
> 具体开发、集成相关说明，请参考[pc开发](https://docs.wildfirechat.cn/pc/)
```
$ npm install
$ npm run copy-linux-arm64
$ npm run dev
```
##### 打包
1. ```npm install``` 安装依赖
2. ```npm run package-linux-arm64``` 打包linux版本，软件生成在release目录下
##### 常见问题
1. 如何调试？PC使用了Electron，内嵌Chrome浏览器，跟在浏览器上开发调试是一样的。快捷键Ctrl
+g(MAC下是CMD+g)打开开发者模式。
2. 打包时，如果一直显示```installing production dependencies platform=win32 arch=ia32 appDir=C:\\pc-chat\dist```，
或者提示下载什么之类的，可将```dep```目录下对应平台的electron依赖，解压到对应的目录。
```
// windows
C:\Users\<你的用户名>\.electron-gyp
// mac/linux
~/.electron-gyp
```
3. 打包时，如果下载electron版本超时，可以使用我们下载好的[electron](./electron)放到缓存目录。
4. windows上需要严格按照环境进行安装，mac上环境比较简单一些，安装node和node-gyp就可以了
另外如果还有问题，请试试命令```npm cache clean --force ```，然后删掉node_modules，再重新在非管理员权限下```npm install```
5. 有些杀毒软件会对electron打包的软件报病毒，详情请参考[electron报病毒](https://www.baidu.com/s?wd=electron%20360%E6%8A%A5%E7%97%85%E6%AF%92&pn=0&oq=electron%20360%E6%8A%A5%E7%97%85%E6%AF%92&tn=84053098_3_dg&ie=utf-8&rsv_pq=ec2a876200198701&rsv_t=e981739vB2ZMksgGv8ZOV%2Fb4WIhJDXXzLTfMv24NmIN0itMzRiGjMNnh1qARt19Uzf1s%2FA) 。安装时可能被杀毒软件限制安装，这时候可以让用户使用绿色免安装版（打包后release目录下的unpacked目录）。如果运行时报错，请在杀毒软件里加上例外。另外有条件的公司可以考虑去[360官方](https://open.soft.360.cn)或其他杀软的官方提交检测。
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](https://packages.debian.org/buster/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 install``` 报```Unexpected end of JSON input while parsing near...```错误
如果常见问题4解决不了，可以尝试``` npm config set registry http://registry.npm.taobao.org/ ```，然后在按常见问题4的步骤进行
11. 音视频相关问题，请参考以下文档
1. [av readme](src/js/wfc/av/internal/README.MD)
2. [音视频常见问题](https://docs.wildfirechat.cn/faq/webrtc.html?h=webrtc)
## License
1. Under the Creative Commons Attribution-NoDerivs 3.0 Unported license. See the [LICENSE](https://github.com/wildfirechat/pc-chat/blob/master/LICENSE) file for details.
# 鸣谢
本项目基于[wewechat](https://github.com/trazyn/weweChat)开发，原项目的READ见[wewechat readme](./README_wewechat.MD)