华为推送服务(Push)

2024年1月28日 128次阅读 来源: 初心一点

Huawei PUSH（华为推送服务）是华为为开发者提供的消息推送平台

1. 华为服务简介

  • 是什么华为推送服务？
    云端到终端的消息推送通道。PUSH通道拥有高到达率，推送速度每秒最高可达百万级，消息量每日百亿级，并且支持实时消息回执

  • 存在或提供该服务意义？
    可以将最新信息即时通知用户，构筑良好的用户关系，提升用户的感知度和活跃度

  • 开发者需要做什么？
    开发者通过在APP服务器端调用PUSH接口，向Huawei PUSH平台发送推送消息
    Huawei PUSH平台将消息发给安装了相应APP的终端设备

2. 华为服务功能

2.1 终端设备收到消息的形式有？

Huawei PUSH可发送两种类型的消息给终端：通知栏消息和透传消息

2.2 PUSH主要功能

  • 支持单发、群发机制，可以一次给一个或者多个用户发送PUSH消息
  • 当终端用户不在线时，支持消息缓存能力(消息缓存是指当消息到达华为PUSH平台后，如果设备不在线华为PUSH平台会将消息缓存起来，等到设备上线后华为PUSH平台会将缓存的消息再次推送给用户。如果用户很长时间不在线，这些缓存的消息默认保存24小时，最大保存15天，超期的消息会被PUSH平台丢弃)
  • 支持实时消息回执
  • 支持通知栏消息和透传消息两种方式。华为推荐用户尽量使用通知栏消息

2.3 通知栏或透传消息区别？

  • 终端用户点击对应的通知栏消息触发相应的动作，如打开应用、打开一个网页、打开应用内某界面
  • 透传消息由开发者的APP自主解析自定义内容，并触发相关动作，华为PUSH仅仅提供通道能力。利用此功能开发者可以实现好友邀请、IP呼叫等功能

2.4 华为推荐用户尽量使用通知栏消息的原因？

通知栏消息的优势如下

  • 降低PUSH业务的功耗
    传统的Push功能都需要应用的进程存在时才能显示通知栏消息，但是应用进程很难常驻在系统，一般系统出于功耗的考虑会停止后台长时间没有活动的进程，这种情况下当收到通知栏消息需要展示时就需要拉起应用进程，频繁的操作会增加耗电影响手机续航能力
  • 通知栏消息到达率通常比透传消息高（不受低功耗方案对广播拉起应用的限制）

2.5 消息送达率如何？

影响PUSH消息送达率的因素有

  • 终端设备是否在线
  • 用户手机上集成HMS SDK的应用是否被卸载
  • 移动网络是否稳定
  • 终端手机的安全控制策略
  • 不同终端厂商设备的支持度

2.6 不同终端平台对PUSH消息的限制?

原则上安装了HMS APK（华为移动服务）的Android终端设备即可支持华为PUSH业务

  • 华为Android终端设备（设备出厂自带HMS APK）
    Tips：华为手机管家可以拦截Android广播消息，Push消息因此也会被拦截

  • 非华为Android手机（小米、VIVO、OPPO、三星、酷派、中兴等）
    Tips：需要终端设备先安装HMS APK。 某些厂商手机可能会删除华为进程，导致消息不可达

2.7 PUSH消息大小限制

PUSH消息支持的Android APP包名称最大为128个字节，消息内容最大限制为4K（不包括Token）

2.8 PUSH消息流控限制

目前华为PUSH服务会对如下两个场景进行流控

  • 服务端申请Access Token
    开发者应用服务器短时间内频繁申请Access Token会被网关流控，返回error=6错误码

  • 服务端发送PUSH消息api.push.hicloud.com
    开发者应用服务器短时间内发送大量的推送消息会被流控，返回HTTP 503状态码

2.9 华为PUSH开放API认证方式

