之前接入过旧版本的个推sdk,最近新项目转接个推2.10.2.0,觉得新版和旧版本的使用差别还是比较大的。
首先我们需要先下载个推的sdk:http://docs.getui.com/。
从下载内容找到AndroidStudio快速集成pdf,这个文档已经把集成个推的步骤的都说明了,我们只要跟着照做就是了。但是有几个地方需要注意下:
- 配置方式
我们可以根据自己需要通过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"
]
配置自定义推送服务
文档中这一项举了一个DemoPushService的例子,目前未用到这一块内容。我们自己的项目是可以不需要写这个service的,未写这个service时,在AndroidManifest.xml中也不需要做配置。需要注意的是,不写这个service,我们在初始化时,需要用个推默认的PushService来进行初始化。本文后面会做说明。编写继承代码
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方法,这个时候个推将不主动弹出通知栏,我们只能自定义一个通知栏,并在通知栏中去完成我们后续的动作。
- 推送时的高级设置
特意加上这一点是因为,之前没有注意过这里的“强制启动应用”,导致每次在点击通知栏时,都重启了app,找了半天没有找到原因,还亏同事提醒,让我找找是否有这样的配置,才发现原来是可以配置强制启动应用的。这里,我们将其关闭,之后点击通知栏,就不会每次都重启app,而是直接去打开我们想要的界面了。
5.设置通知栏的图片
设置通知栏图片,我们必须严格按照个推的文档,给我的应用添加push.png图标。这里之前碰个问题,笔者第一次集成时未加入push.png图标,有的手机能正常显示出应用图标,而有的手机则显示默认的机器人图标。个推给的建议是本地必须添加通知栏需要显示的图标,且命名为push.png;同时,服务器发送消息时,需要调用setLogo的方法,为通知设置图标。这样就能保证通知栏显示的是我们设置的push.png.
集成第三方的库,一定要认真查看集成步骤,减少不必要的错误。有很多这种api写得不够详细,比较坑;但也有很多写得不错,并能够及时更新文档的平台。希望这样平台多起来,少些坑。