【HarmonyOS】应用推送使用个推 SDK 如何实现？

2025-06-25
上海
本文字数：2027 字
阅读完需：约 7 分钟

##鸿蒙开发能力 ##HarmonyOS SDK 应用服务 ##鸿蒙金融类应用（金融理财 #

前言

个推和极光都是市面上很成熟的推送第三方 SDK 了。今天讲讲个推 SDK 在鸿蒙中如何集成使用。

存在即合理，三方 SDK 推送给我们带来了极大的好处，首先在服务器后台处理一套 API 就可搞定，差异化处理都由 SDK 厂商来做了。客户端层面，SDK 会更进一步进行封装，并且加强功能的能力。整个功能又节约了人力维护和开发成本。当然也有缺点，毕竟差异化都是厂商处理了，所以在平台进行 API 更新时，都需要等厂商先升级完毕才能进行下一步，有了前置依赖。

平台注册和配置事项

一般鸿蒙应用选择个推很大的前提是，既有的 IOS 和 Android 已经使用了个推，在迁移一致性上来说，也会选择个推来实现鸿蒙上的应用推送功能。

一般公司运营会负责个推平台账号。这里注册是为给给应用开发来做测试账号用。

个推平台整个注册过程很简单，傻瓜操作即可。

注册完成后登陆个推平台，进行测试应用的注册。一般平台都需要以你的应用作为服务对象，会生成对应该的 APPID 或者 APPKey，到时候使用他们的 SDK，初始化时就需要将你的应用唯一标识传给他们，联网之后他们的后台会进行校验。这也是一个注意项，在使用三方 SDK 时，若没有和自己家的后台服务器直接交互，很多情况下是需要连接外部网络，因为客户端的三方 SDK 会进行联网校验。所以很多公司是内网，测试机使用 SDK 功能就会有问题。

关于华为 AGC 平台推送服务的配置，参见这篇文章：【HarmonyOS】关于鸿蒙消息推送的心得体会（一）

关于个推平台和华为 AGC 平台进行绑定的操作：在个推开发者中心--应用管理页--找到对应的这个鸿蒙应用--进入“消息推送”页--配置管理--应用配置–鸿蒙：去填写鸿蒙应用的厂商信息，点击上传文件，选择您在创建服务器秘钥文件中下载的 JSON 文件上传：

如果不知道 JSON 文件如何获取，详细步骤参见文档：开通指南查看其中的创建服务帐号密钥文件的内容。

SDK 获取 Demo 运行

应用注册完之后，就可以进行推送 SDK 的下载了。这里会有客户端 SDK 和服务器 SDK。

下载完成之后，我们可以看到 SDK 是以 Demo 的形式提供。SDK 的 Har 肯定就在项目的 libs 里了。这里我们也发现了个彩蛋，MACOSX，这一看就是 Mac 电脑上传的包哈哈哈。

打开应用后我们可以看到，整个 demo 很简单。sdk 本体就是 libs 下的 GT-HM-1.0.2.0-beta.har。

**在入口 Ability 的创建函数中，进行了 SDK 的初始化操作。**这里的 APPID 就是我们在个推平台上注册应用，对应的 id。

import AbilityConstant from '@ohos.app.ability.AbilityConstant';import hilog from '@ohos.hilog';import UIAbility from '@ohos.app.ability.UIAbility';import Want from '@ohos.app.ability.Want';import window from '@ohos.window';import common from '@ohos.app.ability.common';
import PushManager from 'library';
export default class EntryAbility extends UIAbility {  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {    hilog.info(0x0000, 'EntryAbility', '%{public}s', 'Ability onCreate');    PushManager.initialize({      appId: 'APPID',      context: getContext(this) as common.UIAbilityContext,      onSuccess: cid => {        hilog.debug(0x0000, "EntryAbility", '%{public}s', "cid = " + cid);      },      onFailed: error => {        hilog.debug(0x0000, "EntryAbility", '%{public}s', "error = " + error);      }    })  }    onWindowStageCreate(windowStage: window.WindowStage): void {
    windowStage.loadContent('pages/Index', (err, data) => {      if (err.code) {        hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');        return;      }      hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');    });  }
}