跑通 IM Demo 源码

更新时间: 2024/10/22 10:26:14

网易云信在 Github 上提供开源的即时通讯示例(IM Demo)源码。您可参考 Demo 源码,在您的鸿蒙项目中快速构建即时通讯应用。本文介绍如何快速跑通适配鸿蒙项目的 IM Demo 源码。

准备工作

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

  • 网易云信控制台 上,创建应用,获取应用密钥(App Key)。

  • 注册 IM 账号,获取账号 ID(account_id)和凭证(Token)。

  • 网易云信控制台 为应用开通 云端会话 开关。开启步骤请参考《控制台文档》配置应用

    开通云端会话.png
  • 准备如下开发环境:

    环境 版本要求
    DevEco Studio NEXT Beta1(Build Version: 5.0.3.810) 及以上
    OpenHarmony SDK API API Version 12 及以上版本

第一步:下载 Demo

前往 GitHub 下载 Demo 源码,示例项目结构如下:

目录 组件 说明 是否必须依赖
corekit 底层架构组件 底层框架
common 通用 UI 组件 公用 UI 库
chatkit 业务接口组件 业务逻辑层,依赖 NIM SDK 提供各个业务数据接口
chatkit_ui 聊天 UI 组件 聊天模块,包括单聊和群聊页面,以及消息发送、消息接受和消息 UI 等
contactkit_ui 通讯录 UI 组件 通讯录、黑名单、系统通知组件
conversationkit_ui 会话 UI 组件 会话列表组件
teamkit_ui 群管理 UI 组件 群管理组件,群聊设置、群管理等
imkit_sample 组件 Demo Demo 源码,组件初始化、登录和设置相关功能
libs SDK 依赖 NIM SDK har 包,可以替换更新 NIM SDK

第二步:导入项目

  1. 将示例项目导入 DevEco Studio 开发环境。

  2. 在 DevEco Studio 里找到工程目录 imkit_sample/src/main/ets/constants/AppConfig.ets 文件,修改文件配置:

    • appKey:替换成您在 网易云信控制台 获取的应用密钥 App Key

    • userName:填入 IM 账号 ID

    • userToken:填入 IM 账号 Token

      TypeScriptexport class AppConfig {
          // appKey 和 userName 在网易云信控制台获取
          // appKey 网易云信应用 appkey
          public static appKey: string = ''
          // userName IM 应用账号 ID
          public static userName: string = ''
          // userName IM 应用账号 Token
          public static userToken: string = ''
      }
      
  3. 签名配置,真机设备运行需要配置华为签名,请参考《华为官方文档》应用开发准备。如果是采用鸿蒙虚拟机则不需要配置签名。

第三步:运行 Demo

将源码运行在您的鸿蒙设备上,即可进入登录页面,单击登录按钮则进入如下界面,开始体验 IM Demo。

此文档是否对你有帮助?
有帮助
去反馈
  • 准备工作
  • 第一步:下载 Demo
  • 第二步:导入项目
  • 第三步:运行 Demo