跑通 IM Demo 源码
更新时间: 2024/10/22 10:26:14
网易云信在 Github 上提供开源的即时通讯示例(IM Demo)源码。您可参考 Demo 源码,在您的鸿蒙项目中快速构建即时通讯应用。本文介绍如何快速跑通适配鸿蒙项目的 IM Demo 源码。
准备工作
在开始运行示例项目之前,请确保您已完成以下操作:
-
注册 IM 账号,获取账号 ID(
account_id
)和凭证(Token)。 -
准备如下开发环境:
环境 版本要求 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 | 是 |
第二步:导入项目
-
将示例项目导入 DevEco Studio 开发环境。
-
在 DevEco Studio 里找到工程目录
imkit_sample/src/main/ets/constants/AppConfig.ets
文件,修改文件配置:-
userName:填入 IM 账号 ID。
-
userToken:填入 IM 账号 Token。
TypeScript
export class AppConfig { // appKey 和 userName 在网易云信控制台获取 // appKey 网易云信应用 appkey public static appKey: string = '' // userName IM 应用账号 ID public static userName: string = '' // userName IM 应用账号 Token public static userToken: string = '' }
-
签名配置,真机设备运行需要配置华为签名,请参考《华为官方文档》应用开发准备。如果是采用鸿蒙虚拟机则不需要配置签名。
第三步:运行 Demo
将源码运行在您的鸿蒙设备上,即可进入登录页面,单击登录按钮则进入如下界面,开始体验 IM Demo。
此文档是否对你有帮助?