如何集成移动推送提供的荣耀辅助通道SDK_移动研发平台-阿里云帮助中心

本章节介绍如何集成移动推送提供的荣耀辅助通道SDK。

获取荣耀推送密钥

登录HONOR Develops，注册您的应用，在应用服务→推送服务→应用查看中获取App ID、Client ID、Client Secret等信息。

配置签名证书指纹

在荣耀开发者平台上配置签名证书指纹。获取及配置请参见荣耀官方文档证书指纹生成指南。

设置消息回执

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

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

控制台配置密钥

登录移动推送控制台，设置您的荣耀推送密钥（App ID），设置方法参见配置厂商通道密钥。

通道集成

准备工作
请阅读Android SDK版本说明，下载对应版本SDK或获取最新SDK配置信息。
添加依赖

方式一：手动集成

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

repositories {
    flatDir {
        dirs 'libs' //this way we can find the .aar file in libs folder
    }
}
...
dependencies {
    ......
    implementation(name: 'alicloud-android-third-push-x.x.x', ext: 'aar')
    implementation(name: 'alicloud-android-third-push-honor-x.x.x', ext: 'aar')
    implementation(name: 'honor-push-7.0.41.301', ext: 'aar')
}

方式二：Maven集成

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

allprojects {
    repositories {
        maven {
            url 'http://maven.aliyun.com/nexus/content/repositories/releases/'
        }
    }
}

gradle添加依赖：

dependencies {
    implementation 'com.aliyun.ams:alicloud-android-third-push:x.x.x'
    implementation 'com.aliyun.ams:alicloud-android-third-push-honor:x.x.x'
}

混淆配置

-ignorewarnings
-keepattributes *Annotation*
-keepattributes Exceptions
-keepattributes InnerClasses
-keepattributes Signature
-keepattributes SourceFile,LineNumberTable
-keep class com.hihonor.push.**{*;}

重要

Android推送SDK 3.8.7版本开始，荣耀通道升级至7.0.61.302版本，该版本荣耀通道的混淆配置有所变更，请及时更新混淆文件配置

初始化
a. 在AndroidManifest.xml中配置APP ID, 其中xxxxx为荣耀应用的APP ID。
```
<meta-data
	android:name="com.hihonor.push.app_id"
	android:value="xxxxx" />
```
b. 将以下代码加入Application的onCreate()方法中，初始化荣耀通道。
```
HonorRegister.register(application);
```
Android 8+适配
自Android 8.0（API Level 26）起，Android推出了NotificationChannel机制，旨在对通知进行分类管理。如果用户App未设置NotificaitonChannel，那么创建的通知不会弹出显示。具体请参见Android 8.0以上设备接收不到推送通知进行适配。