MobPush HarmonyOS NEXT 集成指南 原创

开发工具：DevEco Studio

集成方式：在线集成

HarmonyOS API支持：>= 12

集成前准备

注册账号

使用MobSDK之前，需要先在MobTech官网注册开发者账号，并获取MobTech提供的AppKey和AppSecret，详情可以​​点击查看注册流程​​

MobPush后台配置

注册MobTech账号后，需要在MobTech后台进行相关信息的配置，详情可以​​点击查看具体配置信息​​

MobPush流程图

back0

集成配置

添加依赖

在Terminal窗口中，执行如下命令进行安装

ohpm install @mobsdk/mobcore
ohpm install @mobsdk/mobpush
ohpm install @yyz116/jsbn

权限配置

MobSDK需要 ​​INTERNET​​权限才可正常使用，请在工程中entry模块的 ​​module.json5​​文件中，新增 ​​requestPermissions​​，如下所示：

"module": {
  "name": "xxx",
  "type": "entry",
  "description": "xxx",
  "mainElement": "xxx",
  "deviceTypes": [],
  "pages": "xxx",
  "abilities": [],
  // 配置如下
  "requestPermissions":[
    {
      "name": "ohos.permission.INTERNET"
    }
  ]
}

配置华为Client ID

如您需要使用华为推送，则需要配置client_id才可正常使用授权功能。

2. 登录​​AppGallery Connect​​平台，在“我的项目”中选择目标应用，获取“项目设置 > 常规 > 应用”的Client ID。

0000000000011111111.20240401170919.44699454592748666087700711367895(1).png

3. 在工程中entry模块的​​module.json5​​文件中，新增​​metadata​​，配置name为client_id，value为上一步获取的Client ID的值，如下所示：

"module": {
  "name": "xxx",
  "type": "entry",
  "description": "xxx",
  "mainElement": "xxx",
  "deviceTypes": [],
  "pages": "xxx",
  "abilities": [],
  "metadata": [ // 配置信息如下
    {
      "name": "client_id",
      "value": "xxx"
    }
  ]
}

如果应用需要使用用户的手机号或其他更为精细化的配置，可参考​​华为官方文档​​进行配置。

方法调用

使用MobSDK前，需调用以下代码初始化 ​​MobSDK​​，该方法务必在使用SDK功能之前调用

MobSDK.init(context, "您的AppKey", "您的AppSecret")
mobPush.init(context, "您的AppKey", "您的AppSecret")

初始化完毕，且当用户主动同意您应用隐私协议后，需调用以下代码回传隐私协议授权状态

            MobSDK.submit    PolicyGrantResult(    true)

至此，PushSDK已经集成完毕并可接收到推送，可以参考其他文档继续使用PushSDK的其他功能。