Run Demo

chat-uikit-react-native 介绍

chat-uikit-react-native 是一款基于腾讯云 Chat SDK 的 React Native UI 组件库,提供了一些通用的 UI 组件,包含会话、聊天、群组等功能。基于这些精心设计的 UI 组件,您可以快速构建优雅的、可靠的、可扩展的 Chat 应用。基于 React Native 开发的 UIKit 界面风格更契合境外客户的使用习惯,而且支持国际化,如果您的业务有出海的需求,欢迎接入。具体可参见 开源代码
chat-uikit-react-native 界面效果如下图所示:




环境要求

React Native 0.75.0
Node.js version 18+
JDK 17
Xcode 版本 14.0 或更高版本
Android Studio

配置开发环境

如果您是首次开发 React Native 项目,请参见 React Native 官网步骤 set-up-your-environment 配置开发环境。
在创建项目或编译项目过程中如果遇到环境问题,可以运行 npx react-native doctor 进行环境诊断。

跑通 Demo

步骤1:下载源码

git clone https://github.com/TencentCloud/chat-demo-react-native
cd chat-demo-react-native/Demo
使用 yarn 安装 (推荐):
yarn install
或者使用 npm 安装:
npm i --legacy-peer-deps

步骤2:配置 Demo

说明:
为尊重表情设计版权,IM Demo/TUIKit 工程中不包含大表情元素切图,正式上线商用前请您替换为自己设计或拥有版权的其他表情包。下图所示默认的QQ表情版权归腾讯所有且不支持授权,请您谅解并知悉。



1. 打开 Demo 项目, ./debug 目录下的 GenerateTestUserSig.js 文件。
2. GenerateTestUserSig.js文件中设置 SDKAPPIDSECRETKEY ,其值可以在 Chat Console 中获取。 点击目标应用卡片,进入其配置页面。


3. 图中所示 区域,点击 复制,替换 GenerateTestUserSig.js 文件原有的 SDKAPPIDSECRETKEY
4. 进入应用的账号管理页面,创建账号并获取 userID,用于当作后续发送消息的测试用户。
单击进入您上面创建的 Application,会在左侧边栏看到 Chat 产品入口,单击进入。
进入 Chat 产品子页面后,点击 Users,进入用户管理页面。
单击 Create account,弹出创建账号信息填写框。如果只是普通成员,我们建议您选择General 类型。
为了您更好的体验消息收发等功能,创建userID(test_1, test_2)


步骤3:启动项目

编译运行项目您需要使用真机或模拟器,推荐使用真机运行。您可以参见 React Native 官网 running-on-device 连接真机进行调试。
Android
iOS
1. 手机开启开发者模式,打开 USB 调试开关。
2. 用 USB 连接手机,推荐选择 传输文件 选项,不要选择 仅充电 选项
3. 确认手机连接成功后,执行 npm run android 编译运行项目。
npm run android
1. 用 USB 连接手机,用 Xcode 打开工程的 ios 目录。
2. 按照 React Native 官网 running-on-device 配置签名信息。
3. 进入 ios 目录下安装依赖。
cd ios
pod install
4. 回退到根目录,执行 npm run ios 编译运行项目。
cd ../
npm run ios

步骤4:发送您的第一条消息

1. 项目启动之后单击左上角发起会话。
2. 进入发起会话窗口。在搜索栏输入 步骤2 中创建的 userID(test_2),选中后打开会话。
3. 在输入框中输入消息并点击发送。


交流与反馈

加入 Telegram 技术交流群组WhatsApp 交流群,享有专业工程师的支持,解决您的难题。

常见问题

1. 运行 npm run android 提示如图所示错误时,请在项目更目录下重新设置环境变量。

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
2. 在 Xcode 中执行 Build 命令如果提示 node 环境变量问题,请进行如下操作:

cd ios
echo export NODE_BINARY=$(command -v node) > .xcode.env

参考文档

UIKit 相关:

实现更多功能,请参考 ChatEngine API 文档: