android 信鸽 小米推送,小米推送通道集成指南

1. 小米推送通道集成指南

小米推送通道是由小米官方提供的系统级推送通道。在小米手机上，推送消息能够通过小米的系统通道抵达终端，并且无需打开应用就能够收到推送。使用此功能必须先集成信鸽3.2.0以上版本。

1.1. 获取小米推送秘钥

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

认证小米开发者：

获取小米推送密钥：

1.2. 配置小米推送相关内容

1.2.1. AS开发建议使用jcenter依赖接入

1.配置包名。

manifestPlaceholders = [

PACKAGE_NAME:"应用包名"

]

2.引入小米推送的jar包

以下两个版本请根据需要选择其中之一

//在集成信鸽的基础上新增小米push的jar包

compile 'com.tencent.xinge:mipush:3.2.2-release'

/* 小米3.2.4-beta版

* 注意：若小米通道使用此版本,则信鸽sdk版本也需要同时使用v3.2.4-beta

*/

compile 'com.tencent.xinge:mipush:3.2.4-beta'

3.新建一个类继承小米PushMessageReceiver，然后再Androidmanif.xml 中配置。根据小米的要求次节点必须配置

android:exported="true"

android:name="完整路径+类名如：com.qq.xgdemo.receiver.MiMessageReceiver">

注：如果使用mipush:3.2.4-beta版本则不需要此步骤，只需要前两步即可

1.2.2. Eclipse开发接入

1.引入小米推送的jar包，可以在小米推送web官网下载小米的jar包。

2.在配置好信鸽的基础上 ，新增小米推送的配置:

android:name="com.xiaomi.push.service.XMPushService"

android:enabled="true"

android:process=":pushservice" />

android:name="com.xiaomi.push.service.XMJobService"

android:enabled="true"

android:exported="false"

android:permission="android.permission.BIND_JOB_SERVICE"

android:process=":pushservice" />

android:name="com.xiaomi.mipush.sdk.PushMessageHandler"

android:enabled="true"

android:exported="true" />

android:name="com.xiaomi.mipush.sdk.MessageHandleService"

android:enabled="true" />

android:name="com.xiaomi.push.service.receivers.NetworkStatusReceiver"

android:exported="true" >

android:name="com.xiaomi.push.service.receivers.PingReceiver"

android:exported="false"

android:process=":pushservice" >

android:name="应用包名.permission.MIPUSH_RECEIVE"

android:protectionLevel="signature" />

3.新建一个类继承小米PushMessageReceiver，然后再Androidmanif.xml 中配置。根据小米的要求此节点必须配置：

android:exported="true"

android:name="com.tencent.android.mipush.XMPushMessageReceiver">

1.3. 开启小米推送

设置小米APPID和APPKEY。

XGPushConfig.setMiPushAppId(getApplicationContext(), "APPID");

XGPushConfig.setMiPushAppKey(getApplicationContext(), "APPKEY");

//打开第三方推送

XGPushConfig.enableOtherPush(getApplicationContext(), true);

//注册成功的日志如下

12-02 16:17:32.299 12584-12584/com.qq.xgdemo I/XINGE: [XGPushManager] Action -> Register to xinge server

12-02 16:17:32.996 12584-12584/com.qq.xgdemo I/XINGE: [XGPushManager] Register call back to com.qq.xgdemo

12-02 16:17:32.997 12584-12626/com.qq.xgdemo I/XINGE: [XGPushManager] XG register push success with token : 1d31bb3ea6185baebdf05dfc2e586dfe5dc41fb5

12-02 16:17:33.001 12584-12626/com.qq.xgdemo I/XINGE: [XGOtherPush] other push token is : YZQfRxmxdfNlbSKpNWCa3tM4Esnq6op4qeOsQO2qT88= other push type: xiaomi

注：如果需要通过点击回调获取参数或者跳转自定义页面，可以通过使用Intent来实现，点击查看教程

1.4. 代码混淆

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

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

1.5. 厂商通道测试方法(通用)

在您的App中集成信鸽V3.2.1以上版本的SDK，并且按照「厂商通道集成指南」集成所需的厂商SDK

确认已在信鸽管理台中「应用配置-厂商&海外通道」中填写相关的应用信息。通常相关配置将在1个小时后生效，请您耐心等待，在生效后再进行下一个步骤

将集成好的App(测试版本)安装在测试机上，并且运行App

保持App在前台运行，尝试对设备进行单推/全推

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

再次进行单推/全推，如果能够收到推送，则表明厂商通道集成成功