Android消息推送OnePush

Android 消息推送

1.实现原理

• 1.消息推送的实质

  实际上&＃xff0c;是当服务器有新消息需推送给用户时&＃xff0c;先发送给应用App&＃xff0c;应用App再发送给用户

  推送的消息一般是用户需要的或app希望用户知道的消息

• 2.原理

2.现今有哪些推送方式

• Cloud to Device Messaging&＃xff0c;云端推送&＃xff0c;是Android系统级别的消息推送服务&＃xff08;Google出品&＃xff09;
• 基于Pull方式&＃xff0c;应用程序隔固定时间主动与服务器进行连接并查询是否有新的消息
• SMS信令推送
• XMPP协议

以上是现今的推送方式&＃xff0c;基于以上方式国内形成了一系列的推送应用&＃xff1a;

手机厂商类&＃xff1a;小米推送、华为推送。
第三方平台类&＃xff1a;友盟推送、极光推送、云巴&＃xff08;基于MQTT&＃xff09;
BAT大厂的平台推送&＃xff1a;阿里云移动推送、腾讯信鸽推送、百度云推送

我在使用过程中发现了一个有意思的开源项目OnePush

3.OnePush

1. 添加OnePush主要依赖&＃xff08;必须添加&＃xff09;

项目project的build.gradle

allprojects {repositories {jcenter()maven { url &＃39;https://jitpack.io&＃39; }//由于魅族个推等第三方库使用了不同的仓库&＃xff0c;需要加上这个maven { url &＃39;http://oss.jfrog.org/artifactory/oss-snapshot-local/&＃39; }maven { url "http://mvn.gt.igexin.com/nexus/content/repositories/releases/" }maven { url &＃39;http://developer.huawei.com/repo/&＃39; }}
}


工程module的build.gradle

dependencies {compile &＃39;com.peng.library:one-push-core:lastVersion&＃39;
}


2. 添加第三方推送依赖&＃xff08;根据自己的需求进行添加&＃xff0c;当然也可以全部添加&＃xff09;

dependencies {//华为推送和HMS服务只能选择其中的一个//compile &＃39;com.peng.library:one-push-huawei:lastVersion&＃39;compile &＃39;com.peng.library:one-push-huawei-hms:lastVersion&＃39;compile &＃39;com.peng.library:one-push-xiaomi:lastVersion&＃39;compile &＃39;com.peng.library:one-push-umeng:lastVersion&＃39;compile &＃39;com.peng.library:one-push-getui:lastVersion&＃39;compile &＃39;com.peng.library:one-push-meizu:lastVersion&＃39;compile &＃39;com.peng.library:one-push-jpush:lastVersion&＃39;}


3. 继承BaseOnePushReceiver重写里面的方法&＃xff0c;并在AndroidManifest.xml中注册

4. 在AndroidManifest.xml的application标签下&＃xff0c;添加第三方推送实现类

关于标签书写规则&＃xff1a;

• android:name 必须是以“ OnePush ”开头&＃xff0c;并且以“_“进行分割(OnePush_平台名称_平台标识码)&＃xff0c;在初始化OnePush 的时候&＃xff0c;根据标识码和当前手机系统&＃xff0c;动态的使用不同平台消息推送。
• android:value 这个是继承IPushClient实现类&＃xff0c;全类名路径。

5. 添加第三方AppKey和AppSecret

如果使用了one-push-xiaomi,那么需要在AndroidManifest.xml添加小米的AppKey和AppSecret&＃xff08;注意下面的“\ ”必须加上&＃xff0c;否则获取到的是float而不是String&＃xff0c;就会导致id和key获取不到正确的数据&＃xff09;

6. 初始化OnePush

//初始化的时候&＃xff0c;回调该方法&＃xff0c;可以根据platformCode和当前系统的类型&＃xff0c;进行注册
//返回true&＃xff0c;则使用该平台的推送&＃xff0c;否者就不使用
//只在主进程中注册(注意&＃xff1a;umeng推送&＃xff0c;除了在主进程中注册&＃xff0c;还需要在channel中注册)if (BuildConfig.APPLICATION_ID.equals(currentProcessName) || BuildConfig.APPLICATION_ID.concat(":channel").equals(currentProcessName)) {OnePush.init(this, ((platformCode, platformName) -> {//platformCode和platformName就是在标签中&＃xff0c;对应的"平台标识码"和平台名称if (RomUtils.isMiuiRom()) {return platformCode &＃61;&＃61; 101;} else if (RomUtils.isHuaweiRom()) {return platformCode &＃61;&＃61; 102;} else if (RomUtils.isFlymeRom()) {return platformCode &＃61;&＃61; 105;}else {return platformCode &＃61;&＃61; 104;}}));OnePush.register();
}


7. 后台推送动作说明&＃xff1a;

• 注册友盟推送除了在主进程中&＃xff0c;还需要在channel进程中进行注册&＃xff0c;具体操作见DEMO&＃xff08;UMeng官方推送就是这样要求的&＃xff09;
• 友盟推送&＃xff1a;后台配置后续动作&＃xff0c;为“自定义行为”。
• 小米推送&＃xff1a;后台配置点击后续动作&＃xff0c;为“由应用客户端自定义”。
• 魅族推送&＃xff1a;后台配置点击动作&＃xff0c;为“应用客户端自定义”
• 个推推送&＃xff1a;后台配置后续动作为打开应用&＃xff0c;如果你发送的通知&＃xff0c;为了保证你点击通知栏能收到在NotificationClick的回调&＃xff0c;每一个通知必须都带有one-push规定格式的透传消息&＃xff0c;如果你只发送透传&＃xff0c;那就不必按照下面的格式。

个推通知中透传消息json:{"onePush":true,"title":"通知标题","content":"通知内容","extraMsg":"额外信息","keyValue":{"key1":"value1","key2":"value2","key3":"value3"}}


• 华为推送和华为HMS服务&＃xff1a;后台配置后续行为&＃xff0c;为“自定义动作”&＃xff0c;具体内容&＃xff0c;可由OnePushService包&＃xff1a;com.peng.one.push.service.huawei.intent.HWPushIntent生成&＃xff0c;如果后台不是java开发的&＃xff0c;参照HWPushIntent重新写。

8. 集成 友盟推送 的童鞋注意啦

• OnePush拓展的友盟推送是[版本v3.1.1a]。
• 关于utdid重复引入的问题&＃xff0c;可以通过下面的方案解决

//如果utdid和你工程项目里面发生冲突了&＃xff0c;请修改成这个依赖compile (&＃39;com.peng.library:one-push-umeng:lastVersion&＃39; ){exclude group: &＃39;com.peng.library&＃39;,module:&＃39;one-push-umeng-utdid4all&＃39;}


• 关于友盟推送so文件处理&＃xff0c;OnePush拓展的友盟推送&＃xff0c;默认将所有的so文件引入了&＃xff0c;这样就导致友盟推送aar文件大小达到2.25M左右&＃xff0c;所以下面提供一个裁剪so文件的方法 第一步&＃xff1a;在工程根目录的gradle.properties文件中&＃xff0c;添加 android.useDeprecatedNdk&＃61;true 第二步&＃xff1a;在项目&＃xff08;app&＃xff09;的build.gradle节点defaultConfig下添加

ndk {// 设置支持的SO库abiFilters &＃39;armeabi&＃39;//,&＃39;armeabi-v7a&＃39;, &＃39;x86&＃39;, &＃39;x86_64&＃39;, &＃39;arm64-v8a&＃39;,&＃39;mips&＃39;,&＃39;mips64&＃39;}


根据自己工程的需要&＃xff0c;配置不同的so编译&＃xff0c;然后Rebuild Project。

• 最后啰嗦几句&＃xff0c;其实只要添加armeabi&＃xff0c;就可以了&＃xff0c;armeabi在每个平台都是可以用的&＃xff0c;俗称万能油。只是在其他CPU平台上&＃xff0c;使用armeabi&＃xff0c;效率不是很高而已&＃xff0c;其实微信也是只使用了armeabi&＃xff0c;只不过它为了提高效率&＃xff0c;他将v7a也放在了armeabi里面&＃xff0c;最后根据具体安装的手机CPU&＃xff0c;动态加载而已。

9. 集成 华为推送 的童鞋注意啦

• BaseOnePushReceiver中的onReceiveNotification()方法&＃xff0c;在使用的华为推送的时候&＃xff0c;该方法不会被调用&＃xff0c;因为华为推送没有提供这样的支持。
• BaseOnePushReceiver中的onReceiveNotificationClick()方法&＃xff0c;在使用华为推送的时候&＃xff0c;虽然华为支持&＃xff0c;但是如果app被华为一键清理掉后&＃xff0c;收到通知&＃xff0c;那么点击通知是不会调用华为推送的onEvent&＃xff08;&＃xff09;方法&＃xff0c;那么如果我们这里转发&＃xff0c;onReceiveNotificationClick&＃xff08;&＃xff09;是不会收到的。
• 为了解决华为推送&＃xff0c;在手机上被清理掉后&＃xff0c;onReceiveNotificationClick&＃xff08;&＃xff09;不被调用的情况&＃xff0c;OnePush在华为推送上&＃xff0c;使用跳转到指定Activity的推送通知&＃xff0c;那么服务端必须提供一个Intent序列化的uri&＃xff0c;OnePush提供的Java服务端消息推送示例中&＃xff0c;已经提供了服务端序列化Intent的uri的实现&＃xff08;详见&＃xff1a;com.peng.one.push.service.huawei.intent.HWPushIntent&＃xff09;。

10. 关于将来拓展其他平台消息推送说明

• 个人感觉&＃xff0c;除了厂商的推送&＃xff0c;其他的第三方推送只需要集成一个就可以了&＃xff0c;假如你想使用OnePush&＃xff0c;但是目前OnePush拓展的消息推送平台&＃xff0c;没有你目前使用的怎么办呢&＃xff0c;可以参照OnePush拓展详细说明&＃xff0c;进行集成。
• 如果你已经拓展其他平台的消息推送&＃xff0c;并且测试通过&＃xff0c;可以将代码Push过来&＃xff0c;我检查过后&＃xff0c;合并进来&＃xff0c;这样可以方便大家。

11. 拓展其他平台说明

关于添加其他消息推送SDK具体操作&＃xff08;如果你不满足OnePush提供的小米、华为推送&＃xff0c;可根据下面步骤&＃xff0c;将其他厂商提供的推送&＃xff0c;添加到OnePush里面&＃xff09;

• 创建XXXClient 实现IPushClient接口&＃xff0c;并且重写对应的方法&＃xff0c;initContext(Context),会在初始化的使用进行调用&＃xff0c;可以在这里进行获取第三方推送注册需要的ID&＃xff0c;KEY或者其他操作&＃xff0c;第三方推送ID、KEY&＃xff0c;建议在AndroidManifest.xml中的Application标签下添加&＃xff0c;然后在initContext(Context)中进行获取。
• 创建和重写三方消息推送的Receiver或者IntentService&＃xff08;一般第三方会让你继承他的receiver&＃xff0c;这里指的就是他&＃xff09;&＃xff0c;重写三方推送的的接收透传消息和通知的方法&＃xff0c;调用OneRepeater的transmitXXX方法&＃xff0c;将通知、透传消息、通知点击事件、以及其他事件&＃xff0c;转发到OnePush。
• 记得在OnePush注册的时候&＃xff0c;进行消息推送平台的选择。
• 具体操作方法&＃xff1a;详见one-push-xiaomi

12. 代码混淆

-dontoptimize
-dontpreverify
-dontwarn com.taobao.**
-dontwarn anet.channel.**
-dontwarn anetwork.channel.**
-dontwarn org.android.**
-dontwarn org.apache.thrift.**
-dontwarn com.xiaomi.**
-dontwarn com.huawei.**
-dontwarn com.peng.one.push.**
-dontwarn com.igexin.**
-dontwarn cn.jpush.**
-dontwarn cn.jiguang.**
-keepattributes *Annotation*-keep class cn.jpush.** { *; }
-keep class * extends cn.jpush.android.helpers.JPushMessageReceiver { *; }
-keep class cn.jiguang.** { *; }
-keep class com.taobao.** {*;}
-keep class org.android.** {*;}
-keep class anet.channel.** {*;}
-keep class com.umeng.** {*;}
-keep class com.xiaomi.** {*;}
-keep class com.huawei.** {*;}
-keep class com.hianalytics.android.** {*;}
-keep class com.meizu.cloud.**{*;}
-keep class org.apache.thrift.** {*;}
-keep class com.igexin.** { *; }
-keep class org.json.** { *; }
-keep class com.alibaba.sdk.android.**{*;}
-keep class com.ut.**{*;}
-keep class com.ta.**{*;}-keep public class **.R$*{public static final int *;
}#&＃xff08;可选&＃xff09;避免Log打印输出
-assumenosideeffects class android.util.Log {public static *** v(...);public static *** d(...);public static *** i(...);public static *** w(...);}# OnePush的混淆
-keep class * extends com.peng.one.push.core.IPushClient{*


三、相关api介绍

OnePush详细api

OneRepeater详细api

作者&＃xff1a;陈春 原文地址