跑通 Demo 源码

更新时间: 2024/10/24 18:22:49

网易云信在 Github 上提供开源的 IM Demo 源码 nim-uikit-flutter。您可参考 Demo 源码,在您的 Flutter 项目中快速构建即时通讯应用。本文介绍如何快速跑通 IM Demo 源码。

界面模块

IM Demo(Flutter)主要包含会话列表,会话和通讯录三大界面模块,支持的功能包括单聊消息收发、群聊消息收发、会话管理、群组管理等。

准备工作

在开始运行示例项目之前,请确保您已完成以下操作:

  1. 网易云信控制台创建应用,获取 App Key。
  2. 注册 IM 账号,获取账号 ID(accid)和 token。
  3. 准备如下开发环境和工具:
    • Flutter-dart 3.10.0 及以上版本。
    • 开发环境:
      Android
      • Android Studio Bumblebee
      • App 要求 Android 5.0 API 21 及以上版本设备
      • 1.6.10 以上版本的 kotlin-gradle-plugin
      iOS
      • Xcode 12.0 及以上版本
      • App 要求 iOS 12.0 以上版本设备
      • 项目已设置有效的开发者签名

运行源码

  1. 前往 GitHub 下载 IM Demo 源码

    示例项目结构如下:

    目录 说明
    im_demo 应用主入口,包含外部界面框架
    nim_chatkit_ui 聊天功能界面相关代码
    nim_contactkit_ui 通讯录功能界面相关代码
    nim_conversationkit_ui 会话功能界面相关代码
    nim_searchkit_ui 搜索功能界面相关代码
    nim_teamkit_ui 群组功能界面相关代码
  2. 将示例项目导入您的开发工具。安卓项目推荐使用 Android Studio。

  3. 在项目中,找到 im_demo/lib/src/config.dart 文件,将文件里如下代码中的 your app key 替换成您在前文准备工作阶段获取的 App Key。

    Dartclass IMDemoConfig {
      static const AppKey = 'your app key';
    }
    
  4. 在项目中找到 im_demo/lib/src/home/splash_page.dart 文件,将文件里找到 startLogin 方法设置成您在前文准备工作阶段获取的 IM 账号和 Token。

    Dartvoid startLogin() {
      //将您的 IM 账号(accid) 和 Token 设置在这里即可
      String account = "";
      String token = "";
      ......
    }
    
  5. 运行源码到您的设备上,即可进入 Demo 界面,开始体验 IM Demo。

此文档是否对你有帮助?
有帮助
去反馈
  • 界面模块
  • 准备工作
  • 运行源码