SuperAPI AI 工具集

cometchat-native-bare-patterns

前端与建站

查看项目

更新于 10-16 05:03

技能介绍

用途:教 Claude 把 CometChat 集成进裸 React Native CLI 项目,覆盖同类依赖安装与原生模块自动链接、iOS 的 pod install 节奏、ios/<AppName>/Info.plist 权限编辑、android/app/src/main/AndroidManifest.xml 权限编辑、Android 的 async-storage Maven 仓库问题、Apple 隐私清单(PrivacyInfo.xcprivacy)及 index.js 与 App.tsx 的 Provider 链接线。阅读顺序为先 cometchat-native-core,再 cometchat-native-components,再 cometchat-native-placement。

适用判据:项目根目录含 ios/ 与 android/,package.json 的 main 为 index.js,依赖中无 expo;用户提到 React Native CLI、bare RN 等。若依赖含 expo 且有 app.json/app.config.js,应改用 cometchat-native-expo-patterns。

前置条件:iOS 需 Xcode 15+,Android 需 SDK 34+ 的 Android Studio,安装 CocoaPods,React Native >=0.77(旧版可能可用但官方不支持)。

主要步骤:一、安装核心与 UI Kit 依赖(@cometchat/chat-sdk-react-native@^4、@cometchat/chat-uikit-react-native@^5)及一组原生链接依赖,dayjs、punycode 必需;裸 RN 用自动链接,无需 react-native link。RN 0.85+ 下 react-native-document-picker v9.x 会导致 Android 构建失败,需改用 @react-native-documents/document-picker。语音/视频通话为可选额外依赖。二、iOS:每次安装原生模块后执行 cd ios && pod install && cd ..;编辑 Info.plist 权限文案;创建 PrivacyInfo.xcprivacy 并加入 Xcode 目标。三、Android:在 AndroidManifest 中添加权限(按需合并);仅在使用 async-storage v3+ 时向 android/build.gradle 添加本地 Maven 仓库。四、index.js 中 react-native-gesture-handler 必须是首个 import;App.tsx 按示例组织 Provider 链。五、环境变量可选 react-native-config 或 react-native-dotenv,后者修改 .env 后需重置 Metro 缓存。

限制:资料未提供收费、价格、效果或平台信息;部分步骤为条件性,例如 async-storage Maven 修复仅适用于 v3+,默认样本使用 v2.2.0 不需要。已知问题如 chat-sdk 4.0.22 在裸 RN 运行时崩溃,需用 npm overrides 去重或固定 4.0.21。