目前华为PUSH的开放API存在两种鉴权模式

  • 用户级鉴权模式
    开发者使用开发者帐号登录华为开发者联盟后，使用PUSH控制台进行通知消息发送时采用用户级鉴权模式
    Tips：PUSH控制台是华为为开发者提供的PUSH消息发送测试平台，可以在线编辑并发送PUSH消息用于测试应用是否正确集成Push服务

  • 应用级鉴权模式
    开发者在应用服务器调用开放API发送的通知消息采用的是基于应用的鉴权模式，在使用前必须获取对应级别的Access Token才能进行正常的消息下发

2.10 自定义通知渠道

通知渠道（channel）是Android O版本引入的新功能，意在解决如下问题：

  • 应用的通知越来越多，给用户造成明显打扰。
  • 华为手机系统EMUI 10.0之前仅有一个“默认通知”渠道，无法做通知消息呈现方式的定制。

华为手机系统从EMUI 10.0开始新增了三个通知渠道（服务提醒，普通通知与营销通知）来实现不同级别（重要与一般）的通知消息展示。

3. 使用华为Push场景介绍

开发一个APP产品，通过接入华为PUSH服务，用来实现如下功能：

  • 推送最新消息至消费者终端上的APP
  • 消费者点击消息可实现如下3个场景
    1. 用户点击通知栏消息后打开指定APP
    2. 用户点击通知栏消息后跳转指定网页
    3. 用户点击通知栏消息后跳转APP的某个指定页面

4. 华为Push集成之前需要做的

官方集成文档：华为推送服务

准备工作

  1. 注册认证成为开发者
  2. 创建产品和应用
  3. 开通推送服务
  4. 获取推送服务参数
  5. 下载SDK
  6. 推送配置等
  7. 集成工程

详情可参考：点我查看

接下来梳理集成步骤

在开发应用前，需要在AppGallery Connect中配置相关信息

  • 注册成为开发者(开通Push服务)

  • 推送配置等，例如：集成HMS Core SDK
    将agconnect-services.json文件拷贝到应用级根目录下

  • 配置HMS Core SDK的Maven仓地址
    打开Android Studio项目级“build.gradle”文件

	buildscript { 
    repositories { 
        google()
        jcenter()
        // 配置HMS Core SDK的Maven仓地址。
        maven { url 'https://developer.huawei.com/repo/'}
    }
    dependencies { 
        ...
        // 增加agcp配置。
        classpath 'com.huawei.agconnect:agcp:1.4.1.300'
    }
}
 
allprojects { 
    repositories { 
        google()
        jcenter()
        // 配置HMS Core SDK的Maven仓地址。
        maven { url 'https://developer.huawei.com/repo/'}
    }
}

备注：Maven仓地址无法直接在浏览器中打开访问，只能在IDE中配置。如需添加多个Maven代码库，请将华为公司的Maven仓地址配置在最后

  • 添加编译依赖，打开子工程app下的build.gradle文件
 dependencies { 
	 // {version} 替换为实际的版本号
	 // 如：api 'com.huawei.hms:push:5.0.4.302' 
    api 'com.huawei.hms:push:{version}'      
 }

在文件头apply plugin: ‘com.android.application’下一行添加如下配置

apply plugin: 'com.huawei.agconnect'
  • 在manifest节点下增加所需权限
<!--HMS-SDK引导升级HMS功能，访问OTA服务器需要网络权限-->    
<uses-permission android:name="android.permission.INTERNET" />   
 
<!--HMS-SDK引导升级HMS功能，保存下载的升级包需要SD卡写权限-->    
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />  
  
<!--检测网络状态-->  
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>  

<!--检测wifi状态-->  
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>  

<!--为了获取用户手机的IMEI，用来唯一的标识用户。-->  
<uses-permission android:name="android.permission.READ_PHONE_STATE"/> 

<!--如果是安卓8.0，应用编译配置的targetSdkVersion>=26，请务必添加以下权限 -->
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

