华为推送通道集成指南

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

  • 华为推送只有在签名发布包环境下才可以收到推送消息

  • 华为手机中的移动推送服务，必须升级到 2.5.3 以上版本

1. 获取华为推送秘钥

  1. 访问 华为开放平台。

  2. 注册/登录开发者账号。（如果您是新注册账号，需进行实名认证）.

  3. 在华为推送平台中新建应用。注意：应用包名需跟您在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依赖

$gtouch_version 为最新SDK版本号，现最新的版本号为请参考SDK更新日志。

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

根据华为官方文档集成华为推送

  1. 登录AppGallery Connect网站，点击“我的项目”。

  2. 在项目列表中找到您的项目，在项目中点击需要集成HMS Core SDK的应用。

  3. 在“项目设置 > 常规”页面的“应用”区域，点击“agconnect-services.json”下载配置文件。

  4. 将“agconnect-services.json”文件拷贝到应用级根目录下。

  5. 在app的 build.gradle文件添加

5. 配置AppID

6. 代码混淆

7. 配置服务端AppID和AppSecret

8. 设置推送消息回执

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

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

其中回调地址

HTTPS证书

9. 厂商通道测试方法

  1. 将集成好的App（测试版本）安装在一台华为测试机上，并且运行App

  2. 保持App在前台运行，尝试扫码测试推送消息

  3. 如果应用收到消息，将App退到后台，并且杀掉所有App进程

  4. 再次进行测试推送消息，如果能够收到推送，则表明厂商通道集成成功

  5. 最好能根据官方推荐方式，先测通华为官方推送

10. 兼容性

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

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

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

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

Last updated

Was this helpful?