华为辅助通道集成

获取华为推送密钥

登录华为开发者联盟，注册您的应用，在应用信息中获取APP ID和SecretKey。

如果在上图中未找到SecretKey，您也可以在下图中查看OAuth2.0客户端ID（凭据）中的Client Secret。

配置SHA256证书指纹

在华为开发者联盟配置SHA256证书指纹。获取及配置请参见华为官方文档配置AppGallery Connect。

设置消息回执

使用辅助弹窗后，华为通道的到达率统计覆盖用户点击华为弹窗推送通知的场景，未点击部分暂未覆盖，您可在华为端设置消息回执，便于移动推送更好的统计推送数据，具体设置方法请参见：消息回执。

开通回执需配置回调地址：https://amspush-ack.aliyuncs.com/hw/。

控制台配置密钥

登录移动推送控制台，设置您的华为推送密钥（AppID和AppSecret），设置方法参见配置厂商通道密钥。

通道集成

1. 准备工作

   请阅读Android SDK版本说明，下载对应版本SDK或获取最新SDK配置信息。

2. 添加依赖

   说明

   • 建议使用Maven集成。

   • 3.2.0及以上版辅助通道扩展包以aar形式透出，省却manifest文件配置，减少出错概率。

   • 方式一：手动集成

     注意3.2.4及以上版本华为SDK不支持手动集成。

     解压下载好的辅助通道SDK扩展包，并将之放置到app module的libs路径下，并在app module的build.gradle文件中添加如下配置：

   • repositories {
         flatDir {
             dirs 'libs' //this way we can find the .aar file in libs folder
         }
         // 配置HMS Core SDK的Maven仓地址。
         maven {
             url 'https://developer.huawei.com/repo/'
         }
     }
     ...
     dependencies {
         ......
         compile(name: 'alicloud-android-third-push-x.x.x', ext: 'aar')
         compile(name: 'alicloud-android-third-push-huawei-x.x.x', ext: 'aar')
         compile 'com.huawei.hms:push:5.x.x.x'
     }

   • 方式二：Maven集成

     项目顶层build.gradle中添加Maven仓库地址：

     allprojects {
         repositories {
             maven {
                 url 'http://maven.aliyun.com/nexus/content/repositories/releases/'
             }
             // 配置HMS Core SDK的Maven仓地址。
             maven {
                 url 'https://developer.huawei.com/repo/'
             }
         }
     }

     gradle添加依赖：

     dependencies {
         compile 'com.aliyun.ams:alicloud-android-third-push-huawei:x.x.x'
     }

3. 混淆配置

   如果集成推送SDK的工程开启代码混淆，需要添加以下辅助通道的Proguard配置。

   # 华为通道
   -keep class com.huawei.** {*;}
   -dontwarn com.huawei.**

4. 初始化

   1. 在AndroidManifest.xml中配置AppID，其中xxxxx为华为应用的AppID。

      <meta-data
                  android:name="com.huawei.hms.client.appid"
                  android:value="appid=xxxxxx" />

   2. 将以下代码加入你application.onCreate()方法中初始化通道。

      注意

      辅助通道注册务必在Application中执行且放在推送SDK初始化代码之后，否则可能导致辅助通道注册失败。

      // 注册方法会自动判断是否支持华为系统推送，如不支持会跳过注册。
      HuaWeiRegister.register(application);

      本方法会自动判断是否支持华为系统推送，如不支持会跳过注册。

5. Android 8+配置

   自Android 8.0（API Level 26）起，Android推出了NotificationChannel机制，旨在对通知进行分类管理。如果用户App的targetSdkVersion大于等于26，且并未设置NotificaitonChannel，那么创建的通知是不会弹出显示。

   请参见Android 8.0以上设备接收不到推送通知进行适配。

6. 初始化成功验证

   华为通道初始化成功，可以看到以下日志：

   

使用辅助弹窗

厂商通道，除Google通道外，只能通过辅助弹窗来接收推送数据，详情参考辅助弹窗接入。

辅助通道常见问题

• 华为通道注册时返回6003：证书指纹配置不对应，请再次进行“配置SHA256证书指纹”

• Android端辅助通道和弹窗问题的排查步骤

• Android端辅助通道SDK与其他厂商SDK冲突

• Android端阿里云移动推送与其他注册厂商如何同时获取regId

• Android端辅助通道收到推送通知后单击通知无法打开相应Activity

• Android端辅助弹窗启动报解析body异常

• 在集成移动推送辅助通道后显示”register not in main process，return”