鸿蒙社交通讯应用模板:基于 ArkTS/ArkUI 的模块化工程实践

举报
ioiy 发表于 2026/11/12 20:46:08 2026/11/12
【摘要】 一个面向 HarmonyOS 6.1.1 的社交通讯应用模板,覆盖消息、通讯录、个人中心三大模块,开箱即用本地 mock 登录,接入腾讯云 IM 即可切换真实业务——适合已有 ArkTS/ArkUI 基础、想快速定制社交通讯业务的开发者。模板做了什么启动流程很清晰:隐私协议 → 登录页 → 三页签主界面。消息模块:顶部搜索、添加好友、创建群聊入口、会话列表容器;接入真实 IM 后展示会话与聊...

一个面向 HarmonyOS 6.1.1 的社交通讯应用模板,覆盖消息、通讯录、个人中心三大模块,开箱即用本地 mock 登录,接入腾讯云 IM 即可切换真实业务——适合已有 ArkTS/ArkUI 基础、想快速定制社交通讯业务的开发者。

模板做了什么

启动流程很清晰:隐私协议 → 登录页 → 三页签主界面。

  • 消息模块:顶部搜索、添加好友、创建群聊入口、会话列表容器;接入真实 IM 后展示会话与聊天内容。
  • 聊天能力:文本、表情、图片、视频、语音、位置消息组件齐备。
  • 通讯录:群分类 + 好友分组容器。
  • 个人中心:信息编辑、消息提醒、黑名单、收藏、二维码、意见反馈、设置。

工程结构一览

模板采用多模块设计,共 17 个模块(16 HAR + 1 HAP):


层级 模块 职责
入口 products/entry 启动页、主页签、动态路由、权限声明
特性 message / address_book / person 三个业务页签
聊天 chat_window / chat_input / chat_location 等 聊天展示、输入、位置、搜索与收藏
数据 instant_messaging 封装腾讯云 IM SDK
公共 common / oh_router 全局状态、路由、弹窗

路由没有用静态 router_map.json,而是通过页面 builder 动态注册——各 feature 包导出自己的 Builder,entry 只依赖三个 feature 包,路由名称集中在 RouterMap 统一管理。这个设计让模块边界清晰,二开时不用动入口。

Mock 登录:零配置即可跑

这是模板最贴心的地方。Constants.ets 里的 MOCK_ACCOUNT_LIST 预置了 user_one 账号,LoginPage 检测到 userSig 为空时,跳过腾讯云 IM 登录链路,直接写入本地登录态进入主界面。

好处:clone 下来不用配任何云服务就能看到完整 UI。代价:消息和通讯录列表为空(因为没有真实数据),这是已知边界,不算 bug。

要切真实 IM,只需配置 SDKAppID + 有效 userSig,CMChatFactory.login() 就走真实链路。

二开建议:给空会话页加引导

模板给出了一个可选的二开任务:为未配置 IM 的空会话列表增加配置引导。即在 mock 登录、会话为空时,显示一个"去配置 IM"的引导卡片,而不是空白。改动集中在 MessageListPage,不影响真实 IM 接入后的会话展示。

运行条件

  • SDK:兼容 6.0.1(21),目标 6.1.1(24)
  • 设备:手机模拟器或真机
  • 环境:DevEco Studio 或云端开发工作区
  • 权限:网络、位置、相机、麦克风、振动

值得关注的几点

  1. 模块化做得规范——entry 不直接写页面,只装配路由和页签,业务全在 feature 包里。
  2. mock 与真实分离干净——一个 userSig 空判断切两条路线,不混淆。
  3. 边界说明诚实——README 明确标注了哪些功能在 mock 下不可用、哪些需要额外配置,不藏着掖着。

链接

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。