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
配置开发环境
在创建项目或编译项目过程中如果遇到环境问题，可以运行
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 工程中默认不包含大表情元素切图。在正式上线商用前，请您替换为自己设计或拥有版权的其他表情包。请注意，下图所示的默认小黄脸表情包版权属于腾讯云，您可以通过升级至 IM 企业版套餐 免费使用该表情包。
1. 打开 Demo 项目， ./debug 目录下的 GenerateTestUserSig.js 文件。
2. 在
GenerateTestUserSig.js 文件中设置 SDKAPPID 和 SECRETKEY ，其值可以在 即时通信 IM 控制台 中获取。 点击目标应用卡片，进入应用的基础配置页面，例如：
3. 在 图中所示 区域，点击 复制，替换
GenerateTestUserSig.js 文件原有的 SDKAPPID 和 SECRETKEY。注意：
本文提到的生成 UserSig 的方案是在客户端代码中配置 SECRETKEY，该方法中 SECRETKEY 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量，因此该方法仅适合本地跑通 Demo 和功能调试。
正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端，并提供面向 App 的接口，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。
4. 进入应用的账号管理页面，创建账号并获取 userID，用于当作后续发送消息的测试用户。
步骤3：启动项目
编译运行项目您需要使用真机或模拟器，推荐使用真机运行。您可以参见 React Native 官网 running-on-device 连接真机进行调试。
1. 手机开启开发者模式，打开 USB 调试开关。
2. 用 USB 连接手机，推荐选择 传输文件 选项，不要选择 仅充电 选项。
3. 确认手机连接成功后，执行
npm run android 编译运行项目。npm run android
1. 用 USB 连接手机，用 Xcode 打开工程的 ios 目录。
2. 按照 React Native 官网 running-on-device 配置签名信息。
3. 进入 ios 目录下安装依赖。
cd iospod install
4. 回退到根目录，执行 npm run ios 编译运行项目。
cd ../npm run ios
步骤4：发送您的第一条消息
1. 项目启动之后单击左上角发起会话。
2. 进入发起会话窗口。在搜索栏输入 步骤2 中创建的 userID（test_2），选中后打开会话。
3. 在输入框中输入消息并点击发送。
更多高级特性（强烈推荐）
消息推送
说明：
小米 11 Pro  | iPhone 13  | 三星 Galaxy A23 海外版（Google FCM 推送）  |
常见问题
1. 运行 npm run android 提示如图所示错误时，请在项目更目录下重新设置环境变量。
export ANDROID_HOME=$HOME/Library/Android/sdkexport PATH=$PATH:$ANDROID_HOME/emulatorexport PATH=$PATH:$ANDROID_HOME/platform-tools
2. 在 Xcode 中执行 Build 命令如果提示 node 环境变量问题，请进行如下操作：
cd iosecho export NODE_BINARY=$(command -v node) > .xcode.env
参考文档
UIKit 相关：
实现更多功能，请参考 ChatEngine API 文档：
