全开源即时通讯(IM)系统-仿微信
1.目标：
E聊SDK目标是打造一个免费开源，接入简单，适应多平台的即时通信SDK，为广大开发者提供便利。
2.简介：
E聊SDK是一套适用于PC端, 移动端的即时通讯解决方案，源代码开放。E聊整合了即时通讯的基础能力，使用E聊，您可以让您的应用快速接入即时聊天的功能。E聊现已适配PC Web, 移动Web, Android, iOS 等平台。
3.系统架构:
image.png
3.1 各模块介绍
E聊服务器: 提供了基础的消息转发功能，用户管理、群组管理等功能;
E聊管理台: 向E聊服务器申请接入SDK 所需要的App Key, Client Secret, App Secret 等；
应用客户端: 使用E聊账号登入E聊服务器，实现单聊、群聊消息收发等功能；
应用后台: 业务应用后台，维护原有的业务用户列表，此外，需维护一张与E聊用户的关系映射表。
3.2 E聊功能介绍
3.2.1 单聊
点对点的基础聊天，支持文字，图片，文件等方式；
3.2.2 群聊
一对多的群聊/讨论组，支持文字，图片，文件等方式；
3.2.3 用户资料管理
用户账号(auid), 密码(token), 昵称，性别，头像，签名，手机，邮箱等;
3.2.4 用户关系管理
用户的好友关系管理，黑名单列表，禁言列表等；
3.2.5 消息通知
客户端SDK可以接受到基础的消息通知，比如用户上线/离线，被加好友，被拉入群聊等；
3.2.6 离线消息
E聊服务器能缓存一定日期内的离线消息，待客户端上线时会自动推送到客户端；
3.3 接入流程
(1).注册登录E聊管理台，在管理台创建APP， 记录App Key, Client Secret, App Secret；
(2).创建E聊用户，可以使用服务端API创建，也可以在E聊管理台创建，在应用后台记录业务用户与E聊用户的映射关系；
(3).整合客户端SDK 进应用客户端，配置SDK参数（如: E聊服务器地址，App Key, Client Secret)；
(4).登录应用后台，获取E聊用户账号(auid, token)实现登录，消息收发；
4.Web客户端简介：
E聊SDK提供了一个基本的Web版客户端Demo源码，通过编译该客户端，可以接入E聊服务器，实现单聊/群聊等功能。WEB客户端源码包含了两部分，一部分是核心SDK(使用TypeScript 开发)，一部分是演示Demo(使用JavaScript + BootstrapVue 2.9.0 开发)。以下介绍如何从源码编译Web客户端。
4.操作步骤:
4.1 下载Release v1.01 源码
git clone https://gitee.com/dzqmeiji/echatim-client-web.git
cd echatim-client-web/
git checkout -b v1.01 v1.01
4.2 编辑客户端连接配置
我们使用E聊线上服务器做为聊天后台，配置都使用默认的配置，只需在src/main.js 中更改AppKey 的配置项即可，关于AppKey的获取请参考 E聊SDK-简介(3): 管理平台使用
// src/main.js 文件内容
719 sdkConfig.host = 'api.echatim.cn'; //使用线上默认配置
720 sdkConfig.httpPort = 58082; //使用线上默认配置
721 sdkConfig.socketPort = 59092; //使用线上默认配置
722 sdkConfig.key = '修改这一项为自己的AppKey';
723 sdkConfig.secret = ''; // 这是保留配置, 不需要更改
4.3 编译源码并启动Web Demo项目
yarn install #下载项目依赖
yarn lib #编译sdk 核心库
yarn start #启动web项目
启动后访问: http://localhost:80 即可访问Web Demo项目。
4.4 体验Web Demo项目
之前已在 E聊SDK-简介(3): 管理平台使用 中创建了E聊用户，使用在管理台创建的用户auid, 用户token 登录即可。
image.png
登录后的聊天界面如下，畅快体验吧!
image.png
4.5 打包成发布版本
这里介绍在mac, linux 上的打包方法，若开发平台是windows, 也可安装git bash工具在bash cmd 窗口上实现打包。
cd echatim-client-web # 在项目根目录准备打包
mkdir -p dist/deploy # 创建打包目录
cp ./src/faces.js dist/deploy/
cp ./src/main.js dist/deploy/
cp ./src/utils.js dist/deploy/
cp ./src/index.html dist/deploy/
cp ./src/login.html dist/deploy/
cp ./src/app.html dist/deploy/
cp -rf ./static dist/deploy/ # 拷贝static 资源目录
tar -cvzf deploy-v1.01.tar.gz dist/deploy # 打包成ddeploy-v1.01.tar.gz 发布版本
5.移动后台端简介：
E聊SDK提供了一个基础的后端社区版源码，通过编译/修改该后端源码，可以实现更深度的业务定制，比如文件上传/下载、用户在线/离线监听、API权限功能、集群功能等。后端项目使用了springboot+mybatis 进行开发，使用maven 进行项目管理。以下介绍如何从源码编译后端项目。
5.操作步骤:
5.1 下载broker Release v1.01 源码
git clone https://gitee.com/dzqmeiji/echatim-server-broker-community.git
cd echatim-server-broker-community/
git checkout -b v1.01 v1.01
mvn clean install -DskipTests=true # 编译后端中间件
5.2 下载server Release v1.02 源码
git clone https://gitee.com/dzqmeiji/echatim-server-community.git
cd echatim-server-community/
git checkout -b v1.02 v1.02
mvn clean install -DskipTests=true # 编译后端项目
5.4 导入数据库结构与初始数据
安装mysql5.7数据服务, 在mysql创建echatim 数据库, 导入sqls/echatim-2020-04-30.sql 文件到echatim 到数据库。创建mysql root 用户, 密码为空.
5.5 启动后端项目
cd server-community-deploy/target/
java -jar server-community-deploy-1.0.jar
启动成功后见到:
swagger test started. http://localhost:8082/swagger-ui.html
socket.io started. http://localhost:9092
API调试: http://localhost:8082/swagger-ui.html
socketIO地址: http://localhost:9092
5.6 编辑Web客户端配置 源码地址
我们使用E聊本地服务器做为聊天后台，配置都使用本地服务器配置(社区版没有文件服务的功能)
// src/main.js 文件内容
719 sdkConfig.host = 'localhost'; //使用本地服务器
720 sdkConfig.httpPort = 8082; //使用本地默认配置
721 sdkConfig.socketPort = 9092; //使用本地默认配置
722 sdkConfig.key = 'TSDKTEST00001'; # 查看数据库sdk_app表
723 sdkConfig.secret = ''; // 这是保留配置, 不需要更改
使用yarn start 即可使用本地后端项目实现聊天功能.
