由于信鸽接入文档比较详细,这里我不对如何接入进行阐述,想知道具体如何接入可以参考信鸽帮助手册:信鸽Android快速接入,在这里,我就说一些在文档和信鸽提供的demo里不细致或者没有或者以前我没有发现的,但是比较实用的进行描述吧,也是一个工作的存档。
Part1:信鸽注册。
APP只有在完成信鸽的启动与注册后才可以信鸽SDK提供push服务,在这之前请确保配置AccessId和AccessKey。
新版的SDK已经将启动信鸽和APP注册统一集成在注册接口中,即只需调用注册接口便默认完成启动和注册操作。
注册成功后,会返回设备token,token用于标识设备唯一性,同时也是信鸽维持与后台连接的唯一身份标识。
关于如何获取token请参考“获取token”章节。注册接口通常提供简版和带callback版本的接口,请根据业务需要决定选择接口。
这是信鸽接入文档里的话,一开始我以为只要信鸽注册了一次,就ok了。事实上信鸽的token只要注册过一次,只要你不反注册就不会丢失。但是,你在后台程序中关掉APP,信鸽就接收不到通知了。所以,你注册的代码必须写在每次启动APP都会去调用的地方。而且不能傻傻的跟我以前一样,为了避免多次注册还加个判断token是否存在的代码,这个确实是画蛇添足啊!人家要的就是每次打开APP都注册一次!(可能我的想法不是很正确啊!但这是我实际开发中遇到的,实际的方法,就是每次打开APP注册)
Part2:debug模式。
XGPushConfig配置类,提供信鸽服务的对外配置API列表,方法默认为public static类型,对于本类提供的set和enable方法,要在XGPushManager接口前调用才能及时生效。
void enableDebug(Context context,boolean debugMode)
是否开启debug模式,即输出logcat日志(重要:为保证数据的安全性,发布前必须设置为false)
debug模式在实际开发中还是很重要的,因为我以前也在另一个项目中集成过信鸽,但是那边需求比较简单,只需要集成进去就可以了,所以也就没有过多的关注过,但如果你的需求比较复杂,而你对信鸽了解还不是很深的时候,遇到问题,debug模式就能给你很大的帮助了,而且就是一句代码的问题:
XGPushConfig.enableDebug(MainActivity.this, RuntimeStatus.isDebug());
RuntimeStatus.isDebug(),是我本地测试环境正式环境的字段。
Part3:信鸽推送通知栏点击之重复打开APP&重复从Laucher主入口启动问题
说到这个首先要推荐一篇文章。这是一篇别人工作的存档,里面的字数特别少,相对于别人文章而言,但是却每一句话都特别有用!
【Android】信鸽推送通知栏点击之重复打开APP&重复从Laucher主入口启动问题
http://blog.csdn.net/littlebrain4solving/article/details/50903052 链接地址
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// 判断是否从推送通知栏打开的
XGPushClickedResult click = XGPushManager.onActivityStarted(this);
if(click !=null) {
//从推送通知栏打开Service打开Activity会重新执行Laucher流程 //查看是不是全新打开的面板
if(isTaskRoot()) {return;}
finish();//如果有面板存在则关闭当前的面板
}}
这段代码可以很好的解决外部来了通知点开后会打开两遍APP的问题,但是要注意一点就是这段话一定要放在onCreate的最开始的地方。放到其他代码后面还是不能解决问题的。我就在这里摔了一跤,把这段代码放在最后面,还是debug模式才发现这个问题。
Part4:从信鸽的Service外部进程打开Activity
这里特别指出一下就是去启动Activity的时候,必须添加flags标记。不添加,带过去的参数就会是null,无法进行接下来的跳转业务。
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
Part5:更改信鸽通知栏的图片大小
通知栏中信鸽推送的图片,一般是在我们的AndroidManifest里的android:icon的属性里添加的,一般都会选择这里面的图片。我们当然可以在这里进行图片适配,但是安卓总有些奇葩手机,这样的适配的不行的。所以,在反编译之后,发现有几句代码可以专门针对信鸽的图片进行更改。不去用icon里的图片。
XGBasicPushNotificationBuilder builder =newXGBasicPushNotificationBuilder();
builder.setIcon(R.drawable.push_logo);//设置状态栏的通知小图标
XGPushManager.setDefaultNotificationBuilder(MainActivity.this, builder);
Part6:按返回键退出APP后,从通知点击进入APP异常问题
这是我踩的一个坑,当然,这个跟我自己考虑不全更有关系。解决做法也很简单。在点击回调的地方onNotifactionClickedResult
这个函数里面,在获取了信鸽传过来的内容之后,加上去主界面的跳转。
Intent intent =newIntent(context, MainActivity.class);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
intent.putExtra("push_params", entity);
context.startActivity(intent);
在主界面做你想做的详细跳转。NoticeClassIntentEntity类是信鸽传过来的内容的字段类,NoticeReceiver.NoticeClassIntent()是我自己项目里的具体跳转类,是个static类型的。
private void sendMessage() {
Intent it = getIntent();
NoticeClassIntentEntity= (NoticeClassIntentEntity) it.getSerializableExtra("push_params");
if(entity !=null) {
NoticeReceiver.NoticeClassIntent(MainActivity.this, entity.messageType, entity);
}}
还有一点要注意是因为都是在主函数里面做的跳转,当APP存在的时候点击通知栏就必须在onNewIntent()调sendMessage()方法。
Part7:标签设置
最近在开发过程中需要设置标签这个功能,遇到了一个坑。在这里跟大家分享下。信鸽的标签是增量机制,这里不得不夸一下极光,极光是覆盖机制。那么,增量机制到底会出现什么问题呢?就是APP卸载后,你设置的标签无法删除。这就会出现一些很尴尬的情况了,比如说你的APP要设置一个叫做版本号的标签,那么你先安装了一个比方说是3.8.0的APP,然后觉得不好用卸载掉了,去安装了一个3.5.0的,那么你就会有两个标签,一个3.8.0,一个3.5.0。如果此时你去推送3.5.0以上版本的消息,你的手机将会出现两条相同的通知。
而解决方法就是:在客户端不能去找到以前的标签,但是在服务器端是可以的,在登录时调用删除标签的接口,由服务器去操作就好了。
值得一提的是如果没有删掉APP,去升级或者电脑直接运行是不会出现这些问题的。而在退出或者切换帐号的时候,你都可以代码去设置删除的。在此提出希望对遇到的人有些帮助。当然我的方法可能也很片面,希望大家指出。
Part8:信鸽透传消息
利用信鸽去主动踢出用户。在此,为了解决延时等情况造成用户二次踢出(被动踢出后,手机再次登录,主动踢出),加入同一个帐号上次登录获取的接口的token和一个要踢出的标志,相同的token则踢出,不同则不踢。PS:(小米手机不知道什么原因,卸载掉之后,再次信鸽注册会生成一个新的设备token,大部分都是同一个设备token。)。在实际运用中发现透传跟通知比起来速度更快,到达率也很高。
Part9:小细节:
在主界面的AndroidManifest加上启动模式模式:android:launchMode="singleTask"
Part10:最后
如果大家有疑问或者其他处理方法可以给我留言,我会尽快答复,谢谢!