运营平台使用指南
  • 产品简介
  • 快速上手 - App
  • 快速上手 - Web
  • 快速上手 - H5
  • 快速上手 - 小程序
  • 开发者文档
    • Webhook 通道对接
    • SDK集成
      • SDK更新日志
      • iOS SDK
        • iOS SDK 概述
        • 弹窗 SDK(iOS)
        • 推送 SDK(iOS)
        • 资源位 SDK(iOS)
        • 集成后调试指南
        • 常见问题
        • iOS 推送证书设置指南
        • iOS推送1.3.2及以前推送版本升级指导
        • iOS SDK 1.1.2及以下旧版本升级指导
      • Android SDK
        • 弹窗 SDK (Android)
        • 推送 SDK(Android)
        • 资源位 SDK(Android)
      • Flutter SDK
        • 弹窗 SDK(Flutter)
      • RN SDK
        • 弹窗 SDK( RN)
      • 小程序SDK
        • 弹窗SDK(微信小程序)
        • 资源位SDK(微信小程序)
        • 调试指南(小程序)
        • 小程序获取设备访问ID
        • 弹窗SDK(支付宝小程序)
        • 小程序集成常见问题
      • Web弹窗SDK
      • H5弹窗SDK
    • 厂商通道
      • 华为推送通道集成指南
      • 小米推送通道集成指南
      • 魅族推送通道集成指南
      • vivo推送通道集成指南
      • OPPO推送通道集成指南
    • API参考
      • 弹窗API
      • 推送API
  • 产品使用文档
    • 权限配置
    • 弹窗
      • 创建弹窗
      • 弹窗数据
      • 弹窗管理
      • A/B测试
    • 资源位
      • 创建资源位
      • 轮播图设置
      • 资源位数据
    • 推送
      • 概述
      • 推送准备
      • 创建推送
      • 推送数据
    • 短信
      • 阿里云短信
      • 云片短信
      • 创蓝短信
    • Webhook
    • 用户分层
    • 流程画布
      • 流程画布核心功能
      • ABtest
  • FAQ
    • 弹窗 FAQ
    • 推送(Push) FAQ
    • 术语解释
Powered by GitBook
On this page
  • 1. 获取小米推送秘钥
  • 2. 在app build.gradle添加小米通道SDK依赖
  • 3. 配置AppID和AppKey
  • 4. 代码混淆
  • 5. 配置服务端AppID和AppSecret
  • 6. 厂商通道测试方法
  • 7. 兼容性

Was this helpful?

  1. 开发者文档
  2. 厂商通道

小米推送通道集成指南

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

Previous华为推送通道集成指南Next魅族推送通道集成指南

Last updated 5 years ago

Was this helpful?

1. 获取小米推送秘钥

根据指引开通小米开发者账号,然后注册应用并获取小米推送的秘钥。

认证小米开发者:

获取小米推送秘钥:

2. 在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-xiaomi-adapter:$gtouch_version'
}

3. 配置AppID和AppKey

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

                GPUSH_XIAOMI_APP_ID : "小米推送的AppId",
                GPUSH_XIAOMI_APP_KEY: "小米推送的AppKey",
            ]
            ......
        }
        ......
}

4. 代码混淆

-keep class com.xiaomi.**{*;}

-keep public class * extends com.xiaomi.mipush.sdk.PushMessageReceiver

5. 配置服务端AppID和AppSecret

在应用配置界面输入您APP的AppID和AppSecret

6. 厂商通道测试方法

  1. 将集成好的App(测试版本)安装在一台小米测试机上,并且运行App

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

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

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

7. 兼容性

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

为了和个推兼容,我们将厂商通道独立打包。以小米推送通道为例,我们打包两个SDK:gpush-mipush-sdk和gpush-xiaomi-adapter。如果是从未接过个推、极光等VIP版本的用户可以直接添加小米推送通道依赖。

implementation 'com.growingio.android.gpush:gpush-xiaomi-adapter:$gtouch_version'

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

implementation ('com.growingio.android.gpush:gpush-xiaomi-adapter:$gtouch_version'){
      exclude(group: 'com.growingio.android.gpush' , module: 'gpush-mipush-sdk')
}

$gtouch_version 为最新SDK版本号,现最新的版本号为请参考。

SDK更新日志
小米开放平台