华为推送通道集成指南

华为推送通道是由华为官方提供的系统级推送通道。在华为手机上，推送消息能够通过华为的系统通道抵达终端，并且无需打开应用就能够收到推送。

Previous厂商通道 Next小米推送通道集成指南

Last updated 3 years ago

Was this helpful?

华为推送通道集成指南

华为推送通道是由华为官方提供的系统级推送通道。在华为手机上，推送消息能够通过华为的系统通道抵达终端，并且无需打开应用就能够收到推送。

华为推送只有在签名发布包环境下才可以收到推送消息
华为手机中的移动推送服务，必须升级到 2.5.3 以上版本

1. 获取华为推送秘钥

访问。
注册/登录开发者账号。（如果您是新注册账号，需进行实名认证）.
在华为推送平台中新建应用。注意：应用包名需跟您在GIO集成的包名保持一致

2. 在project 的 build.gradle 添加华为推送SDK的maven仓库地址

buildscript {
...
    repositories {
        google()
        jcenter()
        // sdk1.5.0版本开始迁移到了Maven Central
        mavenCentral()
        // 华为仓库
        maven { url 'http://developer.huawei.com/repo/' }
    }
    
    buildscript {
       dependencies {
           ...
           classpath 'com.huawei.agconnect:agcp:1.3.1.300'
       }
   }
...
}

allprojects {
...
    repositories {
        google()
        jcenter()
        // sdk1.5.0版本开始迁移到了Maven Central
        mavenCentral()
        // 华为仓库
        maven { url 'http://developer.huawei.com/repo/' }
    }
...
}

3. 在app build.gradle添加华为通道SDK依赖

dependencies {
    ...
    //由于推送底层网络库依赖OkHttp3网络库，请添加OkHttp3依赖
    implementation 'com.squareup.okhttp3:okhttp:3.12.1'
    //推送SDK依赖
    implementation 'com.growingio.android:gtouch:$gtouch_version'
    //华为推送SDK依赖
    implementation 'com.growingio.android.gpush:gpush-huawei-adapter:$gtouch_version'
}

4. 对接华为官方推送服务

在项目列表中找到您的项目，在项目中点击需要集成HMS Core SDK的应用。
在“项目设置 > 常规”页面的“应用”区域，点击“agconnect-services.json”下载配置文件。
将“agconnect-services.json”文件拷贝到应用级根目录下。
在app的 build.gradle文件添加

apply plugin: 'com.huawei.agconnect'

5. 配置AppID

android {
        ......
        defaultConfig {
            manifestPlaceholders = [
                PACKAGE_NAME        : "您的APP包名",

                GPUSH_HUAWEI_APP_ID : "华为推送的AppId(华为推送不需要AppKey)",
            ]
            ......
        }
        ......
}

6. 代码混淆

-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.**{*;}

7. 配置服务端AppID和AppSecret

8. 设置推送消息回执

在华为推送APP编辑界面配置回执，以便于我们GrowingIO更好的统计推送数据

目前单击【测试回执】，会提示“https，error"，请忽略并直接单击【提交】。

其中回调地址

https://messages.growingio.com/v1/callback/huawei

HTTPS证书

9. 厂商通道测试方法

将集成好的App（测试版本）安装在一台华为测试机上，并且运行App
保持App在前台运行，尝试扫码测试推送消息
如果应用收到消息，将App退到后台，并且杀掉所有App进程
再次进行测试推送消息，如果能够收到推送，则表明厂商通道集成成功

10. 兼容性

如果您的App已经集成了个推VIP或极光VIP版本的推送SDK，我们的Android SDK也能兼容。

为了和个推兼容，我们将厂商通道独立打包。以华为推送通道为例，我们打包两个SDK：gpush-huawei-sdk和gpush-huawei-adapter。

如果是个推、极光等VIP版本的用户可以将官方SDK包gpush-huawei-sdk 排除出去。

implementation ('com.growingio.android.gpush:gpush-huawei-adapter:$gtouch_version') {
        exclude(group: 'com.huawei.hms' , module: 'push')
    }

Previous厂商通道 Next小米推送通道集成指南

Last updated 3 years ago

Was this helpful?