tencent cloud

即时通信 IM

动态与公告
产品动态
公告
产品简介
产品概述
基本概念
应用场景
功能介绍
账号系统
用户资料与关系链
消息管理
群组相关
公众号系统
音视频通话 Call
使用限制
购买指南
计费概述
价格说明
购买指引
续费指引
停服说明
退费说明
开发指引
Demo 专区
开通服务
体验 Demo
快速跑通
下载中心
SDK & Demo 源码
更新日志
聊天互动(含 UI)
TUIKit 组件介绍
快速开始
全功能接入
单功能接入
AI 集成
构建基础界面
更多特性
定义外观
国际化界面语言
推送服务(Push)
服务概述
名词解释
开通服务
快速跑通
厂商通道
数据统计
排查工具
客户端 API
服务端 API
推送回调
高级功能
更新日志
错误码
常见问题
智能客服
功能概述
快速入门
集成指引
管理员操作手册
客服操作手册
更多实践
直播间搭建
AI 聊天机器人方案
超大娱乐协作社群
Discord 实现指南
游戏内集成 Chat 指南
类 WhatsApp Channel 搭建方案
发送红包
Chat 应对防火墙限制相关
无 UI 集成
快速开始
集成 SDK
初始化
登录登出
消息相关
会话相关
群组相关
社群话题
用户管理
离线推送
云端搜索
本地搜索
公众号
客户端 API
JavaScript
Android
iOS & macOS
Swift
Flutter
Electron
Unity
React Native
C 接口
C++
服务端 API
生成 UserSig
REST API
第三方回调
控制台指南
新版控制台介绍
创建并升级应用
基本配置
功能配置
账号管理
群组管理
公众号管理
回调配置
用量统计
资源包查看指南
实时监控
开发辅助工具
访问管理
高级功能
常见问题
uni-app 常见问题
购买相关问题
SDK 相关问题
账号鉴权相关问题
用户资料与关系链相关问题
消息相关问题
群组相关问题
直播群相关问题
昵称头像相关问题
协议与认证
服务等级协议
安全合规认证
IM 政策
隐私政策
数据隐私和安全协议
平滑迁移方案
平滑迁移完整版
平滑迁移简化版
错误码
联系我们

HarmonyOS

PDF
聚焦模式
字号
最后更新时间: 2026-02-11 17:06:37

鸿蒙控制台配置

步骤1:开启推送服务

1. 登录 AppGallery Connect,在首页选择开发与服务,选择对应的项目,单击立即开通以开启推送服务。


2. 项目设置中,API 管理 tab 页面搜索 “Push”,打开推送服务。


步骤2:证书与签名申请

1. 证书申请:调试阶段必须申请调试证书,发布阶段必须申请发布证书。
登录 AppGallery Connect,选择证书、APP ID和Profile

在左侧导航栏选择证书、APP ID和Profile > 证书,在证书页面,单击新增证书

在弹出的“新增证书”窗口填写要申请的证书信息,单击提交

说明:
证书请求文件(CSR) 需要在DevEco Studio 上申请,具体操作请参见 生成证书请求文件
证书申请成功后,证书管理页面展示证书名称等信息。单击下载,将生成的证书保存至本地,供后续调试签名使用。
2. 注册调试设备(仅调试阶段需要)
登录 AppGallery Connect,选择证书、APP ID和Profile

在左侧导航栏选择证书、APP ID和Profile > 设备,进入设备页面。

如需添加单个设备,单击右上角的添加设备,在弹出窗口填写设备信息,完成后单击提交

说明:
关于各类型设备如何获取 UDID,请参见 UDID 获取方法
3. 申请 Profile 文件:调试阶段必须申请调试 Profile 文件,发布阶段必须申请发布 Profile 文件。
登录AppGallery Connect,选择证书、APP ID和Profile

在左侧导航栏选择 Profile,然后单击添加。

添加Profile 页面,填写应用名称、Profile名称等必填信息,填写完毕后单击添加

4. 手动签名。
在 DevEco Studio 中配置密钥(.p12)文件、申请的调试证书(.cer)文件和调试Profile(.p7b)文件。在 File > Project Structure > Project > Signing Configs 窗口中,取消勾选 “Automatically generate signature”(如果是 HarmonyOS 应用,请勾选“Support HarmonyOS”),然后配置工程的签名信息。


步骤3:创建 IM 控制台证书凭证

1. 登录 API Console,在页面左侧的导航栏中,单击我的 API,确保在项目名下已经推送服务,若无请单击右侧申请新HMS API服务。

2. 单击左侧导航栏中 API 服务 > 凭证,在项目下单击服务账号密钥下的创建凭证。

3. 填写必填项,并单击创建公私钥。创建并下载 JSON,下载后的文件就是您的 Service Account 凭据文件。

4. 将下载好的文件保存,待下一步 IM 控制台配置使用。

步骤4:申请场景化权益

Push Kit 支持多种场景化消息类型,其中部分场景化消息类型需要您申请特殊权益才能正常发送,像 IM 消息类型场景。
登录 AppGallery Connect,选择开发与服务,单击推送服务,在配置页,单击申请自分类权益。按照提示申请并激活。详情介绍请参考 推送场景化消息权益


Chat 控制台配置

1. 登录 Chat 控制台 ,前往 Chat > Push > Access Settings 页面,点击 Add Certificate 创建证书。

2. 选择上面 步骤3 生成的证书凭证,上传至新添加的鸿蒙证书。

3. 点击后续动作
打开应用:点击通知栏消息会默认拉起应用首页
打开应用内指定界面:收到推送消息后点击通知栏,组件会回调该点击事件和透传离线消息。
4. 完成添加证书后,IM 控制台会为您分配一个 证书 ID,接入使用。



帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