Android接入个推2.10.2.0

之前接入过旧版本的个推sdk,最近新项目转接个推2.10.2.0,觉得新版和旧版本的使用差别还是比较大的。

首先我们需要先下载个推的sdk:http://docs.getui.com/

8F27358A-AC78-4C2C-9183-35EE1EDED910.png

从下载内容找到AndroidStudio快速集成pdf,这个文档已经把集成个推的步骤的都说明了,我们只要跟着照做就是了。但是有几个地方需要注意下:

  1. 配置方式
    我们可以根据自己需要通过gradle配置sdk,也可以通过导入jar包的方式来引入。jar包和so文件的依赖方式有所差别,但都必须要在自己主工程中build.gradle中配置好个推的GT_APP_ID,GT_APP_KEY,GT_APP_SECRET
manifestPlaceholders = [
                GETUI_APP_ID : "GT_APP_ID",
                GETUI_APP_KEY : "GT_APP_KEY",
                GETUI_APP_SECRET : "GT_APP_SECRET"
        ]
  1. 配置自定义推送服务
    文档中这一项举了一个DemoPushService的例子,目前未用到这一块内容。我们自己的项目是可以不需要写这个service的,未写这个service时,在AndroidManifest.xml中也不需要做配置。需要注意的是,不写这个service,我们在初始化时,需要用个推默认的PushService来进行初始化。本文后面会做说明。

  2. 编写继承代码
    3.1 初始化sdk


com.igexin.sdk.PushManager.getInstance().initialize(getApplicationContext(), PushService.class);

在第2点中,我们提到自定推送服务。如果我们做了自定义,那么PushService.class就需要换成我们自定义的service,如上文中的DemoPushService.class,初始化过程也将按照个推文档说明进行:

com.igexin.sdk.PushManager.getInstance().initialize(getApplicationContext(), DemoPushService.class);

3.2 接收推送服务事件
我们通过继承GTIntentService来获取个推生成的clientid和接收到的推送消息
3.2.1 获取clientid

@Override
 public void onReceiveClientId(Context context, String clientid) {
        Log.e(TAG, "onReceiveClientId -> " + "clientid = " + clientid);
    }

获取到clientid之后,需要将其传送给服务器,之后服务器就可通过此clientid将消息推送给客户端了。
3.2.2 接收推送消息

    @Override
    public void onReceiveMessageData(Context context, GTTransmitMessage msg) {
        Log.i(TAG, "onReceiveMessageData: ");
        String appid = msg.getAppid();
        String taskid = msg.getTaskId();
        String messageid = msg.getMessageId();
        byte[] payload = msg.getPayload();
        String pkg = msg.getPkgName();
        String cid = msg.getClientId();

       if(payload != null){
            String content = new String(payload);
        }
}

通过 msg.getPayload()获取到的数据就是推送中透传的数据。注意:只有在有透传数据时,其内容才不为空。
  个推创建推送消息分为:推送通知、透传消息、分组对比测试。分组对比测试还没研究过,暂不讨论。
  推送通知:通过这个方式推送消息,客户端收到消息后即弹出通知栏,这个通知栏是个推sdk中自带的;点击通知栏,即可调起onReceiveMessageData方法,从中获取透传数据;但在此方法中暂未有方法获取通知栏标题和描述内容的方法。
  透传消息:客户端收到消息即调起onReceiveMessageData方法,这个时候个推将不主动弹出通知栏,我们只能自定义一个通知栏,并在通知栏中去完成我们后续的动作。

  1. 推送时的高级设置
E69A6053-499C-4419-8985-9E6C0B9DCB57.png

特意加上这一点是因为,之前没有注意过这里的“强制启动应用”,导致每次在点击通知栏时,都重启了app,找了半天没有找到原因,还亏同事提醒,让我找找是否有这样的配置,才发现原来是可以配置强制启动应用的。这里,我们将其关闭,之后点击通知栏,就不会每次都重启app,而是直接去打开我们想要的界面了。

5.设置通知栏的图片
设置通知栏图片,我们必须严格按照个推的文档,给我的应用添加push.png图标。这里之前碰个问题,笔者第一次集成时未加入push.png图标,有的手机能正常显示出应用图标,而有的手机则显示默认的机器人图标。个推给的建议是本地必须添加通知栏需要显示的图标,且命名为push.png;同时,服务器发送消息时,需要调用setLogo的方法,为通知设置图标。这样就能保证通知栏显示的是我们设置的push.png.

集成第三方的库,一定要认真查看集成步骤,减少不必要的错误。有很多这种api写得不够详细,比较坑;但也有很多写得不错,并能够及时更新文档的平台。希望这样平台多起来,少些坑。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 173,242评论 25 708
  • 许多集成的步骤个推官网都有了,这里只写关于推送的远程推送和本地通知的步骤和代码。APP在后台时:走苹果的APNS通...
    AllureJM阅读 2,767评论 1 9
  • 《ilua》速成开发手册3.0 官方用户交流:iApp开发交流(1) 239547050iApp开发交流(2) 1...
    叶染柒丶阅读 10,972评论 0 11
  • 有的人迎面走来,擦肩而过;有的人驻足停留,寒暄问好;还有的人并肩同行,相伴旅程。 生活就是跟不同的人结缘的过程,缘...
    围裙妈阅读 177评论 0 1
  • 夜半清宵檐外雨,陶君邀我赏南菊。 夏花未落秋风远,何况公秦我客齐。
    四木先生阅读 419评论 0 1