鸿蒙社交通讯应用模板:基于 ArkTS/ArkUI 的模块化工程实践
一个面向 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 或云端开发工作区
- 权限:网络、位置、相机、麦克风、振动
值得关注的几点
- 模块化做得规范——entry 不直接写页面,只装配路由和页签,业务全在 feature 包里。
- mock 与真实分离干净——一个
userSig空判断切两条路线,不混淆。 - 边界说明诚实——README 明确标注了哪些功能在 mock 下不可用、哪些需要额外配置,不藏着掖着。
链接
- 源码仓库:HarmonyOS-APPTMPL-Community
- 案例详情:README.md
- 点赞
- 收藏
- 关注作者
评论(0)