<!-- 接收PUSH TOKEN的广播以及PUSH消息需要定义该权限 ${ PACKAGE_NAME} 要替换上您应用的包名 -->
<permission android:name="${PACKAGE_NAME}.permission.PROCESS_PUSH_MSG"
	android:protectionLevel="signatureOrSystem"/>

<!--接收PUSH TOKEN的广播以及PUSH消息需要定义该权限 ${ PACKAGE_NAME} 要替换上您应用的包名 -->
<uses-permission android:name="${PACKAGE_NAME}.permission.PROCESS_PUSH_MSG" />
  • 在application节点下声明2个receiver和1个service，用于接收广播信息
 用来接收PUSH消息的receiver：

  <!-- 接入HMSSDK PUSH模块需要注册，第三方相关 :接收Push消息（注册、透传消息、通知栏点击事件）广播，此receiver类需要开发者自己创建并继承com.huawei.hms.support.api.push.PushReceiver类，参考示例代码中的类：com.huawei.hmsagent.HuaweiPushRevicer-->

  <!--“xxx”用实际的类名替换, ${ PACKAGE_NAME} 要替换上您应用的包名-->
  <receiver android:name="xxx"
         android:permission="${PACKAGE_NAME}.permission.PROCESS_PUSH_MSG">
            <intent-filter>
               <!-- 必须,用于接收token -->
               <action android:name="com.huawei.android.push.intent.REGISTRATION" />
               <!-- 必须, 用于接收透传消息 -->
               <action android:name="com.huawei.android.push.intent.RECEIVE" />
               <!-- 必须, 用于接收通知栏消息点击事件 此事件不需要开发者处理，只需注册就可以-->
               <action android:name="com.huawei.intent.action.PUSH_DELAY_NOTIFY"/>
            </intent-filter>
  </receiver>
  • 配置混淆脚本
    开发者编译APK时请不要混淆HMS SDK以及HMS SDK的相关资源文件，避免功能异常
    加入排除hms的混淆配置
-ignorewarning
-keepattributes *Annotation*
-keepattributes Exceptions
-keepattributes InnerClasses
-keepattributes Signature
-keepattributes SourceFile,LineNumberTable
-keep class com.hianalytics.android.**{ *;}
-keep class com.huawei.updatesdk.**{ *;}
-keep class com.huawei.hms.**{ *;}

-keep class com.huawei.android.hms.agent.**{ *;}

5. 客户端开发

主要实现：获取设备的PUSH Token，获取Token后，开发者可以在联盟PUSH控制台或者开发者自己服务器向这些Token发送推送消息

5.1 申请Push Token

通过Push SDK的自动初始化能力来自动获取Token

 HmsMessaging.getInstance(mContext).setAutoInitEnabled(true);

通过HmsMessageService类中的onNewToken方法获取Token值

@Override
public void onNewToken(String token) { 
   // 获取token
   Log.i(TAG, "received refresh token:" + token);
   // 判断token是否为空
   if (!TextUtils.isEmpty(token)) { 
       refreshedTokenToServer(token);
   }
}

// 将获取Token传给APP服务器端
private void refreshedTokenToServer(String token) { 
   Log.i(TAG, "sending token to server. token:" + token);
}

5.2 设置是否显示通知栏消息

