1.说明:
教程属于官方E聊SDK-简介(5)
进入官网
进入管理台
SDK版本:v1.01
技术交流QQ群: 471688937
2.移动客户端简介:
E聊SDK提供了一个基本的移动客户端Demo源码,通过编译该客户端,可以接入E聊服务器,实现单聊/群聊等功能。移动客户端使用ReactNative 技术开发,适配了Android, ios, 移动网页等三个平台,实现使用一套代码适配三个平台,大大降低了代码开发量。WEB客户端源码包含了两部分,一部分是核心SDK(使用TypeScript 开发),一部分是演示Demo(使用TypeScript + ReactNative 0.61.5 开发)。以下介绍如何从源码编译移动客户端。
3.操作步骤:
3.1 下载Web Release v1.01 源码, 编译出核心SDK
E聊的Web客户端与移动客户端使用的是同一套核心SDK,而核心SDK放置在Web源码内,故要先下载Web源码编译出核心SDK(若是window平台, 请预先安装git bash相关unix工具)
git clone https://gitee.com/dzqmeiji/echatim-client-web.git
cd echatim-client-web/
git checkout -b v1.01 v1.01
yarn tslib # 编译出核心SDK到 dist/echatim-lastest.tar.gz, window平台请预先安装git bash相关unix工具
3.2 下载移动 Release v1.01 源码, 安装相关依赖
git clone https://gitee.com/dzqmeiji/echatim-client-rn.git
cd echatim-client-rn/
git checkout -b v1.01 v1.01
mkdir -p src/libs/sdk # 创建核心SDK源码目录
# 手动拷贝上一步编译出的echatim-lastest.tar.gz 到项目根目录下
yarn importlib # 解压echatim-lastest.tar.gz 的内容到src/libs/sdk目录下
yarn install
3.3 编辑客户端连接配置
// src/dev.ts 文件内容
export const DevConfig = {
HOST:'api.echat.work',
FILE_SERVER_URL:'http://api.echat.work:58082',
};
// src/AppInitializer.ts 文件内容
sdkConfig.httpPort = 58082; //使用线上默认配置
sdkConfig.socketPort = 59092; //使用线上默认配置
sdkConfig.key = '修改这一项为自己的AppKey;
sdkConfig.secret = ''; // 这是保留配置, 不需要更改
// .env 文件内容
SKIP_PREFLIGHT_CHECK=true
# config web
HOST=192.168.0.100 # 修改为本机IP地址
PORT=18088
3.4 启动移动Web客户端
yarn web
启动后访问: http://本机IP:18088 即可访问移动网页Demo项目。
3.5 启动Android客户端
yarn android
启动后可在Android模拟器看到登录界面
3.6 启动iOS客户端
yarn ios
启动后可在iOS模拟器查到登录界面
4.总结:
移动客户端提供了一个基础的演示Demo, 适配了Android,iOS, 移动浏览器三个平台, 您可以在此演示Demo的基础上实现定制开发,也可以不使用移动Demo, 根据自己项目的技术栈在sdk核心库的基础上作更深入的定制开发。