Flutter IMLib 导入
本页说明 Flutter 端 IMLib 的依赖、制品与集成要求。包名:impaas_imlib(IMLib)、impaas_imkit(IMKit);IMKit 通过 IMKit.start 或 Widget 组合挂载。
安装 / 依赖
pubspec(path 依赖)
# impaas_imlib 尚未发布到 pub.dev:用 pubspec.yaml 的 path 依赖
# dependencies:
# impaas_imlib:
# path: /path/to/repo/sdk/flutter/imlib
# impaas_imkit: # 可选:IMKit
# path: /path/to/repo/sdk/flutter/imkit
flutter pub get # 首次/改 path 后执行;成功输出 Got dependencies!发行包不可用时如何集成
发行包未上架 pub.dev 时,用本地路径依赖:在 pubspec.yaml 的 dependencies 写 impaas_imlib: { path: <impaas_imlib 目录> },再执行 dart pub get(或 flutter pub get)。
IMKit 同理追加 impaas_imkit 的路径依赖;两者都是纯 Dart 包,无原生插件需要链接。
环境要求
| 项 | 要求 |
|---|---|
| SDK | Dart 3.x / Flutter 3.19+ |
| 依赖约束 | IMKit 只依赖 impaas_imlib 公开 API,不直连 http/websocket |
| 平台 | Android / iOS / macOS / Windows / Linux / Web(纯 Dart 实现) |
| 本地存储 | 优先使用 SQLite 实现;不支持时由 SDK 内部降级 |
包内容
| 制品 | 路径 / 名称 | 说明 |
|---|---|---|
| IMLib 包 / 模块 | impaas_imlib / impaas_imkit | 核心通信库(连接、消息、会话、群组、好友、聊天室、上传) |
| IMLib 源码 / 制品 | imlib | 随发行包提供的源码 / 制品(内联调可源码集成) |
| IMKit 制品 | imkit | 可选 UI 组件层,只依赖 IMLib 公开接口 |
版本与兼容
- 契约版本:IDL v1.0.0(frozen,冻结修订 35)。
- v1.x 采用 additive-only:仅新增可选字段、枚举值、接口与错误码,不破坏既有语义。
- 升级时先对照「更新日志」确认新增面,再回归连接、消息、会话与群组主链路。
- 当前平台绑定状态:
ga。