通知栏消息是由系统直接在通知中心下拉列表呈现的即时消息。您如果想控制应用是否允许显示通知栏消息，可以调用HmsMessaging类中的turnOnPush或者HmsMessaging类中的turnOffPush方法

 	/** * 2.设置是否显示通知栏消息 * * @param enable */
    public void setReceiveNotifyMsg(final boolean enable) { 
        if (enable) { 
            HmsMessaging.getInstance(mContext).turnOnPush()
                    .addOnCompleteListener(new OnCompleteListener<Void>() { 
                        @Override
                        public void onComplete(Task<Void> task) { 
                            if (task.isSuccessful()) { 
                                CLog.i(TAG, "turnOnPush Complete");
                            } else { 
                                CLog.i(TAG, "turnOnPush failed: cause="
                                        + task.getException().getMessage());
                            }
                        }
                    });
        } else { 
            HmsMessaging.getInstance(mContext).turnOffPush()
                    .addOnCompleteListener(new OnCompleteListener<Void>() { 
                        @Override
                        public void onComplete(Task<Void> task) { 
                            if (task.isSuccessful()) { 
                                CLog.i(TAG, "turnOffPush Complete");
                            } else { 
                                CLog.i(TAG, "turnOffPush failed: cause ="
                                        + task.getException().getMessage());
                            }
                        }
                    });
        }
    }

5.3 自定义点击消息的动作

5.4 展示应用角标
这个具体参看：点我查看

5.5 客户端测试

开发者可以参考PUSH控制台发送测试消息
来测试PUSH消息能否正确送达客户端。如需实现服务端自定义发送Push消息

6. 集成注意点，常见问题

6.1 华为推送服务中提供的透传消息是可能会丢失的.(当APP被杀死后,透传消息有时是收不到的。所以不推荐使用透传去做一些重要的功能)

6.2 从Push SDK4.0版本开始我们提供了自动初始化获取Token的能力

6.3 应用不要固定判断Token长度，因为后续长度可变；应用的Token要定期更新（建议应用每次启动的时候都获取Token，如果发现和上次取到的不同，则上报到自己的服务器）

6.4 推送是否支持非华为手机？
A：支持，非华为手机必须要安装华为移动服务，请到华为应用市场中搜索下载

6.5 通知栏消息系统版本要求
A：支持NC（Notification Center）功能的手机：部分EMUI4.0和4.1的手机，以及EMUI5.0及之后的华为手机。建议最好是5.0系统以及以上

6.6 通知栏消息样式

  • 华为通知样式默认是系统默认样式，通知栏消息的声音、样式和振动等不可以自定义
  • 大文本样式：默认样式下仅支持单行文本，大文本样式支持标题单行，内容文字多行（当前EMUI 9系统限制最多显示12行中文或者14行英文，EMUI 10&11系统限制最多显示11行中文或者13行英文）
  • 自定义消息小图标

6.7 推送是否支持角标
A：目前不支持通知栏消息和角标的同步，透传消息可以自行实现

6.8 透传消息和通知栏消息的区别
A：
透传消息：是华为Push将消息送达手机后不做呈现，直接转给开发者的应用，由应用本身去解析消息和呈现内容
通知栏消息：是华为Push将消息送达手机后，会在通知栏显示一条消息，点击后触发指定动作，应用不需要去解析消息和控制呈现，减少了应用的开发工作量

6.9 无法收到推送消息
A：

  • EMUI版本太低小于4.1.或华为移动服务版本较低
  • 检查CP是否使用的是老版本的的push,老版本sdk会出现消息延时很明显的情况，以及收不到推送，需要尽快切换到新版本
  • 服务端在推送消息到设备时，是否Token失效等，可让服务端配合查发送消息的返回状态码，详情 点我查看

6.10 接收不到消息，抓取相关日志

  • Adb连上手机分别执行下面命令
adb shell setprop log.tag.hwpush VERBOSE

adb logcat –v time > /Users/aaron/Desktop/huawei/hwpush.log

7. 参考

  1. Android集成华为推送踩坑问题总结
  2. Android华为推送自定义动作的实现
  3. Android集成华为推送踩坑问题总结
  4. 消息推送（华为）
  5. 推送开发常见问题 华为官网常见问题
  6. 【重要】Huawei Push 的Token生成规则变化公告
  7. 更多详细信息，点我查看
    原文作者：初心一点
    原文地址: https://blog.csdn.net/zmm911zmm/article/details/90906171
    本文转自网络文章，转载此文章仅为分享知识，如有侵权，请联系博主进行删除。
点赞