SDK 总览

imcore 提供 4 个官方类型化客户端 SDK,覆盖同一套 WebSocket 协议,让你无需手写底层协议即可接入。

平台安装文档
JavaScript / TypeScript@imcore/sdknpm install @imcore/sdkJS/TS
Dart / Flutterimcore_sdkpubspec 依赖(path/git)Dart
Swift / iOSImcoreSDKSwift Package ManagerSwift
Kotlin / Androidimcore-sdkimplementation(project(":imcore-sdk"))Kotlin

如何选型

  • Web / React Native / Node:用 JS/TS SDK(浏览器用原生 WebSocket,Node/RN 传入 ws)。
  • Flutter / Dart:用 Dart SDK(iOS、Android、桌面、Web 通用)。
  • 原生 iOS / macOS:用 Swift SDK(基于 URLSessionWebSocketTask,零依赖)。
  • Android / JVM:用 Kotlin SDK(协程 + Flow,默认 OkHttp)。

四端 API 形态一致:connect() 登录确认门控、im.dm/group/room 类型化收发与历史、以及面向未封装命令的 request()/send() 逃生通道。

成熟度

当前为 v1:传输内核 + seq 关联请求/响应 + 类型化的 DM/群/聊天室收发与历史(类型化 SDK 另含社区能力)。集成测试经环境变量开关启用,尚未对生产服务端做端到端验证——接入前请先对你自己的部署验证。不含本地缓存/离线对账、媒体上传辅助、E2EE、离线推送注册等(见各平台页”能力范围”)。

未被 SDK 覆盖的平台,或需要直接操作协议时,参见客户端接入指南(原始 WebSocket 协议)。