XuqmGroup-RNSDK/docs/模块待开发说明.md
XuqmGroup 4c3019edab docs: 添加 CLAUDE.md + 各 package README + 架构总览 + 模块待开发说明
Agent 8 文档生成:
- CLAUDE.md 项目上下文
- 各 package README (common/update/push/im/xwebview/license/log)
- docs/架构总览.md
- docs/模块待开发说明.md
2026-06-16 12:14:52 +08:00

2.4 KiB

模块待开发说明

以下模块当前代码冻结,仅补充文档。后续开发需单独评估。


rn-push厂商推送

当前状态

  • FCM/APNS 基础注册已实现
  • HMS/VIVO/OPPO 厂商推送集成框架已建
  • 自动厂商检测(通过原生模块 NativePush
  • Token 注册/解绑 API 完整
  • 离线推送开关、免打扰时间段 API 已实现

后续待做

  • 厂商推送 token 注册完整流程(华为 HMS 需要 AppGallery Connect 配置)
  • 设备绑定/解绑统一 API当前分散在各厂商 SDK
  • 角标管理badge count 同步)
  • 厂商推送通道选择(高优先级 vs 普通通知)
  • 推送数据分析(到达率、点击率统计)

技术要点

  • 原生模块 XuqmPushModule 需要在宿主 App 中链接
  • 各厂商 SDK 初始化需要对应的 App ID / App Secret
  • setUserInfo(info) 触发自动注册,setUserInfo(null) 触发自动解绑

rn-im即时通讯

当前状态

  • 腾讯云 IM SDK 封装WebSocket/STOMP 传输)
  • WatermelonDB 本地消息持久化
  • 基础会话/消息 API 完整15 种消息类型)
  • 群组管理 API 完整
  • 关系链(好友/黑名单API 完整
  • 离线消息同步、消息搜索(本地)

后续待做

  • 消息已读回执(单聊已读状态同步)
  • 群组消息已读回执统计
  • 离线消息补全(当前为 best-effort 同步)
  • 消息撤回时间窗口控制(服务端策略)
  • 语音消息录制组件(当前仅发送本地音频文件)
  • 图片/视频消息缩略图生成
  • 消息转发、合并转发 UI
  • @所有人(@all支持

技术要点

  • 需要 @nozbe/watermelondb 依赖
  • DB 名称由 appKey + userId 派生,多账号隔离
  • 断线重连由 ImClient 内部处理(指数退避)
  • setUserInfo 自动触发 IM 登录(若 imEnabled 为 true

rn-license证书授权

当前状态

  • 证书授权基础流程已实现
  • 设备 License 验证(checkLicense
  • License 状态查询(getStatus
  • 本地缓存AsyncStorage

后续待做

  • 证书到期提醒(服务端推送 + 本地定时检查)
  • 证书自动刷新机制
  • 多设备 License 管理
  • 离线 License 验证(降级策略)
  • License 使用量统计

技术要点

  • 需要 react-native-quick-crypto 依赖
  • 内部自动等待 XuqmSDK 初始化完成
  • License 服务地址从平台配置获取(licenseUrl