SDK 总览
imcore 提供 4 个官方类型化客户端 SDK,覆盖同一套 WebSocket 协议,让你无需手写底层协议即可接入。
| 平台 | 包 | 安装 | 文档 |
|---|---|---|---|
| JavaScript / TypeScript | @imcore/sdk | npm install @imcore/sdk | JS/TS |
| Dart / Flutter | imcore_sdk | pubspec 依赖(path/git) | Dart |
| Swift / iOS | ImcoreSDK | Swift Package Manager | Swift |
| Kotlin / Android | imcore-sdk | implementation(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 协议)。