更新记录

1.0.0（2025-01-01）

• 集成主流厂商(华为、小米、荣耀、vivo、oppo)离线推送SDK

平台兼容性

uni-app

uni-app x

爱以诚厂商推送(iecheng-push)

简介

爱以诚厂商推送(iecheng-push)，集成主流厂商(华为、小米、荣耀、vivo、oppo)离线推送SDK。

插件主要用于获取服务端发送下行消息参数deviceToken：

• 华为推送服务-发送下行消息 中参数 Token;
• 小米推送服务-服务端推送消息 中参数 registration_id;
• 荣耀推送服务-发送下行消息 中参数 token;
• vivo推送服务-服务端API接口 中参数 regId、regIds;
• oppo推送服务-单点推送 中参数 target_value (target_type = 2 ,推送的目标类型registration_id)

快速跑通

第一步 将插件[爱以诚厂商推送(iecheng-push)]()导入 HbuilderX 中的工程。

第二步 在 App.vue 中引入插件 [爱以诚厂商推送(iecheng-push)]

import * as Push from "@/uni_modules/iecheng-push";
Push.getToken((token) => {
    console.log(token)
}, (err) => {
    console.log(err);
});

第三步 自定义基座打包进行真机测试

厂商推送配置

• 请注意！HBuilderX 4.36 发布了不向下兼容的更新，如果您使用的是 HBuilderX 4.36 或者更高版本，且需要 vivo/荣耀 的厂商推送，参考文档正确配置 manifestPlaceholders.json 和 mcn-services.json。

• 请在 nativeResources 目录下进行推送配置。若项目根目录尚未创建该文件夹，请新建一个名为 nativeResources 的文件夹。

• 厂商推送配置完成后，需要打包自定义基座。

【Android】

1. 新建 nativeResources/android/ 目录。

2. 华为：

   配置 agconnect-services.json 到 nativeResources/android 目录下。 获取文件途径：

   • 登录AppGallery Connect网站，点击“我的项目”。
   • 在项目列表中找到您的项目，在项目中点击需要集成HMS Core SDK的应用。
   • 在“项目设置 > 常规”页面的“应用”区域，点击“agconnect-services.json”下载配置文件。

   

   

3. 荣耀：

   3.1. 配置 mcn-services.json 文件到 nativeResources/android 目录下。获取文件途径：

   • 登录荣耀开发者服务平台网站，点击应用管理。
   • 在应用列表中找到您需要集成 SDK 的应用，点击应用详情。
   • 在应用基础信息查看页面的SDK 配置区域，点击 mcs-services.json 下载配置文件。

   3.2. 配置 appID 到 nativeResources/android/manifestPlaceholders.json 中的 "HONOR_APPID"，如下：

   {
     "HONOR_APPID": ""
   }

4. vivo：

   配置 appID 和 appKey 到 nativeResources/android/manifestPlaceholders.json 中的 VIVO_APPKEY 和 VIVO_APPID，如下：

   {
     "VIVO_APPID": "",
     "VIVO_APPKEY": "",
   }

5. oppo:

   配置 AppKey 和 AppSecret 到 nativeResources/android/manifestPlaceholders.json 中的 OPPO_APPKEY 和 OPPO_APPSECRET，如下：

   {
     "OPPO_APPKEY": "",
     "OPPO_APPSECRET": ""
   }

   如何开通推送服务? 点击这里

   如何查看AppKey 和 AppSecret? 点击这里

6. 小米:

   配置 AppId 和 AppKey 到 nativeResources/android/manifestPlaceholders.json 中的 XIAOMI_APPID 和 XIAOMI_APPKEY，如下：

   {
     "XIAOMI_APPID": "",
     "XIAOMI_APPKEY": ""
   }

接口

Push.getToken(success : (token : any) => void, error : (err : String) => void) : void,