Demo 运行指南与下载
Flutter SDK 的示例 App 是一个完整 IM 功能的应用:注册登录、会话列表(未读、置顶、免打扰、草稿、 正在输入)、聊天页全部消息类型(文本、图片、视频、语音、文件、位置、撤回、回应、转发)、 通讯录与好友全流程、群聊管理、个人资料、音视频通话、RTC 频道。它也是 SDK 端到端测试的载体, 功能完整度与 UniApp H5 Demo、Tauri 示例 App 对齐。
下载
示例 App 源码包(依赖已指向 pub.dev 已发布的版本,无需克隆 SDK 仓库):
deeprespond-im-flutter-demo-1.0.0-alpha.2.zip(约 330 KB), 校验值见同目录的 DEMO_PACKAGE_SHA256SUMS。下载后:
unzip deeprespond-im-flutter-demo-1.0.0-alpha.2.zip
cd deeprespond-im-flutter-demo-1.0.0-alpha.2
sha256sum -c SHA256SUMS也可以直接使用源码仓库中的 sdk/flutter/example,二者内容一致。
运行
前置条件:
- Flutter ≥ 3.38.1;构建 Android 需 Android SDK 与 JDK 17,iOS / macOS 需装有 Xcode 的 Mac, Linux 需 clang / ninja / GTK 3 开发包;
- 一个已部署并可访问的深应智能 IM 服务端,以及控制台中创建的应用(AppKey);
- 离线推送与音视频通话的平台配置(Firebase、厂商通道、Info.plist 等)见 快速集成与离线推送。
flutter pub get
flutter run -d <设备> \
--dart-define=IM_APP_KEY='org_name#app_name' \
--dart-define=IM_API_URL='https://im.example.com'支持的平台:Android、iOS、macOS、Windows、Linux。服务端信息也可以启动后在登录页填写。
测试夹具模式
flutter run -d linux --dart-define=IM_DEMO_FIXTURES=true夹具模式面向自动化测试与功能演示:独立的沙箱数据目录(不与正式运行互相污染)、 我页的"模拟断网"开关(断开长连接并拒绝新连接,恢复后自动重连)、 输入面板的测试图片 / 测试文件 / 长文本入口。
端到端测试
示例 App 是 SDK 端到端测试的载体:sdk/flutter/example/integration_test/ 中的 E2E 在 Linux 桌面(Xvfb)驱动真实 App 跑完 27 个场景(成功路径与关键失败路径, 覆盖登录失败、断网发送与恢复、发送给不存在用户等),逐步输出结构化结果并截图, 报告见 SDK 仓库的 Agent测试/Flutter_SDK_Demo完善/。构建自己的应用时可参考其中的 元素标记(Key)与步骤录制(reporter.dart)的做法。
