Android 信鸽推送需要注意的细节

    由于信鸽接入文档比较详细，这里我不对如何接入进行阐述，想知道具体如何接入可以参考信鸽帮助手册：

信鸽Android快速接入

    在这里，我就说一些在文档和信鸽提供的demo里不细致或者没有或者以前我没有发现的，但是比较实用的进行描述吧，也是一个工作的存档。

Part1：信鸽注册

    APP只有在完成信鸽的启动与注册后才可以信鸽SDK提供push服务，在这之前请确保配置AccessId和AccessKey。                                               
    新版的SDK已经将启动信鸽和APP注册统一集成在注册接口中，即只需调用注册接口便默认完成启动和注册操作。                                                      
    注册成功后，会返回设备token，token用于标识设备唯一性，同时也是信鸽维持与后台连接的唯一身份标识。                                                                 
    这是信鸽接入文档里的话，一开始我以为只要信鸽注册了一次，就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标记。不添加，就进不去Activity的界面。
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：最后

  如果大家有疑问或者其他处理方法可以给我留言，我会尽快答复，谢谢！