SuperAPI AI 工具集

cometchat-react-native-core

编程与开发

查看项目

更新于 10-21 20:30

技能介绍

用途

本技能是 CometChat React Native UI Kit v5 的基础规则集,适用于所有 React Native 上的 CometChat 任务,也是其他 cometchat-react-native-* 技能假定的基础。典型使用场景包括:为 React Native 应用添加聊天、在 Expo 中集成 CometChat、构建 RN 聊天界面。

主要能力

  • 安装与依赖:每个平台一个包,禁止把 Web 版 @cometchat/chat-uikit-react 混入 RN 应用。安装命令为 npm install @cometchat/chat-uikit-react-native@5 @cometchat/chat-sdk-react-native@4,随后安装必需的原生 peer 依赖(clipboard、gesture-handler、svg、video、localize、safe-area-context、async-storage、dayjs;Expo 还需 punycode)。裸 RN 需执行 cd ios && pod install。
  • 初始化与登录:使用 initFromSettings(而非经典 init),它会持久化 integrationSource="ai-agent"。init() 必须先于 login() 解析,login() 必须先于渲染任何组件,否则出现空白屏而非报错。
  • Provider 链:由外到内为 GestureHandlerRootView(必须 flex: 1)→ SafeAreaProvider → CometChatI18nProvider → SafeAreaView → CometChatThemeProvider。
  • 组件与 API 映射:会话列表 CometChatConversations;消息面板 CometChatMessageHeader / CometChatMessageList / CometChatMessageComposer;紧凑输入 CometChatCompactMessageComposer;线程 CometChatThreadHeader;搜索 CometChatSearch;用户/群组/成员 CometChatUsers / CometChatGroups / CometChatGroupMembers;通话相关组件;主题与国际化 Provider;扩展链 ChatConfigurator + DataSourceDecorator。
  • 核心聊天界面(四项):会话列表、消息面板、线程回复、搜索,默认全部需要。
  • 回调命名:RN 使用 Press 而非 Click,如 onItemPress、onThreadRepliesPress、onSearchBarClicked。

使用方式

  1. 检测项目类型(Expo 或裸 RN),复用已有的 .cometchat/config.json 或环境变量。
  2. 若 package.json 中已存在非 v5 主版本的 UI Kit,先停止并协调版本。
  3. 凭据获取:优先推荐通过 npx @cometchat/skills-cli@3 auth login 从仪表盘获取,选择已有应用,provision use --app-id <id> --json 写入 .cometchat/config.json;或手动从仪表盘粘贴(仅开发用 Auth Key)。
  4. 写入环境变量:裸 RN 用 .env(经 react-native-config 读取),Expo 用 .env(经 Constants.expoConfig.extra 或 process.env 读取),并加入 gitignore,切勿回显 Auth Key。生产环境使用服务端签发的 auth token。
  5. 按顺序调用 initFromSettings 与 login,再渲染组件。
  6. 按 Provider 链包裹应用,使用 flex 布局(每个祖先 flex: 1,滚动列还需 minHeight: 0)。
  7. 按组件映射表放置组件,并接线对应回调。

适用场景

需要为 React Native 或 Expo 应用添加完整聊天界面(会话、消息、线程、搜索)的开发者,尤其是希望遵循官方 v5 版本约定、避免 React 与 RN 混用错误的场景。

限制

  • React Native 不是 React:包、API、原生视图均不同,React 代码片段无法编译。
  • 目录 rn-v5.json 之外的符号不存在,不得输出。v5 中缺失 CometChatErrorBoundary、CometChatDetails、CometChatAddMembers、CometChatBannedMembers、CometChatTransferOwnership 及所有 *WithMessages 组合组件。
  • RN >= 0.87 时,kit(至 5.5.0)在 iOS 发送路径仍调用 InteractionManager,导致 iOS 发送消息抛错,需参考 troubleshooting 技能修复。
  • CometChatGroupMembers 的 onError 在 5.5.0 前不接受参数。
  • 移动端包内无秘密(IPA/APK 可读),Auth Key 仅限开发。
  • 共享机器上 Metro 端口 8081 可能被其他项目占用,需按文档处理。
  • 应用内 tsc --noEmit 不干净并非应用缺陷,kit 直接发布原始 src/*.tsx 且无构建声明,应以 Metro 打包作为验证门槛。

验证

所有输出符号须出现在 catalogs/rn-v5.json 中;代码须通过 npm run verify:fences:rn-v5 编译;oracles 须与 kit 和文档一致(npm run verify:sync:rn-v5)。设备上验证聊天填满屏幕、键盘弹出时输入框可见、返回可用、手势响应。